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

نظرة عامة

مستودع الأدوات هو مدير حزم لأدوات CrewAI. يتيح للمستخدمين نشر وتثبيت وإدارة الأدوات التي تتكامل مع طواقم وتدفقات CrewAI. يمكن أن تكون الأدوات:
  • خاصة: متاحة فقط داخل مؤسستك (افتراضي)
  • عامة: متاحة لجميع مستخدمي CrewAI إذا نُشرت بعلامة --public
المستودع ليس نظام تحكم في الإصدارات. استخدم Git لتتبع تغييرات الكود وتمكين التعاون.

المتطلبات المسبقة

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

تثبيت الأدوات

لتثبيت أداة:
يثبّت هذا الأداة ويضيفها إلى pyproject.toml. يمكنك استخدام الأداة باستيرادها وإضافتها إلى وكلائك:

إضافة حزم أخرى بعد تثبيت أداة

بعد تثبيت أداة من مستودع أدوات CrewAI AMP، تحتاج لاستخدام أمر crewai uv لإضافة حزم أخرى لمشروعك. استخدام أوامر uv المباشرة سيفشل لأن المصادقة لمستودع الأدوات يتم التعامل معها عبر CLI. باستخدام أمر crewai uv، يمكنك إضافة حزم أخرى لمشروعك دون القلق بشأن المصادقة. يمكن استخدام أي أمر uv مع أمر crewai uv، مما يجعله أداة قوية لإدارة اعتماديات مشروعك دون عناء إدارة المصادقة عبر متغيرات البيئة أو طرق أخرى. لنفرض أنك ثبّت أداة مخصصة من مستودع أدوات CrewAI AMP تسمى “my-tool”:
والآن تريد إضافة حزمة أخرى لمشروعك، يمكنك استخدام الأمر التالي:
أوامر أخرى مثل uv sync أو uv remove يمكن أيضاً استخدامها مع أمر crewai uv:
سيضيف هذا الحزمة لمشروعك ويحدّث pyproject.toml وفقاً لذلك.

إنشاء ونشر الأدوات

لإنشاء مشروع أداة جديد:
يولّد هذا مشروع أداة مُهيكل محلياً. بعد إجراء التغييرات، أنشئ مستودع Git وارفع الكود:
لنشر الأداة:
افتراضياً، تُنشر الأدوات كخاصة. لجعل الأداة عامة:
لمزيد من التفاصيل حول بناء الأدوات، راجع إنشاء أدواتك الخاصة.

تحديث الأدوات

لتحديث أداة منشورة:
  1. عدّل الأداة محلياً
  2. حدّث الإصدار في pyproject.toml (مثل من 0.1.0 إلى 0.1.1)
  3. ارفع التغييرات وانشر

حذف الأدوات

لحذف أداة:
  1. انتقل إلى CrewAI AMP
  2. انتقل إلى Tools
  3. اختر الأداة
  4. انقر على Delete
الحذف نهائي. لا يمكن استعادة أو إعادة تثبيت الأدوات المحذوفة.

فحوصات الأمان

كل إصدار منشور يخضع لفحوصات أمان آلية، ولا يكون متاحاً للتثبيت إلا بعد اجتيازها. يمكنك التحقق من حالة فحص الأمان للأداة في: CrewAI AMP > Tools > Your Tool > Versions

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

تواصل مع فريق الدعم للمساعدة في تكامل API أو استكشاف الأخطاء.