نظرة عامة
مكّن وكلاءك من إدارة المستودعات والمشكلات والإصدارات عبر GitHub. أنشئ المشكلات وحدّثها، وأدر الإصدارات، وتتبع تطور المشاريع، وبسّط سير عمل تطوير البرمجيات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل GitHub، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب GitHub بصلاحيات المستودع المناسبة
- ربط حساب GitHub الخاص بك عبر صفحة التكاملات
إعداد تكامل GitHub
1. ربط حساب GitHub الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن GitHub في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة لإدارة المستودعات والمشكلات
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
github/create_issue
github/create_issue
الوصف: إنشاء مشكلة في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذه المشكلة. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذه المشكلة.title(string, مطلوب): عنوان المشكلة - حدد عنوان المشكلة المراد إنشاؤها.body(string, اختياري): محتوى المشكلة - حدد محتوى نص المشكلة المراد إنشاؤها.assignees(string, اختياري): المكلّفون - حدد اسم (أسماء) تسجيل الدخول في GitHub للمكلّفين كمصفوفة من السلاسل النصية لهذه المشكلة. (مثال:["octocat"]).
github/update_issue
github/update_issue
الوصف: تحديث مشكلة في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذه المشكلة. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذه المشكلة.issue_number(string, مطلوب): رقم المشكلة - حدد رقم المشكلة المراد تحديثها.title(string, مطلوب): عنوان المشكلة - حدد عنوان المشكلة المراد تحديثها.body(string, اختياري): محتوى المشكلة - حدد محتوى نص المشكلة المراد تحديثها.assignees(string, اختياري): المكلّفون - حدد اسم (أسماء) تسجيل الدخول في GitHub للمكلّفين كمصفوفة من السلاسل النصية لهذه المشكلة. (مثال:["octocat"]).state(string, اختياري): الحالة - حدد الحالة المحدّثة للمشكلة.- الخيارات:
open,closed
- الخيارات:
github/get_issue_by_number
github/get_issue_by_number
الوصف: الحصول على مشكلة بواسطة الرقم في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذه المشكلة. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذه المشكلة.issue_number(string, مطلوب): رقم المشكلة - حدد رقم المشكلة المراد جلبها.
github/lock_issue
github/lock_issue
الوصف: قفل مشكلة في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذه المشكلة. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذه المشكلة.issue_number(string, مطلوب): رقم المشكلة - حدد رقم المشكلة المراد قفلها.lock_reason(string, مطلوب): سبب القفل - حدد سبب قفل محادثة المشكلة أو طلب السحب.- الخيارات:
off-topic,too heated,resolved,spam
- الخيارات:
github/search_issue
github/search_issue
الوصف: البحث عن المشكلات في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذه المشكلة. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذه المشكلة.filter(object, مطلوب): فلتر بصيغة التعبير العادي المنفصل - OR لمجموعات AND من شروط فردية.الحقول المتاحة:assignee,creator,mentioned,labels
github/create_release
github/create_release
الوصف: إنشاء إصدار في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذا الإصدار. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذا الإصدار.tag_name(string, مطلوب): الاسم - حدد اسم وسم الإصدار المراد إنشاؤه. (مثال: “v1.0.0”).target_commitish(string, اختياري): الهدف - حدد هدف الإصدار. يمكن أن يكون اسم فرع أو SHA لعملية إيداع. الافتراضي هو الفرع الرئيسي. (مثال: “master”).body(string, اختياري): المحتوى - حدد وصفاً لهذا الإصدار.draft(string, اختياري): مسودة - حدد ما إذا كان الإصدار المُنشأ يجب أن يكون مسودة (غير منشور).- الخيارات:
true,false
- الخيارات:
prerelease(string, اختياري): إصدار تجريبي - حدد ما إذا كان الإصدار المُنشأ يجب أن يكون إصداراً تجريبياً.- الخيارات:
true,false
- الخيارات:
discussion_category_name(string, اختياري): اسم فئة المناقشة - إذا حُدد، يتم إنشاء مناقشة من الفئة المحددة وربطها بالإصدار.generate_release_notes(string, اختياري): ملاحظات الإصدار - حدد ما إذا كان يجب إنشاء ملاحظات الإصدار تلقائياً.- الخيارات:
true,false
- الخيارات:
github/update_release
github/update_release
الوصف: تحديث إصدار في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذا الإصدار. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذا الإصدار.id(string, مطلوب): معرّف الإصدار - حدد معرّف الإصدار المراد تحديثه.tag_name(string, اختياري): الاسم - حدد اسم وسم الإصدار المراد تحديثه. (مثال: “v1.0.0”).target_commitish(string, اختياري): الهدف - حدد هدف الإصدار. يمكن أن يكون اسم فرع أو SHA لعملية إيداع. الافتراضي هو الفرع الرئيسي. (مثال: “master”).body(string, اختياري): المحتوى - حدد وصفاً لهذا الإصدار.draft(string, اختياري): مسودة - حدد ما إذا كان الإصدار يجب أن يكون مسودة (غير منشور).- الخيارات:
true,false
- الخيارات:
prerelease(string, اختياري): إصدار تجريبي - حدد ما إذا كان الإصدار يجب أن يكون إصداراً تجريبياً.- الخيارات:
true,false
- الخيارات:
discussion_category_name(string, اختياري): اسم فئة المناقشة - إذا حُدد، يتم إنشاء مناقشة من الفئة المحددة وربطها بالإصدار.generate_release_notes(string, اختياري): ملاحظات الإصدار - حدد ما إذا كان يجب إنشاء ملاحظات الإصدار تلقائياً.- الخيارات:
true,false
- الخيارات:
github/get_release_by_id
github/get_release_by_id
الوصف: الحصول على إصدار بواسطة المعرّف في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذا الإصدار. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذا الإصدار.id(string, مطلوب): معرّف الإصدار - حدد معرّف الإصدار المراد جلبه.
github/get_release_by_tag_name
github/get_release_by_tag_name
الوصف: الحصول على إصدار بواسطة اسم الوسم في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذا الإصدار. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذا الإصدار.tag_name(string, مطلوب): الاسم - حدد وسم الإصدار المراد جلبه. (مثال: “v1.0.0”).
github/delete_release
github/delete_release
الوصف: حذف إصدار في GitHub.المعاملات:
owner(string, مطلوب): المالك - حدد اسم مالك الحساب للمستودع المرتبط بهذا الإصدار. (مثال: “abc”).repo(string, مطلوب): المستودع - حدد اسم المستودع المرتبط بهذا الإصدار.id(string, مطلوب): معرّف الإصدار - حدد معرّف الإصدار المراد حذفه.
أمثلة الاستخدام
إعداد Agent أساسي لـ GitHub
تصفية أدوات GitHub محددة
إدارة الإصدارات
تتبع المشكلات وإدارتها
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل GitHub أو
استكشاف الأخطاء وإصلاحها.
