تخطَّ إلى المحتوى
توثيق CrewAI

مستودعات الوكلاء

تتيح مستودعات الوكلاء لمستخدمي المؤسسات تخزين ومشاركة وإعادة استخدام تعريفات الوكلاء عبر الفرق والمشاريع. تُمكّن هذه الميزة المؤسسات من الاحتفاظ بمكتبة مركزية من الوكلاء الموحدين، مما يعزز الاتساق ويقلل من ازدواجية الجهود.

Agent Repositories

فوائد مستودعات الوكلاء

Section titled “فوائد مستودعات الوكلاء”
  • التوحيد: الحفاظ على تعريفات وكلاء متسقة عبر مؤسستك
  • إعادة الاستخدام: إنشاء وكيل مرة واحدة واستخدامه في أطقم ومشاريع متعددة
  • الحوكمة: تطبيق سياسات على مستوى المؤسسة لتهيئات الوكلاء
  • التعاون: تمكين الفرق من المشاركة والبناء على عمل بعضهم البعض

إنشاء واستخدام مستودعات الوكلاء

Section titled “إنشاء واستخدام مستودعات الوكلاء”
  1. يجب أن يكون لديك حساب في CrewAI، جرّب الخطة المجانية.
  2. أنشئ وكلاء بأدوار وأهداف محددة لسير عملك.
  3. هيّئ الأدوات والقدرات لكل مساعد متخصص.
  4. انشر الوكلاء عبر المشاريع من خلال الواجهة المرئية أو تكامل API.

Agent Repositories

تحميل الوكلاء من المستودعات

Section titled “تحميل الوكلاء من المستودعات”

يمكنك تحميل الوكلاء من المستودعات في الكود باستخدام معامل from_repository للتشغيل محليًا:

from crewai import Agent


# إنشاء وكيل بتحميله من مستودع
# يتم تحميل الوكيل بجميع إعداداته المحددة مسبقًا
researcher = Agent(
    from_repository="market-research-agent"
)

تجاوز إعدادات المستودع

Section titled “تجاوز إعدادات المستودع”

يمكنك تجاوز إعدادات محددة من المستودع بتوفيرها في التهيئة:

researcher = Agent(
    from_repository="market-research-agent",
    goal="Research the latest trends in AI development",  # تجاوز هدف المستودع
    verbose=True  # إضافة إعداد غير موجود في المستودع
)

مثال: إنشاء طاقم مع وكلاء المستودع

Section titled “مثال: إنشاء طاقم مع وكلاء المستودع”
from crewai import Crew, Agent, Task


# تحميل الوكلاء من المستودعات
researcher = Agent(
    from_repository="market-research-agent"
)


writer = Agent(
    from_repository="content-writer-agent"
)


# إنشاء المهام
research_task = Task(
    description="Research the latest trends in AI",
    agent=researcher
)


writing_task = Task(
    description="Write a comprehensive report based on the research",
    agent=writer
)


# إنشاء الطاقم
crew = Crew(
    agents=[researcher, writer],
    tasks=[research_task, writing_task],
    verbose=True
)


# تشغيل الطاقم
result = crew.kickoff()

مثال: استخدام kickoff() مع وكلاء المستودع

Section titled “مثال: استخدام kickoff() مع وكلاء المستودع”

يمكنك أيضًا استخدام وكلاء المستودع مباشرة مع طريقة kickoff() للتفاعلات الأبسط:

from crewai import Agent
from pydantic import BaseModel
from typing import List


# تعريف تنسيق مخرجات منظم
class MarketAnalysis(BaseModel):
    key_trends: List[str]
    opportunities: List[str]
    recommendation: str


# تحميل وكيل من المستودع
analyst = Agent(
    from_repository="market-analyst-agent",
    verbose=True
)


# الحصول على استجابة حرة
result = analyst.kickoff("Analyze the AI market in 2025")
print(result.raw)  # الوصول إلى الاستجابة الخام


# الحصول على مخرجات منظمة
structured_result = analyst.kickoff(
    "Provide a structured analysis of the AI market in 2025",
    response_format=MarketAnalysis
)


# الوصول إلى البيانات المنظمة
print(f"Key Trends: {structured_result.pydantic.key_trends}")
print(f"Recommendation: {structured_result.pydantic.recommendation}")

أفضل الممارسات

Section titled “أفضل الممارسات”
  1. اصطلاح التسمية: استخدم أسماء واضحة ووصفية لوكلاء المستودع
  2. التوثيق: أدرج أوصافًا شاملة لكل وكيل
  3. إدارة الأدوات: تأكد من توفر الأدوات المشار إليها بواسطة وكلاء المستودع في بيئتك
  4. التحكم في الوصول: أدر الصلاحيات لضمان أن أعضاء الفريق المصرّح لهم فقط يمكنهم تعديل وكلاء المستودع

إدارة المؤسسة

Section titled “إدارة المؤسسة”

للتبديل بين المؤسسات أو عرض مؤسستك الحالية، استخدم واجهة سطر أوامر CrewAI:

Terminal window
# عرض المؤسسة الحالية
crewai org current


# التبديل إلى مؤسسة مختلفة
crewai org switch <org_id>


# عرض جميع المؤسسات المتاحة
crewai org list