crewAI/docs/ar/enterprise/integrations/clickup.mdx

---
title: تكامل ClickUp
description: "إدارة المهام والإنتاجية مع تكامل ClickUp لـ CrewAI."
icon: "list-check"
mode: "wide"
---

## نظرة عامة

مكّن وكلاءك من إدارة المهام والمشاريع وسير عمل الإنتاجية عبر ClickUp. أنشئ المهام وحدّثها، ونظّم المشاريع، وأدر تعيينات الفريق، وبسّط إدارة إنتاجيتك باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

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

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

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

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

1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. ابحث عن **ClickUp** في قسم تكاملات المصادقة
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="clickup/search_tasks">
    **الوصف:** البحث عن المهام في ClickUp باستخدام فلاتر متقدمة.

    **المعاملات:**
    - `taskFilterFormula` (object, اختياري): فلتر بصيغة التعبير العادي المنفصل - OR لمجموعات AND من شروط فردية.
      ```json
      {
        "operator": "OR",
        "conditions": [
          {
            "operator": "AND",
            "conditions": [
              {
                "field": "statuses%5B%5D",
                "operator": "$stringExactlyMatches",
                "value": "open"
              }
            ]
          }
        ]
      }
      ```
      الحقول المتاحة: `space_ids%5B%5D`, `project_ids%5B%5D`, `list_ids%5B%5D`, `statuses%5B%5D`, `include_closed`, `assignees%5B%5D`, `tags%5B%5D`, `due_date_gt`, `due_date_lt`, `date_created_gt`, `date_created_lt`, `date_updated_gt`, `date_updated_lt`

  </Accordion>

  <Accordion title="clickup/get_task_in_list">
    **الوصف:** الحصول على المهام في قائمة محددة في ClickUp.

    **المعاملات:**
    - `listId` (string, مطلوب): القائمة - اختر قائمة للحصول على المهام منها. استخدم إعدادات المستخدم في بوابة الاتصال للسماح للمستخدمين باختيار قائمة ClickUp.
    - `taskFilterFormula` (string, اختياري): البحث عن المهام التي تطابق الفلاتر المحددة. مثال: name=task1.

  </Accordion>

  <Accordion title="clickup/create_task">
    **الوصف:** إنشاء مهمة في ClickUp.

    **المعاملات:**
    - `listId` (string, مطلوب): القائمة - اختر قائمة لإنشاء هذه المهمة فيها.
    - `name` (string, مطلوب): الاسم - اسم المهمة.
    - `description` (string, اختياري): الوصف - وصف المهمة.
    - `status` (string, اختياري): الحالة - اختر حالة لهذه المهمة.
    - `assignees` (string, اختياري): المكلّفون - اختر عضواً (أو مصفوفة من معرّفات الأعضاء) ليتم تعيينهم لهذه المهمة.
    - `dueDate` (string, اختياري): تاريخ الاستحقاق - حدد تاريخ استحقاق لهذه المهمة.
    - `additionalFields` (string, اختياري): حقول إضافية - حدد حقولاً إضافية لتضمينها في هذه المهمة بصيغة JSON.

  </Accordion>

  <Accordion title="clickup/update_task">
    **الوصف:** تحديث مهمة في ClickUp.

    **المعاملات:**
    - `taskId` (string, مطلوب): معرّف المهمة - معرّف المهمة المراد تحديثها.
    - `listId` (string, مطلوب): القائمة - اختر قائمة لإنشاء هذه المهمة فيها.
    - `name` (string, اختياري): الاسم - اسم المهمة.
    - `description` (string, اختياري): الوصف - وصف المهمة.
    - `status` (string, اختياري): الحالة - اختر حالة لهذه المهمة.
    - `assignees` (string, اختياري): المكلّفون - اختر عضواً (أو مصفوفة من معرّفات الأعضاء) ليتم تعيينهم لهذه المهمة.
    - `dueDate` (string, اختياري): تاريخ الاستحقاق - حدد تاريخ استحقاق لهذه المهمة.
    - `additionalFields` (string, اختياري): حقول إضافية - حدد حقولاً إضافية لتضمينها في هذه المهمة بصيغة JSON.

  </Accordion>

  <Accordion title="clickup/delete_task">
    **الوصف:** حذف مهمة في ClickUp.

    **المعاملات:**
    - `taskId` (string, مطلوب): معرّف المهمة - معرّف المهمة المراد حذفها.

  </Accordion>

  <Accordion title="clickup/get_list">
    **الوصف:** الحصول على معلومات القائمة في ClickUp.

    **المعاملات:**
    - `spaceId` (string, مطلوب): معرّف المساحة - معرّف المساحة التي تحتوي على القوائم.

  </Accordion>

  <Accordion title="clickup/get_custom_fields_in_list">
    **الوصف:** الحصول على الحقول المخصصة في قائمة في ClickUp.

    **المعاملات:**
    - `listId` (string, مطلوب): معرّف القائمة - معرّف القائمة للحصول على الحقول المخصصة منها.

  </Accordion>

  <Accordion title="clickup/get_all_fields_in_list">
    **الوصف:** الحصول على جميع الحقول في قائمة في ClickUp.

    **المعاملات:**
    - `listId` (string, مطلوب): معرّف القائمة - معرّف القائمة للحصول على جميع الحقول منها.

  </Accordion>

  <Accordion title="clickup/get_space">
    **الوصف:** الحصول على معلومات المساحة في ClickUp.

    **المعاملات:**
    - `spaceId` (string, اختياري): معرّف المساحة - معرّف المساحة المراد استرجاعها.

  </Accordion>

  <Accordion title="clickup/get_folders">
    **الوصف:** الحصول على المجلدات في ClickUp.

    **المعاملات:**
    - `spaceId` (string, مطلوب): معرّف المساحة - معرّف المساحة التي تحتوي على المجلدات.

  </Accordion>

  <Accordion title="clickup/get_member">
    **الوصف:** الحصول على معلومات العضو في ClickUp.

    **المعاملات:** لا توجد معاملات مطلوبة.

  </Accordion>
