الانتقال إلى المحتوى الرئيسي

نظرة عامة

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

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

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

إعداد تكامل ClickUp

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

  1. انتقل إلى تكاملات CrewAI AMP
  2. ابحث عن ClickUp في قسم تكاملات المصادقة
  3. انقر على Connect وأكمل عملية OAuth
  4. امنح الصلاحيات اللازمة لإدارة المهام والمشاريع
  5. انسخ رمز المؤسسة من إعدادات التكامل

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

uv add crewai-tools

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

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
أو أضفه إلى ملف .env:
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

الوصف: البحث عن المهام في ClickUp باستخدام فلاتر متقدمة.المعاملات:
  • taskFilterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل - OR لمجموعات AND من شروط فردية.
    {
      "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
الوصف: الحصول على المهام في قائمة محددة في ClickUp.المعاملات:
  • listId (string, مطلوب): القائمة - اختر قائمة للحصول على المهام منها. استخدم إعدادات المستخدم في بوابة الاتصال للسماح للمستخدمين باختيار قائمة ClickUp.
  • taskFilterFormula (string, اختياري): البحث عن المهام التي تطابق الفلاتر المحددة. مثال: name=task1.
الوصف: إنشاء مهمة في ClickUp.المعاملات:
  • listId (string, مطلوب): القائمة - اختر قائمة لإنشاء هذه المهمة فيها.
  • name (string, مطلوب): الاسم - اسم المهمة.
  • description (string, اختياري): الوصف - وصف المهمة.
  • status (string, اختياري): الحالة - اختر حالة لهذه المهمة.
  • assignees (string, اختياري): المكلّفون - اختر عضواً (أو مصفوفة من معرّفات الأعضاء) ليتم تعيينهم لهذه المهمة.
  • dueDate (string, اختياري): تاريخ الاستحقاق - حدد تاريخ استحقاق لهذه المهمة.
  • additionalFields (string, اختياري): حقول إضافية - حدد حقولاً إضافية لتضمينها في هذه المهمة بصيغة JSON.
الوصف: تحديث مهمة في ClickUp.المعاملات:
  • taskId (string, مطلوب): معرّف المهمة - معرّف المهمة المراد تحديثها.
  • listId (string, مطلوب): القائمة - اختر قائمة لإنشاء هذه المهمة فيها.
  • name (string, اختياري): الاسم - اسم المهمة.
  • description (string, اختياري): الوصف - وصف المهمة.
  • status (string, اختياري): الحالة - اختر حالة لهذه المهمة.
  • assignees (string, اختياري): المكلّفون - اختر عضواً (أو مصفوفة من معرّفات الأعضاء) ليتم تعيينهم لهذه المهمة.
  • dueDate (string, اختياري): تاريخ الاستحقاق - حدد تاريخ استحقاق لهذه المهمة.
  • additionalFields (string, اختياري): حقول إضافية - حدد حقولاً إضافية لتضمينها في هذه المهمة بصيغة JSON.
الوصف: حذف مهمة في ClickUp.المعاملات:
  • taskId (string, مطلوب): معرّف المهمة - معرّف المهمة المراد حذفها.
الوصف: الحصول على معلومات القائمة في ClickUp.المعاملات:
  • spaceId (string, مطلوب): معرّف المساحة - معرّف المساحة التي تحتوي على القوائم.
الوصف: الحصول على الحقول المخصصة في قائمة في ClickUp.المعاملات:
  • listId (string, مطلوب): معرّف القائمة - معرّف القائمة للحصول على الحقول المخصصة منها.
الوصف: الحصول على جميع الحقول في قائمة في ClickUp.المعاملات:
  • listId (string, مطلوب): معرّف القائمة - معرّف القائمة للحصول على جميع الحقول منها.
الوصف: الحصول على معلومات المساحة في ClickUp.المعاملات:
  • spaceId (string, اختياري): معرّف المساحة - معرّف المساحة المراد استرجاعها.
الوصف: الحصول على المجلدات في ClickUp.المعاملات:
  • spaceId (string, مطلوب): معرّف المساحة - معرّف المساحة التي تحتوي على المجلدات.
الوصف: الحصول على معلومات العضو في ClickUp.المعاملات: لا توجد معاملات مطلوبة.

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

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

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 محددة


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()

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

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()

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

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()

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

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل ClickUp أو استكشاف الأخطاء وإصلاحها.