تخطَّ إلى المحتوى
توثيق CrewAI

Apify Actors

ApifyActorsTool

Section titled “ApifyActorsTool”

دمج Apify Actors في سير عمل CrewAI الخاص بك.

الوصف

Section titled “الوصف”

تربط ApifyActorsTool بين Apify Actors، وهي برامج سحابية لتجريف الويب والأتمتة، وسير عمل CrewAI الخاص بك. استخدم أياً من أكثر من 4,000 Actor على متجر Apify لحالات استخدام مثل استخراج البيانات من وسائل التواصل الاجتماعي ومحركات البحث والخرائط الإلكترونية ومواقع التجارة الإلكترونية وبوابات السفر أو المواقع العامة.

للتفاصيل، راجع تكامل Apify CrewAI في وثائق Apify.

خطوات البدء

Section titled “خطوات البدء”
  1. تثبيت التبعيات

    ثبّت crewai[tools] وlangchain-apify باستخدام pip: pip install 'crewai[tools]' langchain-apify.

  2. الحصول على رمز API لـ Apify

    سجّل في وحدة تحكم Apify واحصل على رمز API الخاص بك.

  3. إعداد البيئة

    عيّن رمز API لـ Apify كمتغير بيئة APIFY_API_TOKEN لتمكين وظائف الأداة.

مثال على الاستخدام

Section titled “مثال على الاستخدام”

استخدم ApifyActorsTool يدوياً لتشغيل RAG Web Browser Actor لإجراء بحث ويب:

from crewai_tools import ApifyActorsTool


# Initialize the tool with an Apify Actor
tool = ApifyActorsTool(actor_name="apify/rag-web-browser")


# Run the tool with input parameters
results = tool.run(run_input={"query": "What is CrewAI?", "maxResults": 5})


# Process the results
for result in results:
    print(f"URL: {result['metadata']['url']}")
    print(f"Content: {result.get('markdown', 'N/A')[:100]}...")

المخرجات المتوقعة

Section titled “المخرجات المتوقعة”

إليك المخرجات من تشغيل الكود أعلاه:

URL: https://www.example.com/crewai-intro
Content: CrewAI is a framework for building AI-powered workflows...
URL: https://docs.crewai.com/
Content: Official documentation for CrewAI...

تقوم ApifyActorsTool تلقائياً بجلب تعريف Actor ومخطط الإدخال من Apify باستخدام actor_name المقدم ثم تبني وصف الأداة ومخطط المعاملات. هذا يعني أنك تحتاج فقط إلى تحديد actor_name صالح، والأداة تتعامل مع الباقي عند استخدامها مع الوكلاء - دون الحاجة لتحديد run_input. إليك كيفية عمل ذلك:

from crewai import Agent
from crewai_tools import ApifyActorsTool


rag_browser = ApifyActorsTool(actor_name="apify/rag-web-browser")


agent = Agent(
    role="Research Analyst",
    goal="Find and summarize information about specific topics",
    backstory="You are an experienced researcher with attention to detail",
    tools=[rag_browser],
)

يمكنك تشغيل Actors أخرى من متجر Apify ببساطة عن طريق تغيير actor_name وعند الاستخدام اليدوي، ضبط run_input بناءً على مخطط إدخال Actor.

لمثال على الاستخدام مع الوكلاء، راجع قالب CrewAI Actor.

الإعداد

Section titled “الإعداد”

تتطلب ApifyActorsTool المدخلات التالية للعمل:

  • actor_name معرّف Apify Actor المراد تشغيله، مثل "apify/rag-web-browser". تصفح جميع Actors على متجر Apify.
  • run_input قاموس من معاملات الإدخال لـ Actor عند تشغيل الأداة يدوياً.
    • على سبيل المثال، لـ Actor apify/rag-web-browser: {"query": "search term", "maxResults": 5}
    • راجع مخطط إدخال Actor لقائمة معاملات الإدخال.

الموارد

Section titled “الموارد”