> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تكامل Maxim

> بدء مراقبة وتقييم ومراقبة الوكلاء

# نظرة عامة على Maxim

يوفر Maxim AI مراقبة شاملة للوكلاء وتقييماً ومراقبة لتطبيقات CrewAI. مع تكامل Maxim بسطر واحد، يمكنك بسهولة تتبع وتحليل تفاعلات الوكلاء ومقاييس الأداء والمزيد.

## الميزات

### إدارة المطالبات

تمكّنك قدرات إدارة المطالبات في Maxim من إنشاء وتنظيم وتحسين المطالبات لوكلاء CrewAI. بدلاً من ترميز التعليمات مباشرة، استفد من SDK الخاص بـ Maxim لاسترداد وتطبيق مطالبات مُدارة بالإصدارات ديناميكياً.

**ساحة المطالبات**

أنشئ وصقل وجرّب وانشر مطالباتك عبر الساحة. نظّم مطالباتك باستخدام المجلدات والإصدارات، وجرّب مع حالات العالم الحقيقي عن طريق ربط الأدوات والسياق، وانشر بناءً على منطق مخصص.

![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/maxim_playground.png)

**إصدارات المطالبات**

مع بناء الفرق لتطبيقات الذكاء الاصطناعي، يُعد جزء كبير من التجريب هو التكرار على هيكل المطالبات. للتعاون بفعالية وتنظيم التغييرات بوضوح، يسمح Maxim بإصدارات المطالبات ومقارنة التشغيلات عبر الإصدارات.

![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/maxim_versions.png)

**مقارنة المطالبات**

التكرار على المطالبات أثناء تطوير تطبيق الذكاء الاصطناعي يحتاج تجارب عبر النماذج وهياكل المطالبات وغيرها. لمقارنة الإصدارات واتخاذ قرارات مستنيرة، تسمح ساحة المقارنة بعرض جنب إلى جنب للنتائج.

## **لماذا تستخدم مقارنة المطالبات؟**

تجمع مقارنة المطالبات عدة مطالبات فردية في عرض واحد، مما يمكّن من نهج مبسط لسير عمل متنوع:

1. **مقارنة النماذج**: تقييم أداء نماذج مختلفة على نفس المطالبة.
2. **تحسين المطالبات**: مقارنة إصدارات مختلفة لتحديد الصياغة الأكثر فعالية.
3. **اتساق عبر النماذج**: ضمان مخرجات متسقة عبر نماذج مختلفة لنفس المطالبة.
4. **قياس الأداء**: تحليل مقاييس مثل زمن الاستجابة والتكلفة وعدد الرموز عبر نماذج ومطالبات مختلفة.

### المراقبة والتقييمات

يوفر Maxim AI مراقبة وتقييماً شاملاً لوكلاء CrewAI، مما يساعدك في فهم ما يحدث بالضبط أثناء كل تنفيذ.

**تتبع الوكلاء**

تتبع دورة حياة وكيلك الكاملة، بما في ذلك استدعاءات الأدوات ومسارات الوكلاء وتدفقات القرار بسهولة.

![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/maxim_agent_tracking.png)

**التحليلات + التقييمات**

شغّل تقييمات مفصلة على التتبعات الكاملة أو العقد الفردية مع دعم لـ:

* التفاعلات متعددة الخطوات وتحليل التتبع الدقيق
* تقييمات على مستوى الجلسة
* محاكاة لاختبار العالم الحقيقي

![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/maxim_trace_eval.png)

