ApifyActorsTool

Integre Apify Actors nos seus fluxos de trabalho CrewAI.

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

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

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

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

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