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 بإصدارات المطالبات ومقارنة التشغيلات عبر الإصدارات.

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

​

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

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

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

​

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

• تتبع الوكلاء
• التحليلات + التقييمات
• التنبيهات
• لوحات المعلومات

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

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

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

تقييمات تلقائية على السجلات

تقييم السجلات الملتقطة تلقائياً من واجهة المستخدم بناءً على المرشحات والعينات

تقييمات بشرية على السجلات

استخدام التقييم البشري أو التصنيف لتقييم جودة سجلاتك

تقييمات على مستوى العقد

تقييم أي مكون من تتبعك أو سجلك للحصول على رؤى حول سلوك وكيلك

---

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

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

​

البدء

​

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

• إصدار Python >= 3.10
• حساب Maxim (سجّل هنا)
• توليد مفتاح API من Maxim
• مشروع CrewAI

​

التثبيت

pip install maxim-py

maxim-py

​

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

​

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

### 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. استيراد الحزم المطلوبة

from crewai import Agent, Task, Crew, Process
from maxim import Maxim
from maxim.logger.crewai import instrument_crewai

​

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

# Instrument CrewAI with just one line
instrument_crewai(Maxim().logger())

​

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

# 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

​

عرض تتبعاتك

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

​

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

​

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

• عدم ظهور تتبعات: تأكد من صحة مفتاح API ومعرف المستودع
• تأكد من استدعاء instrument_crewai() قبل تشغيل طاقمك
• عيّن debug=True في استدعاء instrument_crewai() لإظهار أي أخطاء داخلية:
  instrument_crewai(logger, debug=True)
  
• أعدّ وكلاءك مع verbose=True لالتقاط سجلات مفصلة
• تحقق مرة أخرى من أن instrument_crewai() يُستدعى قبل إنشاء أو تنفيذ الوكلاء

​

الموارد