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

نظرة عامة

تُمكّن أدوات CrewAI الوكلاء بقدرات تتراوح من البحث على الويب وتحليل البيانات إلى التعاون وتفويض المهام بين الزملاء. توضح هذه الوثائق كيفية إنشاء هذه الأدوات ودمجها والاستفادة منها ضمن إطار عمل CrewAI، بما في ذلك التركيز على أدوات التعاون.

ما هي الأداة؟

الأداة في CrewAI هي مهارة أو وظيفة يمكن للوكلاء استخدامها لأداء إجراءات مختلفة. يشمل ذلك أدوات من مجموعة أدوات CrewAI وأدوات LangChain، مما يُمكّن كل شيء من عمليات البحث البسيطة إلى التفاعلات المعقدة والعمل الجماعي الفعال بين الوكلاء.
يوفر CrewAI AMP مستودع أدوات شامل مع تكاملات جاهزة لأنظمة الأعمال الشائعة وواجهات API. انشر الوكلاء مع أدوات المؤسسة في دقائق بدلاً من أيام.يتضمن مستودع أدوات المؤسسة:
  • موصلات جاهزة لأنظمة المؤسسة الشائعة
  • واجهة إنشاء أدوات مخصصة
  • إمكانيات التحكم في الإصدارات والمشاركة
  • ميزات الأمان والامتثال

الخصائص الرئيسية للأدوات

  • المنفعة: مصممة لمهام مثل البحث على الويب وتحليل البيانات وإنشاء المحتوى وتعاون الوكلاء.
  • التكامل: تعزز قدرات الوكلاء من خلال دمج الأدوات بسلاسة في سير عملهم.
  • القابلية للتخصيص: توفر المرونة لتطوير أدوات مخصصة أو استخدام الأدوات الموجودة، لتلبية الاحتياجات المحددة للوكلاء.
  • معالجة الأخطاء: تتضمن آليات معالجة أخطاء قوية لضمان التشغيل السلس.
  • آلية التخزين المؤقت: تتميز بتخزين مؤقت ذكي لتحسين الأداء وتقليل العمليات المتكررة.
  • الدعم غير المتزامن: تتعامل مع الأدوات المتزامنة وغير المتزامنة، مما يُمكّن العمليات غير الحاجبة.

استخدام أدوات CrewAI

لتعزيز قدرات وكلائك بأدوات CrewAI، ابدأ بتثبيت حزمة الأدوات الإضافية:
إليك مثالًا يوضح استخدامها:
Code

أدوات CrewAI المتاحة

  • معالجة الأخطاء: جميع الأدوات مبنية بقدرات معالجة الأخطاء، مما يسمح للوكلاء بإدارة الاستثناءات بسلاسة ومتابعة مهامهم.
  • آلية التخزين المؤقت: جميع الأدوات تدعم التخزين المؤقت، مما يُمكّن الوكلاء من إعادة استخدام النتائج المحصلة سابقًا بكفاءة، مما يقلل الحمل على الموارد الخارجية ويسرّع وقت التنفيذ. يمكنك أيضًا تحديد تحكم أدق في آلية التخزين المؤقت باستخدام خاصية cache_function على الأداة.
