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

نظرة عامة

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

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

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

إعداد تكامل ClickUp

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

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

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

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

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

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

الوصف: البحث عن المهام في ClickUp باستخدام فلاتر متقدمة.المعاملات:
  • taskFilterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل - OR لمجموعات AND من شروط فردية.
    الحقول المتاحة: 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

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

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

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

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

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

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