Pular para o conteúdo
CrewAI Documentation

Apify Actors

ApifyActorsTool

Seção intitulada “ApifyActorsTool”

Integre Apify Actors nos seus fluxos de trabalho CrewAI.

Descrição

Seção intitulada “Descrição”

O ApifyActorsTool conecta Apify Actors, programas em nuvem para raspagem e automação web, aos seus fluxos de trabalho CrewAI. Utilize qualquer um dos mais de 4.000 Actors disponíveis na Apify Store para casos de uso como extração de dados de redes sociais, motores de busca, mapas online, sites de e-commerce, portais de viagem ou sites em geral.

Para mais detalhes, consulte a integração Apify CrewAI na documentação do Apify.

Passos para começar

Seção intitulada “Passos para começar”
  1. Instale as dependências

    Instale crewai[tools] e langchain-apify usando pip: pip install 'crewai[tools]' langchain-apify.

  2. Obtenha um token de API do Apify

    Cadastre-se no Apify Console e obtenha seu token de API do Apify.

  3. Configure o ambiente

    Defina seu token de API do Apify na variável de ambiente APIFY_API_TOKEN para habilitar a funcionalidade da ferramenta.

Exemplo de uso

Seção intitulada “Exemplo de uso”

Use o ApifyActorsTool manualmente para executar o RAG Web Browser Actor e realizar uma busca na web:

from crewai_tools import ApifyActorsTool


# Inicialize a ferramenta com um Apify Actor
tool = ApifyActorsTool(actor_name="apify/rag-web-browser")


# Execute a ferramenta com parâmetros de entrada
results = tool.run(run_input={"query": "What is CrewAI?", "maxResults": 5})


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

Saída esperada

Seção intitulada “Saída esperada”

Veja abaixo a saída do código acima:

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...

O ApifyActorsTool busca automaticamente a definição do Actor e o esquema de entrada no Apify utilizando o actor_name fornecido e então constrói a descrição da ferramenta e o esquema dos argumentos. Isso significa que você só precisa informar um actor_name válido, e a ferramenta faz o resto quando usada com agentes—não é necessário especificar o run_input. Veja como funciona:

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],
)

Você pode executar outros Actors da Apify Store apenas alterando o actor_name e, ao usar manualmente, ajustando o run_input de acordo com o esquema de entrada do Actor.

Para um exemplo de uso com agentes, consulte o template CrewAI Actor.

Configuração

Seção intitulada “Configuração”

O ApifyActorsTool exige os seguintes inputs para funcionar:

  • actor_name O ID do Apify Actor a ser executado, por exemplo, "apify/rag-web-browser". Explore todos os Actors na Apify Store.
  • run_input Um dicionário de parâmetros de entrada para o Actor ao executar a ferramenta manualmente.
    • Por exemplo, para o Actor apify/rag-web-browser: {"query": "search term", "maxResults": 5}
    • Veja o schema de entrada do Actor para a lista de parâmetros de entrada.

Recursos

Seção intitulada “Recursos”