إليك قائمة بالأدوات المتاحة وأوصافها:
الأداةالوصف
ApifyActorsToolأداة تدمج Apify Actors مع سير عملك لمهام استخراج البيانات من الويب والأتمتة.
BrowserbaseLoadToolأداة للتفاعل مع المتصفحات واستخراج البيانات منها.
CodeDocsSearchToolأداة RAG محسّنة للبحث في وثائق الكود والمستندات التقنية ذات الصلة.
CodeInterpreterToolأداة لتفسير كود Python.
ComposioToolتُمكّن استخدام أدوات Composio.
CSVSearchToolأداة RAG مصممة للبحث في ملفات CSV، مخصصة للتعامل مع البيانات المنظمة.
DALL-E Toolأداة لإنشاء الصور باستخدام DALL-E API.
DirectorySearchToolأداة RAG للبحث في المجلدات، مفيدة للتنقل في أنظمة الملفات.
DOCXSearchToolأداة RAG للبحث في مستندات DOCX، مثالية لمعالجة ملفات Word.
DirectoryReadToolتسهّل قراءة ومعالجة هياكل المجلدات ومحتوياتها.
EXASearchToolأداة مصممة لإجراء عمليات بحث شاملة عبر مصادر بيانات متنوعة.
FileReadToolتُمكّن قراءة واستخراج البيانات من الملفات، مع دعم تنسيقات ملفات متنوعة.
FirecrawlSearchToolأداة للبحث في صفحات الويب باستخدام Firecrawl وإرجاع النتائج.
FirecrawlCrawlWebsiteToolأداة لزحف صفحات الويب باستخدام Firecrawl.
FirecrawlScrapeWebsiteToolأداة لاستخراج محتوى عناوين URL لصفحات الويب باستخدام Firecrawl.
GithubSearchToolأداة RAG للبحث في مستودعات GitHub، مفيدة لبحث الكود والوثائق.
SerperDevToolأداة متخصصة لأغراض التطوير، مع وظائف محددة قيد التطوير.
TXTSearchToolأداة RAG مركّزة على البحث في ملفات النص (.txt)، مناسبة للبيانات غير المنظمة.
JSONSearchToolأداة RAG مصممة للبحث في ملفات JSON، تخدم التعامل مع البيانات المنظمة.
LlamaIndexToolتُمكّن استخدام أدوات LlamaIndex.
MDXSearchToolأداة RAG مخصصة للبحث في ملفات Markdown (MDX)، مفيدة للوثائق.
PDFSearchToolأداة RAG للبحث في مستندات PDF، مثالية لمعالجة المستندات الممسوحة ضوئيًا.
PGSearchToolأداة RAG محسّنة للبحث في قواعد بيانات PostgreSQL، مناسبة لاستعلامات قواعد البيانات.
Vision Toolأداة لإنشاء الصور باستخدام DALL-E API.
RagToolأداة RAG للأغراض العامة قادرة على التعامل مع مصادر وأنواع بيانات متنوعة.
ScrapeElementFromWebsiteToolتُمكّن استخراج عناصر محددة من المواقع، مفيدة لاستخراج البيانات المستهدف.
ScrapeWebsiteToolتسهّل استخراج المواقع بالكامل، مثالية لجمع البيانات الشامل.
WebsiteSearchToolأداة RAG للبحث في محتوى المواقع، محسّنة لاستخراج بيانات الويب.
XMLSearchToolأداة RAG مصممة للبحث في ملفات XML، مناسبة لتنسيقات البيانات المنظمة.
YoutubeChannelSearchToolأداة RAG للبحث في قنوات YouTube، مفيدة لتحليل محتوى الفيديو.
YoutubeVideoSearchToolأداة RAG للبحث في مقاطع فيديو YouTube، مثالية لاستخراج بيانات الفيديو.

إنشاء أدواتك الخاصة

يمكن للمطورين إنشاء أدوات مخصصة مصممة خصيصًا لاحتياجات وكلائهم أو استخدام الخيارات الجاهزة.
هناك طريقتان رئيسيتان لإنشاء أداة CrewAI:

الوراثة من BaseTool

Code

دعم الأدوات غير المتزامنة

يدعم CrewAI الأدوات غير المتزامنة، مما يتيح لك تنفيذ أدوات تجري عمليات غير حاجبة مثل طلبات الشبكة وعمليات الإدخال/الإخراج على الملفات أو عمليات async أخرى بدون حجب مسار التنفيذ الرئيسي.

إنشاء أدوات غير متزامنة

يمكنك إنشاء أدوات غير متزامنة بطريقتين:

1. استخدام مزيّن tool مع دوال Async

Code

2. تنفيذ طرق Async في فئات الأدوات المخصصة

Code

استخدام الأدوات غير المتزامنة

تعمل الأدوات غير المتزامنة بسلاسة في كل من سير عمل الطاقم القياسي وسير عمل التدفق:
Code
يتعامل إطار عمل CrewAI تلقائيًا مع تنفيذ الأدوات المتزامنة وغير المتزامنة، لذا لا تحتاج للقلق بشأن كيفية استدعائها بشكل مختلف.

استخدام مزيّن tool

Code

آلية التخزين المؤقت المخصصة

يمكن للأدوات اختياريًا تنفيذ cache_function لضبط سلوك التخزين المؤقت. تحدد هذه الدالة متى يتم تخزين النتائج مؤقتًا بناءً على شروط محددة، مما يوفر تحكمًا دقيقًا في منطق التخزين المؤقت.
Code

الخلاصة

الأدوات محورية في توسيع قدرات وكلاء CrewAI، مما يمكّنهم من تنفيذ مجموعة واسعة من المهام والتعاون بفعالية. عند بناء حلول مع CrewAI، استفد من كل من الأدوات المخصصة والموجودة لتمكين وكلائك وتعزيز نظام الذكاء الاصطناعي البيئي. فكّر في استخدام معالجة الأخطاء وآليات التخزين المؤقت ومرونة معاملات الأدوات لتحسين أداء وقدرات وكلائك.