تخطَّ إلى المحتوى

الأدوات والتكاملات

الأدوات والتكاملات هي المركز الرئيسي لربط تطبيقات الجهات الخارجية وإدارة الأدوات الداخلية التي يمكن لوكلائك استخدامها أثناء التشغيل.

نظرة عامة على الأدوات والتكاملات

التكاملات

تطبيقات الوكلاء (التكاملات)

Section titled “تطبيقات الوكلاء (التكاملات)”

اربط تطبيقات المؤسسات (مثل Gmail وGoogle Drive وHubSpot وSlack) عبر OAuth لتمكين إجراءات الوكلاء.

  1. الاتصال

    انقر على Connect في أحد التطبيقات وأكمل عملية OAuth.

  2. التهيئة

    عدّل اختيارياً النطاقات والمشغلات وتوفر الإجراءات.

  3. الاستخدام في الوكلاء

    تصبح الخدمات المتصلة متاحة كأدوات لوكلائك.

شبكة التكاملات
  1. انتقل إلى Integrations
  2. انقر على Connect في الخدمة المطلوبة
  3. أكمل تدفق OAuth وامنح النطاقات
  4. انسخ رمز Enterprise من Integration Settings

رمز Enterprise

لاستخدام التكاملات محلياً، تحتاج إلى تثبيت أحدث حزمة crewai-tools.

Terminal window
uv add crewai-tools
Terminal window
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

أو أضفه إلى ملف .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
from crewai import Agent, Task, Crew
# Create an agent with Gmail capabilities
email_agent = Agent(
role="Email Manager",
goal="Manage and organize email communications",
backstory="An AI assistant specialized in email management and communication.",
apps=['gmail', 'gmail/send_email'] # Using canonical name 'gmail'
)
# Task to send an email
email_task = Task(
description="Draft and send a follow-up email to [email protected] about the project update",
agent=email_agent,
expected_output="Confirmation that email was sent successfully"
)
# Run the task
crew = Crew(
agents=[email_agent],
tasks=[email_task]
)
# Run the crew
crew.kickoff()
from crewai import Agent, Task, Crew
# Create agent with specific Gmail actions only
gmail_agent = Agent(
role="Gmail Manager",
goal="Manage gmail communications and notifications",
backstory="An AI assistant that helps coordinate gmail communications.",
apps=['gmail/fetch_emails'] # Using canonical name with specific action
)
notification_task = Task(
description="Find the email from [email protected]",
agent=gmail_agent,
expected_output="Email found from [email protected]"
)
crew = Crew(
agents=[gmail_agent],
tasks=[notification_task]
)

في الطاقم المنشور، يمكنك تحديد الإجراءات المتاحة لكل تكامل من صفحة إعدادات الخدمة.

تصفية الإجراءات

عمليات النشر المحددة النطاق (مؤسسات متعددة المستخدمين)

Section titled “عمليات النشر المحددة النطاق (مؤسسات متعددة المستخدمين)”

يمكنك تحديد نطاق كل تكامل لمستخدم معين. على سبيل المثال، طاقم يتصل بـ Google يمكنه استخدام حساب Gmail لمستخدم محدد.

استخدم user_bearer_token لتحديد نطاق المصادقة للمستخدم الطالب. إذا لم يكن المستخدم مسجل الدخول، فلن يستخدم الطاقم التكاملات المتصلة. وإلا فسيعود إلى رمز الحامل الافتراضي المهيأ لعملية النشر.

رمز حامل المستخدم
  • Gmail — إدارة الرسائل الإلكترونية والمسودات
  • Slack — إشعارات وتنبيهات مساحة العمل
  • Microsoft — تكامل Office 365 وTeams
  • Jira — تتبع المشكلات وإدارة المشاريع
  • ClickUp — إدارة المهام والإنتاجية
  • Asana — تنسيق مهام ومشاريع الفريق
  • Notion — إدارة الصفحات وقواعد البيانات
  • Linear — تتبع مشاريع البرمجيات والأخطاء
  • GitHub — إدارة المستودعات والمشكلات
  • Salesforce — إدارة حسابات وفرص CRM
  • HubSpot — إدارة خط أنابيب المبيعات وجهات الاتصال
  • Zendesk — إدارة تذاكر دعم العملاء
  • Stripe — معالجة المدفوعات وإدارة العملاء
  • Shopify — إدارة متجر ومنتجات التجارة الإلكترونية
  • Google Sheets — مزامنة بيانات جداول البيانات
  • Google Calendar — إدارة الأحداث والجداول
  • Box — تخزين الملفات وإدارة المستندات

…والمزيد قادم!

الأدوات الداخلية

أنشئ أدوات مخصصة محلياً، وانشرها في مستودع أدوات CrewAI AMP واستخدمها في وكلائك.

تفاصيل الأداة الداخلية

  1. الإنشاء

    أنشئ أداة جديدة محلياً. bash crewai tool create your-tool

  2. النشر

    انشر الأداة في مستودع أدوات CrewAI AMP. bash crewai tool publish

  3. التثبيت

    ثبّت الأداة من مستودع أدوات CrewAI AMP. bash crewai tool install your-tool

الإدارة:

  • الاسم والوصف
  • الرؤية (خاص / عام)
  • متغيرات البيئة المطلوبة
  • سجل الإصدارات والتنزيلات
  • وصول الفرق والأدوار
تفاصيل الأداة الداخلية