> ## 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.

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

> اربط التطبيقات الخارجية وأدِر الأدوات الداخلية التي يمكن لوكلائك استخدامها.

## نظرة عامة

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

<Frame>
  <img src="https://mintcdn.com/crewai/5SZbe87tsCWZY09V/images/enterprise/crew_connectors.png?fit=max&auto=format&n=5SZbe87tsCWZY09V&q=85&s=c31a4b9031f0f517fdce3baa48471f58" alt="نظرة عامة على الأدوات والتكاملات" width="1024" height="1024" data-path="images/enterprise/crew_connectors.png" />
</Frame>

## استكشاف

<Tabs>
  <Tab title="التكاملات" icon="plug">
    ## تطبيقات الوكلاء (التكاملات)

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

    {" "}

    <Steps>
      <Step title="الاتصال">
        انقر على <b>Connect</b> في أحد التطبيقات وأكمل عملية OAuth.
      </Step>

      <Step title="التهيئة">
        عدّل اختيارياً النطاقات والمشغلات وتوفر الإجراءات.
      </Step>

      <Step title="الاستخدام في الوكلاء">
        تصبح الخدمات المتصلة متاحة كأدوات لوكلائك.
      </Step>
    </Steps>

    {" "}

    <Frame>
      <img src="https://mintcdn.com/crewai/Grq_Qb7_m8o-TQ5O/images/enterprise/agent-apps.png?fit=max&auto=format&n=Grq_Qb7_m8o-TQ5O&q=85&s=43abfc4eae390e308bed0b8e15238a54" alt="شبكة التكاملات" width="3648" height="2266" data-path="images/enterprise/agent-apps.png" />
    </Frame>

    ### ربط حسابك

    1. انتقل إلى <Link href="https://app.crewai.com/crewai_plus/connectors">Integrations</Link>
    2. انقر على <b>Connect</b> في الخدمة المطلوبة
    3. أكمل تدفق OAuth وامنح النطاقات
    4. انسخ رمز Enterprise من <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Integration Settings</Link>

    {" "}

    <Frame>
      <img src="https://mintcdn.com/crewai/5SZbe87tsCWZY09V/images/enterprise/enterprise_action_auth_token.png?fit=max&auto=format&n=5SZbe87tsCWZY09V&q=85&s=4e7388bcb76f3f8aa6c6802dd0a98956" alt="رمز Enterprise" width="2264" height="540" data-path="images/enterprise/enterprise_action_auth_token.png" />
    </Frame>

    ### تثبيت أدوات التكامل

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

    ```bash theme={null}
    uv add crewai-tools
    ```

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

    {" "}

    <Note>
      لاستخدام التكاملات مع `Agent(apps=[])` يجب تعيين متغير البيئة
      `CREWAI_PLATFORM_INTEGRATION_TOKEN` برمز Enterprise الخاص بك.
    </Note>

    ```bash theme={null}
    export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
    ```

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

    ```
    CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
    ```

    ### مثال على الاستخدام

    {" "}

    <Tip>
      استخدم النهج المبسط الجديد لدمج تطبيقات المؤسسات. ما عليك سوى تحديد
      التطبيق وإجراءاته مباشرة في تهيئة Agent.
    </Tip>

    ```python theme={null}
    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 john@example.com 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()
    ```

    ### تصفية الأدوات

    ```python theme={null}
    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 john@example.com",
        agent=gmail_agent,
        expected_output="Email found from john@example.com"
    )

    crew = Crew(
        agents=[gmail_agent],
        tasks=[notification_task]
    )
    ```

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

    {" "}

    <Frame>
      <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/filtering_enterprise_action_tools.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=2e689397eabeacd23d0c226ff40566fd" alt="تصفية الإجراءات" width="3680" height="2382" data-path="images/enterprise/filtering_enterprise_action_tools.png" />
    </Frame>

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

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

    {" "}

    <Tip>مفيد عندما تحتاج فرق/مستخدمون مختلفون للحفاظ على فصل الوصول إلى البيانات.</Tip>

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

    {" "}

    <Frame>
      <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/user_bearer_token.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=d62aed15392f304cfc16bfa38ab91a54" alt="رمز حامل المستخدم" width="532" height="732" data-path="images/enterprise/user_bearer_token.png" />
    </Frame>

    {" "}

    <div id="catalog" />

    ### الكتالوج

    #### الاتصالات والتعاون

    * Gmail — إدارة الرسائل الإلكترونية والمسودات
    * Slack — إشعارات وتنبيهات مساحة العمل
    * Microsoft — تكامل Office 365 وTeams

    #### إدارة المشاريع

    * Jira — تتبع المشكلات وإدارة المشاريع
    * ClickUp — إدارة المهام والإنتاجية
    * Asana — تنسيق مهام ومشاريع الفريق
    * Notion — إدارة الصفحات وقواعد البيانات
    * Linear — تتبع مشاريع البرمجيات والأخطاء
    * GitHub — إدارة المستودعات والمشكلات

    #### إدارة علاقات العملاء

    * Salesforce — إدارة حسابات وفرص CRM
    * HubSpot — إدارة خط أنابيب المبيعات وجهات الاتصال
    * Zendesk — إدارة تذاكر دعم العملاء

    #### الأعمال والمالية

    * Stripe — معالجة المدفوعات وإدارة العملاء
    * Shopify — إدارة متجر ومنتجات التجارة الإلكترونية

    #### الإنتاجية والتخزين

    * Google Sheets — مزامنة بيانات جداول البيانات
    * Google Calendar — إدارة الأحداث والجداول
    * Box — تخزين الملفات وإدارة المستندات

    ...والمزيد قادم!
  </Tab>

  <Tab title="الأدوات الداخلية" icon="toolbox">
    ## الأدوات الداخلية

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

    {" "}

    <Tip>
      قبل تشغيل الأوامر أدناه، تأكد من تسجيل الدخول إلى حساب CrewAI AMP
      بتشغيل هذا الأمر: `bash crewai login `
    </Tip>

    {" "}

    <Frame>
      <img src="https://mintcdn.com/crewai/VGZ5vPOL3DPMThlg/images/enterprise/tools-integrations-internal.png?fit=max&auto=format&n=VGZ5vPOL3DPMThlg&q=85&s=b31a82341fb4dcd784c2ecfc1c3d576c" alt="تفاصيل الأداة الداخلية" width="3648" height="2266" data-path="images/enterprise/tools-integrations-internal.png" />
    </Frame>

    {" "}

    <Steps>
      <Step title="الإنشاء">
        أنشئ أداة جديدة محلياً. `bash crewai tool create your-tool `
      </Step>

      <Step title="النشر">
        انشر الأداة في مستودع أدوات CrewAI AMP. `bash crewai tool
                    publish `
      </Step>

      <Step title="التثبيت">
        ثبّت الأداة من مستودع أدوات CrewAI AMP. `bash crewai tool
                    install your-tool `
      </Step>
    </Steps>

    الإدارة:

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

    {" "}

    <Frame>
      <img src="https://mintcdn.com/crewai/VGZ5vPOL3DPMThlg/images/enterprise/tool-configs.png?fit=max&auto=format&n=VGZ5vPOL3DPMThlg&q=85&s=1896ebecec784bc15411a0309a0cf973" alt="تفاصيل الأداة الداخلية" width="3648" height="2266" data-path="images/enterprise/tool-configs.png" />
    </Frame>
  </Tab>
</Tabs>

## ذو صلة

<CardGroup cols={2}>
  <Card title="مستودع الأدوات" href="/ar/enterprise/guides/tool-repository#tool-repository" icon="toolbox">
    أنشئ وانشر وأدِر إصدارات الأدوات المخصصة لمؤسستك.
  </Card>

  <Card title="أتمتة Webhook" href="/ar/enterprise/guides/webhook-automation" icon="bolt">
    أتمت سير العمل وتكامل مع المنصات والخدمات الخارجية.
  </Card>
</CardGroup>
