---
title: تكامل Notion
description: "إدارة المستخدمين والتعليقات مع تكامل Notion لـ CrewAI."
icon: "book"
mode: "wide"
---

## نظرة عامة

مكّن وكلاءك من إدارة المستخدمين وإنشاء التعليقات عبر Notion. يمكنك الوصول إلى معلومات مستخدمي مساحة العمل وإنشاء تعليقات على الصفحات والمناقشات، مما يبسّط سير عمل التعاون باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

قبل استخدام تكامل Notion، تأكد من توفر ما يلي:

- حساب [CrewAI AMP](https://app.crewai.com) مع اشتراك فعّال
- حساب Notion بصلاحيات مساحة العمل المناسبة
- ربط حساب Notion الخاص بك عبر [صفحة التكاملات](https://app.crewai.com/crewai_plus/connectors)

## إعداد تكامل Notion

### 1. ربط حساب Notion الخاص بك

1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. ابحث عن **Notion** في قسم تكاملات المصادقة
3. انقر على **Connect** وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للوصول إلى المستخدمين وإنشاء التعليقات
5. انسخ رمز المؤسسة من [إعدادات التكامل](https://app.crewai.com/crewai_plus/settings/integrations)

### 2. تثبيت الحزمة المطلوبة

```bash
uv add crewai-tools
```

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

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

```bash
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
```

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

```
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```

## الإجراءات المتاحة

<AccordionGroup>
  <Accordion title="notion/list_users">
    **الوصف:** عرض جميع المستخدمين في مساحة العمل.

    **المعاملات:**
    - `page_size` (integer, اختياري): عدد العناصر في الاستجابة. الحد الأدنى: 1، الحد الأقصى: 100، الافتراضي: 100
    - `start_cursor` (string, اختياري): مؤشر للترقيم.

  </Accordion>

  <Accordion title="notion/get_user">
    **الوصف:** استرجاع مستخدم محدد بواسطة المعرّف.

    **المعاملات:**
    - `user_id` (string, مطلوب): معرّف المستخدم المراد استرجاعه.

  </Accordion>

  <Accordion title="notion/create_comment">
    **الوصف:** إنشاء تعليق على صفحة أو مناقشة.

    **المعاملات:**
    - `parent` (object, مطلوب): الصفحة الأصلية أو المناقشة للتعليق عليها.
      ```json
      {
        "type": "page_id",
        "page_id": "PAGE_ID_HERE"
      }
      ```
    - `rich_text` (array, مطلوب): المحتوى النصي الغني للتعليق.
      ```json
      [
        {
          "type": "text",
          "text": {
            "content": "This is my comment text"
          }
        }
      ]
      ```

  </Accordion>
</AccordionGroup>

## أمثلة الاستخدام

### إعداد Agent أساسي لـ Notion

```python
from crewai import Agent, Task, Crew

# Create an agent with Notion capabilities
notion_agent = Agent(
    role="Workspace Manager",
    goal="Manage workspace users and facilitate collaboration through comments",
    backstory="An AI assistant specialized in user management and team collaboration.",
    apps=['notion']  # All Notion actions will be available
)

# Task to list workspace users
user_management_task = Task(
    description="List all users in the workspace and provide a summary of team members",
    agent=notion_agent,
    expected_output="Complete list of workspace users with their details"
)

# Run the task
crew = Crew(
    agents=[notion_agent],
    tasks=[user_management_task]
)

crew.kickoff()
```

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

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

**أخطاء الصلاحيات**

- تأكد من أن حساب Notion الخاص بك لديه الصلاحيات المناسبة لقراءة معلومات المستخدمين
- تحقق من أن لديك صلاحيات التعليق على الصفحات أو المناقشات المستهدفة

**مشاكل إنشاء التعليقات**

- تحقق من صحة معرّفات الصفحات أو المناقشات وإمكانية الوصول إليها
- تأكد من اتباع محتوى النص الغني لمواصفات صيغة Notion API

### الحصول على المساعدة

<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
  تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Notion أو
  استكشاف الأخطاء وإصلاحها.
</Card>
