مستودع الأدوات

نظرة عامة

مستودع الأدوات هو مدير حزم لأدوات CrewAI. يتيح للمستخدمين نشر وتثبيت وإدارة الأدوات التي تتكامل مع طواقم وتدفقات CrewAI.

يمكن أن تكون الأدوات:

• خاصة: متاحة فقط داخل مؤسستك (افتراضي)
• عامة: متاحة لجميع مستخدمي CrewAI إذا نُشرت بعلامة --public

المستودع ليس نظام تحكم في الإصدارات. استخدم Git لتتبع تغييرات الكود وتمكين التعاون.

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

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

• حساب CrewAI AMP
• CrewAI CLI مُثبّت
• uv>=0.5.0 مُثبّت. راجع كيفية الترقية
• Git مُثبّت ومُهيأ
• صلاحيات الوصول للنشر أو التثبيت في مؤسسة CrewAI AMP

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

لتثبيت أداة:

crewai tool install <tool-name>

يثبّت هذا الأداة ويضيفها إلى pyproject.toml.

يمكنك استخدام الأداة باستيرادها وإضافتها إلى وكلائك:

from your_tool.tool import YourTool

custom_tool = YourTool()

researcher = Agent(
    role='Market Research Analyst',
    goal='Provide up-to-date market analysis of the AI industry',
    backstory='An expert analyst with a keen eye for market trends.',
    tools=[custom_tool],
    verbose=True
)

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

بعد تثبيت أداة من مستودع أدوات CrewAI AMP، تحتاج لاستخدام أمر crewai uv لإضافة حزم أخرى لمشروعك. استخدام أوامر uv المباشرة سيفشل لأن المصادقة لمستودع الأدوات يتم التعامل معها عبر CLI. باستخدام أمر crewai uv، يمكنك إضافة حزم أخرى لمشروعك دون القلق بشأن المصادقة. يمكن استخدام أي أمر uv مع أمر crewai uv، مما يجعله أداة قوية لإدارة اعتماديات مشروعك دون عناء إدارة المصادقة عبر متغيرات البيئة أو طرق أخرى.

لنفرض أنك ثبّت أداة مخصصة من مستودع أدوات CrewAI AMP تسمى “my-tool”:

crewai tool install my-tool

والآن تريد إضافة حزمة أخرى لمشروعك، يمكنك استخدام الأمر التالي:

crewai uv add requests

أوامر أخرى مثل uv sync أو uv remove يمكن أيضاً استخدامها مع أمر crewai uv:

crewai uv sync

crewai uv remove requests

سيضيف هذا الحزمة لمشروعك ويحدّث pyproject.toml وفقاً لذلك.

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

لإنشاء مشروع أداة جديد:

crewai tool create <tool-name>

يولّد هذا مشروع أداة مُهيكل محلياً.

بعد إجراء التغييرات، أنشئ مستودع Git وارفع الكود:

git init
git add .
git commit -m "Initial version"

لنشر الأداة:

crewai tool publish

افتراضياً، تُنشر الأدوات كخاصة. لجعل الأداة عامة:

crewai tool publish --public

لمزيد من التفاصيل حول بناء الأدوات، راجع إنشاء أدواتك الخاصة.

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

لتحديث أداة منشورة:

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

git commit -m "Update version to 0.1.1"
crewai tool publish

حذف الأدوات

لحذف أداة:

1. انتقل إلى CrewAI AMP
2. انتقل إلى Tools
3. اختر الأداة
4. انقر على Delete

Warning

الحذف نهائي. لا يمكن استعادة أو إعادة تثبيت الأدوات المحذوفة.

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

كل إصدار منشور يخضع لفحوصات أمان آلية، ولا يكون متاحاً للتثبيت إلا بعد اجتيازها.

يمكنك التحقق من حالة فحص الأمان للأداة في:

CrewAI AMP > Tools > Your Tool > Versions

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

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