الانتقال إلى المحتوى الرئيسي

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

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

الميزات

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

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

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

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

البدء

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

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

التثبيت

ثبّت Maxim SDK عبر pip:
pip install maxim-py
أو أضفه إلى ملف requirements.txt:
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
هذا كل شيء! سيتم الآن تسجيل جميع تفاعلات وكلاء CrewAI وستكون متاحة في لوحة معلومات Maxim. تحقق من دفتر Google Colab هذا كمرجع سريع - الدفتر

عرض تتبعاتك

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

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

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

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

الموارد

وثائق CrewAI

وثائق CrewAI الرسمية

وثائق Maxim

وثائق Maxim الرسمية

Maxim Github

Maxim Github