Apify Actors

Apify Actors

ApifyActorsTool을 사용하면 Apify Actors를 호출해 CrewAI 워크플로에 웹 스크래핑·크롤링·데이터 추출·웹 자동화 기능을 더할 수 있어요.

출처: 문서

본문

ApifyActorsTool

Apify Actors를 CrewAI 워크플로에 통합하세요.

설명 (Description)

ApifyActorsTool은 웹 스크래핑과 자동화를 위한 클라우드 기반 프로그램인 Apify Actors를 CrewAI 워크플로에 연결합니다. Apify Store의 4,000개 이상의 Actors를 사용해 소셜 미디어, 검색 엔진, 온라인 지도, 전자상거래 사이트, 여행 포털 또는 일반 웹사이트에서 데이터를 추출하는 등 다양한 용도로 활용할 수 있어요. 자세한 내용은 Apify 문서의 Apify CrewAI 통합을 참고하세요.

시작하기 위한 단계 (Steps to get started)

  1. 의존성 설치 — pip로 crewai[tools]와 langchain-apify를 설치하세요: pip install 'crewai[tools]' langchain-apify.
  2. Apify API 토큰 발급 — Apify Console에 가입하고 Apify API 토큰을 받으세요.
  3. 환경 구성 — 도구가 동작하도록 APIFY_API_TOKEN 환경 변수에 Apify API 토큰을 설정하세요.

사용 예제 (Usage example)

RAG Web Browser Actor를 실행해 웹 검색을 수행하려면 ApifyActorsTool을 수동으로 이렇게 사용하세요:

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]}...")
기대 출력 (Expected output)

위 코드를 실행한 출력은 다음과 같습니다:

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_name을 사용해 Apify에서 Actor 정의와 입력 스키마를 자동으로 가져온 뒤, 도구 설명과 인자 스키마를 구성합니다. 즉, 유효한 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],
)

Apify Store의 다른 Actors도 actor_name만 바꾸고, 수동으로 사용할 때는 Actor 입력 스키마에 맞춰 run_input을 조정하면 실행할 수 있어요. 에이전트와 함께 사용하는 예제는 CrewAI Actor 템플릿을 참고하세요.

설정 (Configuration)

ApifyActorsTool이 동작하려면 다음 입력이 필요합니다:

  • actor_name 실행할 Apify Actor의 ID, 예: "apify/rag-web-browser". 모든 Actors는 Apify Store에서 찾아볼 수 있어요.
  • run_input 도구를 수동으로 실행할 때 Actor에 전달하는 입력 파라미터 딕셔너리.
    • 예를 들어 apify/rag-web-browser Actor의 경우: {"query": "search term", "maxResults": 5}
    • 입력 파라미터 목록은 Actor의 input schema를 참고하세요.

리소스 (Resources)

더 알아보기 (Learn more)