</AccordionGroup>

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

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

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

# Create an agent with Clickup capabilities
clickup_agent = Agent(
    role="Task Manager",
    goal="Manage tasks and projects in ClickUp efficiently",
    backstory="An AI assistant specialized in task management and productivity coordination.",
    apps=['clickup']  # All Clickup actions will be available
)

# Task to create a new task
create_task = Task(
    description="Create a task called 'Review Q1 Reports' in the Marketing list with high priority",
    agent=clickup_agent,
    expected_output="Task created successfully with task ID"
)

# Run the task
crew = Crew(
    agents=[clickup_agent],
    tasks=[create_task]
)

crew.kickoff()
```

### تصفية أدوات ClickUp محددة

```python

task_coordinator = Agent(
    role="Task Coordinator",
    goal="Create and manage tasks efficiently",
    backstory="An AI assistant that focuses on task creation and status management.",
    apps=['clickup/create_task']
)

# Task to manage task workflow
task_workflow = Task(
    description="Create a task for project planning and assign it to the development team",
    agent=task_coordinator,
    expected_output="Task created and assigned successfully"
)

crew = Crew(
    agents=[task_coordinator],
    tasks=[task_workflow]
)

crew.kickoff()
```

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

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

project_manager = Agent(
    role="Project Manager",
    goal="Coordinate project activities and track team productivity",
    backstory="An experienced project manager who ensures projects are delivered on time.",
    apps=['clickup']
)

# Complex task involving multiple ClickUp operations
project_coordination = Task(
    description="""
    1. Get all open tasks in the current space
    2. Identify overdue tasks and update their status
    3. Create a weekly report task summarizing project progress
    4. Assign the report task to the team lead
    """,
    agent=project_manager,
    expected_output="Project status updated and weekly report task created and assigned"
)

crew = Crew(
    agents=[project_manager],
    tasks=[project_coordination]
)

crew.kickoff()
```

### البحث في المهام وإدارتها

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

task_analyst = Agent(
    role="Task Analyst",
    goal="Analyze task patterns and optimize team productivity",
    backstory="An AI assistant that analyzes task data to improve team efficiency.",
    apps=['clickup']
)

# Task to analyze and optimize task distribution
task_analysis = Task(
    description="""
    Search for all tasks assigned to team members in the last 30 days,
    analyze completion patterns, and create optimization recommendations
    """,
    agent=task_analyst,
    expected_output="Task analysis report with optimization recommendations"
)

crew = Crew(
    agents=[task_analyst],
    tasks=[task_analysis]
)

crew.kickoff()
```

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

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