نظرة عامة
مكّن وكلاءك من إدارة المشكلات والمشاريع وسير عمل التطوير عبر Linear. أنشئ المشكلات وحدّثها، وأدر جداول المشاريع الزمنية، ونظّم الفرق، وبسّط عملية تطوير البرمجيات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Linear، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Linear بصلاحيات مساحة العمل المناسبة
- ربط حساب Linear الخاص بك عبر صفحة التكاملات
إعداد تكامل Linear
1. ربط حساب Linear الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Linear في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة لإدارة المشكلات والمشاريع
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
linear/create_issue
linear/create_issue
الوصف: إنشاء مشكلة جديدة في Linear.المعاملات:
teamId(string, مطلوب): معرّف الفريق للمشكلة الجديدة.title(string, مطلوب): العنوان.description(string, اختياري): الوصف.statusId(string, اختياري): الحالة.priority(string, اختياري): الأولوية كعدد صحيح.dueDate(string, اختياري): تاريخ الاستحقاق بصيغة ISO 8601.cycleId(string, اختياري): معرّف الدورة المرتبطة.additionalFields(object, اختياري): حقول إضافية.
linear/update_issue
linear/update_issue
الوصف: تحديث مشكلة في Linear.المعاملات:
issueId(string, مطلوب): معرّف المشكلة المراد تحديثها.title(string, اختياري): العنوان.description(string, اختياري): الوصف.statusId(string, اختياري): الحالة.priority(string, اختياري): الأولوية.dueDate(string, اختياري): تاريخ الاستحقاق.
linear/get_issue_by_id
linear/get_issue_by_id
الوصف: الحصول على مشكلة بواسطة المعرّف في Linear.المعاملات:
issueId(string, مطلوب): معرّف المشكلة المراد جلبها.
linear/search_issue
linear/search_issue
الوصف: البحث عن المشكلات في Linear.المعاملات:
queryTerm(string, مطلوب): مصطلح البحث.issueFilterFormula(object, اختياري): فلتر بصيغة التعبير العادي المنفصل.
linear/delete_issue
linear/delete_issue
الوصف: حذف مشكلة في Linear.المعاملات:
issueId(string, مطلوب): معرّف المشكلة المراد حذفها.
linear/archive_issue
linear/archive_issue
الوصف: أرشفة مشكلة في Linear.المعاملات:
issueId(string, مطلوب): معرّف المشكلة المراد أرشفتها.
linear/create_sub_issue
linear/create_sub_issue
الوصف: إنشاء مشكلة فرعية في Linear.المعاملات:
parentId(string, مطلوب): معرّف المشكلة الأصلية.teamId(string, مطلوب): معرّف الفريق.title(string, مطلوب): العنوان.description(string, اختياري): الوصف.
linear/create_project
linear/create_project
الوصف: إنشاء مشروع جديد في Linear.المعاملات:
teamIds(object, مطلوب): معرّف (معرّفات) الفريق المرتبطة بالمشروع.projectName(string, مطلوب): اسم المشروع.description(string, اختياري): وصف المشروع.
linear/update_project
linear/update_project
الوصف: تحديث مشروع في Linear.المعاملات:
projectId(string, مطلوب): معرّف المشروع المراد تحديثه.projectName(string, اختياري): اسم المشروع.description(string, اختياري): وصف المشروع.
linear/get_project_by_id
linear/get_project_by_id
الوصف: الحصول على مشروع بواسطة المعرّف في Linear.المعاملات:
projectId(string, مطلوب): معرّف المشروع المراد جلبه.
linear/delete_project
linear/delete_project
الوصف: حذف مشروع في Linear.المعاملات:
projectId(string, مطلوب): معرّف المشروع المراد حذفه.
linear/search_teams
linear/search_teams
الوصف: البحث عن الفرق في Linear.المعاملات:
teamFilterFormula(object, اختياري): فلتر بصيغة التعبير العادي المنفصل.
أمثلة الاستخدام
إعداد Agent أساسي لـ Linear
إدارة المشاريع والفرق
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة
أخطاء الصلاحيات- تأكد من أن حساب Linear الخاص بك لديه الصلاحيات اللازمة لمساحة العمل المستهدفة
- تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة لـ Linear API
- تحقق جيداً من معرّفات الفرق والمشكلات والمشاريع للتأكد من صحة صيغة UUID
- تأكد من وجود الكيانات المشار إليها وإمكانية الوصول إليها
- استخدم صيغة ISO 8601 لتواريخ الاستحقاق والطوابع الزمنية
- تأكد من معالجة المناطق الزمنية بشكل صحيح
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Linear أو
استكشاف الأخطاء وإصلاحها.
