نظرة عامة
مكّن وكلاءك من إدارة المهام والمشاريع وتنسيق الفريق عبر Asana. أنشئ المهام وحدّث حالة المشروع وأدر التعيينات وبسّط سير عمل فريقك مع الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Asana، تأكد من أن لديك:- حساب CrewAI AMP مع اشتراك نشط
- حساب Asana مع الأذونات المناسبة
- ربط حساب Asana الخاص بك عبر صفحة التكاملات
إعداد تكامل Asana
1. ربط حساب Asana الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Asana في قسم تكاملات المصادقة
- انقر على ربط وأكمل تدفق OAuth
- امنح الأذونات اللازمة لإدارة المهام والمشاريع
- انسخ رمز Enterprise الخاص بك من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز Enterprise الخاص بك..env:
الإجراءات المتاحة
asana/create_comment
asana/create_comment
الوصف: إنشاء تعليق في Asana.المعاملات:
task(string, مطلوب): معرف المهمة - معرف المهمة التي سيُضاف إليها التعليق. سيُنسب التعليق للمستخدم المصادق عليه حاليًا.text(string, مطلوب): النص (مثال: “This is a comment.”).
asana/create_project
asana/create_project
الوصف: إنشاء مشروع في Asana.المعاملات:
name(string, مطلوب): الاسم (مثال: “Stuff to buy”).workspace(string, مطلوب): مساحة العمل - استخدم إعدادات سير عمل بوابة الاتصال للسماح للمستخدمين باختيار مساحة العمل لإنشاء المشاريع فيها. الافتراضي هو أول مساحة عمل للمستخدم إذا تُرك فارغًا.team(string, اختياري): الفريق - استخدم إعدادات سير عمل بوابة الاتصال للسماح للمستخدمين باختيار الفريق لمشاركة هذا المشروع معه. الافتراضي هو أول فريق للمستخدم إذا تُرك فارغًا.notes(string, اختياري): ملاحظات (مثال: “These are things we need to purchase.”).
asana/get_projects
asana/get_projects
الوصف: الحصول على قائمة المشاريع في Asana.المعاملات:
archived(string, اختياري): مؤرشف - اختر “true” لعرض المشاريع المؤرشفة، “false” لعرض المشاريع النشطة فقط، أو “default” لعرض كليهما.- الخيارات:
default,true,false
- الخيارات:
asana/get_project_by_id
asana/get_project_by_id
الوصف: الحصول على مشروع بواسطة المعرف في Asana.المعاملات:
projectFilterId(string, مطلوب): معرف المشروع.
asana/create_task
asana/create_task
الوصف: إنشاء مهمة في Asana.المعاملات:
name(string, مطلوب): الاسم (مثال: “Task Name”).workspace(string, اختياري): مساحة العمل - استخدم إعدادات سير عمل بوابة الاتصال للسماح للمستخدمين باختيار مساحة العمل لإنشاء المهام فيها. الافتراضي هو أول مساحة عمل للمستخدم إذا تُرك فارغًا.project(string, اختياري): المشروع - استخدم إعدادات سير عمل بوابة الاتصال للسماح للمستخدمين باختيار المشروع لإنشاء هذه المهمة فيه.notes(string, اختياري): ملاحظات.dueOnDate(string, اختياري): تاريخ الاستحقاق - التاريخ الذي تستحق فيه هذه المهمة. لا يمكن استخدامه مع Due At. (مثال: “YYYY-MM-DD”).dueAtDate(string, اختياري): الاستحقاق في - التاريخ والوقت (طابع زمني ISO) الذي تستحق فيه هذه المهمة. لا يمكن استخدامه مع Due On. (مثال: “2019-09-15T02:06:58.147Z”).assignee(string, اختياري): المُكلف - معرف مستخدم Asana الذي سيتم تعيين هذه المهمة له. استخدم إعدادات سير عمل بوابة الاتصال للسماح للمستخدمين باختيار المُكلف.gid(string, اختياري): معرف خارجي - معرف من تطبيقك لربط هذه المهمة به. يمكنك استخدام هذا المعرف لمزامنة التحديثات لهذه المهمة لاحقًا.
asana/update_task
asana/update_task
الوصف: تحديث مهمة في Asana.المعاملات:
taskId(string, مطلوب): معرف المهمة - معرف المهمة التي سيتم تحديثها.completeStatus(string, اختياري): حالة الإكمال.- الخيارات:
true,false
- الخيارات:
name(string, اختياري): الاسم (مثال: “Task Name”).notes(string, اختياري): ملاحظات.dueOnDate(string, اختياري): تاريخ الاستحقاق - التاريخ الذي تستحق فيه هذه المهمة. لا يمكن استخدامه مع Due At. (مثال: “YYYY-MM-DD”).dueAtDate(string, اختياري): الاستحقاق في - التاريخ والوقت (طابع زمني ISO) الذي تستحق فيه هذه المهمة. لا يمكن استخدامه مع Due On. (مثال: “2019-09-15T02:06:58.147Z”).assignee(string, اختياري): المُكلف - معرف مستخدم Asana الذي سيتم تعيين هذه المهمة له.gid(string, اختياري): معرف خارجي - معرف من تطبيقك لربط هذه المهمة به.
asana/get_tasks
asana/get_tasks
الوصف: الحصول على قائمة المهام في Asana.المعاملات:
workspace(string, اختياري): مساحة العمل - معرف مساحة العمل لتصفية المهام عليها.project(string, اختياري): المشروع - معرف المشروع لتصفية المهام عليه.assignee(string, اختياري): المُكلف - معرف المُكلف لتصفية المهام عليه.completedSince(string, اختياري): مكتملة منذ - إرجاع المهام غير المكتملة فقط أو التي اكتملت منذ هذا الوقت (طابع زمني ISO أو Unix). (مثال: “2014-04-25T16:15:47-04:00”).
asana/get_tasks_by_id
asana/get_tasks_by_id
الوصف: الحصول على قائمة المهام بواسطة المعرف في Asana.المعاملات:
taskId(string, مطلوب): معرف المهمة.
asana/get_task_by_external_id
asana/get_task_by_external_id
الوصف: الحصول على مهمة بواسطة المعرف الخارجي في Asana.المعاملات:
gid(string, مطلوب): المعرف الخارجي - المعرف الذي ترتبط أو تتزامن به هذه المهمة، من تطبيقك.
asana/add_task_to_section
asana/add_task_to_section
الوصف: إضافة مهمة إلى قسم في Asana.المعاملات:
sectionId(string, مطلوب): معرف القسم - معرف القسم لإضافة هذه المهمة إليه.taskId(string, مطلوب): معرف المهمة - معرف المهمة. (مثال: “1204619611402340”).beforeTaskId(string, اختياري): معرف المهمة السابقة - معرف مهمة في هذا القسم سيتم إدراج هذه المهمة قبلها. لا يمكن استخدامه مع After Task ID. (مثال: “1204619611402340”).afterTaskId(string, اختياري): معرف المهمة التالية - معرف مهمة في هذا القسم سيتم إدراج هذه المهمة بعدها. لا يمكن استخدامه مع Before Task ID. (مثال: “1204619611402340”).
asana/get_teams
asana/get_teams
الوصف: الحصول على قائمة الفرق في Asana.المعاملات:
workspace(string, مطلوب): مساحة العمل - إرجاع الفرق في مساحة العمل هذه المرئية للمستخدم المصرح له.
asana/get_workspaces
asana/get_workspaces
الوصف: الحصول على قائمة مساحات العمل في Asana.المعاملات: لا توجد معاملات مطلوبة.