> **[تقييمات تلقائية على السجلات](https://www.getmaxim.ai/docs/observe/how-to/evaluate-logs/auto-evaluation)**
>
> تقييم السجلات الملتقطة تلقائياً من واجهة المستخدم بناءً على المرشحات والعينات

> **[تقييمات بشرية على السجلات](https://www.getmaxim.ai/docs/observe/how-to/evaluate-logs/human-evaluation)**
>
> استخدام التقييم البشري أو التصنيف لتقييم جودة سجلاتك

> **[تقييمات على مستوى العقد](https://www.getmaxim.ai/docs/observe/how-to/evaluate-logs/node-level-evaluation)**
>
> تقييم أي مكون من تتبعك أو سجلك للحصول على رؤى حول سلوك وكيلك

***

**التنبيهات**

عيّن حدوداً على **الأخطاء والتكلفة واستخدام الرموز وتغذية المستخدم الراجعة وزمن الاستجابة** واحصل على تنبيهات فورية عبر Slack أو PagerDuty.

![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/maxim_alerts_1.png)

**لوحات المعلومات**

تصور التتبعات عبر الزمن ومقاييس الاستخدام وزمن الاستجابة ومعدلات الأخطاء بسهولة.

![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/maxim_dashboard_1.png)

## البدء

### المتطلبات الأساسية

* إصدار Python >= 3.10
* حساب Maxim ([سجّل هنا](https://getmaxim.ai/))
* توليد مفتاح API من Maxim
* مشروع CrewAI

### التثبيت

ثبّت Maxim SDK عبر pip:

```python theme={null}
pip install maxim-py
```

أو أضفه إلى ملف `requirements.txt`:

```
maxim-py
```

### الإعداد الأساسي

### 1. إعداد متغيرات البيئة

```python theme={null}
### Environment Variables Setup

# Create a `.env` file in your project root:

# Maxim API Configuration
MAXIM_API_KEY=your_api_key_here
MAXIM_LOG_REPO_ID=your_repo_id_here
```

### 2. استيراد الحزم المطلوبة

```python theme={null}
from crewai import Agent, Task, Crew, Process
from maxim import Maxim
from maxim.logger.crewai import instrument_crewai
```

### 3. تهيئة Maxim بمفتاح API

```python {8} theme={null}
# Instrument CrewAI with just one line
instrument_crewai(Maxim().logger())
```

### 4. إنشاء وتشغيل تطبيق CrewAI كالمعتاد

```python theme={null}
# Create your agent
researcher = Agent(
    role='Senior Research Analyst',
    goal='Uncover cutting-edge developments in AI',
    backstory="You are an expert researcher at a tech think tank...",
    verbose=True,
    llm=llm
)

# Define the task
research_task = Task(
    description="Research the latest AI advancements...",
    expected_output="",
    agent=researcher
)

# Configure and run the crew
crew = Crew(
    agents=[researcher],
    tasks=[research_task],
    verbose=True
)

try:
    result = crew.kickoff()
finally:
    maxim.cleanup()  # Ensure cleanup happens even if errors occur
```

هذا كل شيء! سيتم الآن تسجيل جميع تفاعلات وكلاء CrewAI وستكون متاحة في لوحة معلومات Maxim.

تحقق من دفتر Google Colab هذا كمرجع سريع - [الدفتر](https://colab.research.google.com/drive/1ZKIZWsmgQQ46n8TH9zLsT1negKkJA6K8?usp=sharing)

## عرض تتبعاتك

بعد تشغيل تطبيق CrewAI:

1. سجل الدخول إلى [لوحة معلومات Maxim](https://app.getmaxim.ai/login)
2. انتقل إلى مستودعك
3. اعرض تتبعات الوكلاء المفصلة، بما في ذلك:

   * محادثات الوكلاء
   * أنماط استخدام الأدوات
   * مقاييس الأداء
   * تحليلات التكاليف

   ![](https://raw.githubusercontent.com/akmadan/crewAI/docs_maxim_observability/docs/images/crewai_traces.gif)

## استكشاف الأخطاء وإصلاحها

### المشاكل الشائعة

* **عدم ظهور تتبعات**: تأكد من صحة مفتاح API ومعرف المستودع
* تأكد من استدعاء **`instrument_crewai()`** ***قبل*** تشغيل طاقمك
* عيّن `debug=True` في استدعاء `instrument_crewai()` لإظهار أي أخطاء داخلية:

  ```python theme={null}
  instrument_crewai(logger, debug=True)
  ```
* أعدّ وكلاءك مع `verbose=True` لالتقاط سجلات مفصلة
* تحقق مرة أخرى من أن `instrument_crewai()` يُستدعى **قبل** إنشاء أو تنفيذ الوكلاء

## الموارد

> **[وثائق CrewAI](https://docs.crewai.com/index.md)**
>
> وثائق CrewAI الرسمية

> **[وثائق Maxim](https://getmaxim.ai/docs)**
>
> وثائق Maxim الرسمية

> **[Maxim Github](https://github.com/maximhq)**
>
> Maxim Github


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.