Como usar agente de IA com o Apify para coletar dados da web
· DoubleX
Resposta rápida
Para usar o Apify com um agente de IA, conecte o Apify como conector, defina quais ações o agente pode executar e peça em linguagem natural para pesquisar e rodar Actors e consultar os resultados. No DoubleX Agentes, dá para agendar a coleta e salvar os dados em planilhas.
Times técnicos e de pesquisa costumam depender de coletas na web: listas de empresas, páginas de concorrentes, resultados de busca, avaliações. O Apify faz esse trabalho com Actors, mas alguém precisa abrir a plataforma, escolher o Actor, configurar a entrada e conferir o resultado. Com um agente de IA, esse ciclo vira um pedido em linguagem natural.
O que é o Apify e o que um agente de IA consegue fazer com ele?#
Apify é uma plataforma de coleta de dados na web em que cada Actor é um programa pronto (ou próprio) que visita sites e devolve dados estruturados. Pelo conector do DoubleX Agentes, o agente pode pesquisar Actors, executá-los e consultar os resultados das execuções.
Na prática, o agente cobre o que você faria manualmente na plataforma:
- Procurar um Actor adequado para a tarefa (por exemplo, um que colete páginas de um site ou resultados de busca).
- Executar o Actor com os parâmetros que você descreveu.
- Consultar o resultado e resumir, filtrar ou organizar os dados.
O agente trabalha com o que o conector permite. Para extrair páginas simples ou pesquisar na web, outros conectores de pesquisa, como Firecrawl, Tavily e Exa, também estão disponíveis. O Apify entra quando você precisa de um Actor específico para a coleta.
Como conectar o Apify ao DoubleX Agentes?#
A conexão é feita na tela Conectores, e as permissões são definidas por agente. O passo a passo:
- Crie a conta no DoubleX Agentes (grátis, sem cartão) e, se quiser, faça o diagnóstico para gerar uma equipe de agentes já com as instruções da empresa.
- Abra a tela Conectores e conecte o Apify. A conexão pode ser pessoal, do time ou da empresa.
- Na tela Agentes, abra o agente que fará a coleta (por exemplo, um agente de pesquisa) e ative o Apify para ele.
- Defina as ações permitidas no Apify. Se o agente só precisa consultar resultados, deixe só leitura; libere a execução de Actors apenas quando fizer sentido.
- Faça um primeiro pedido pequeno em Tarefas e confira o histórico antes de ampliar o uso.
Se você prefere automatizar por código, a documentação de conectores mostra como gerenciar conexões pela API.
Que pedidos dá para fazer? Exemplos para pesquisar e executar Actors e consultar resultados#
Dá para pedir três tipos de coisa: descobrir Actors, executar uma coleta e consultar o que já foi coletado. Escreva o pedido com o site, os campos que você quer e o formato da entrega.
| Objetivo | O que o agente faz | Conector usado |
|---|---|---|
| Descobrir uma ferramenta | Pesquisa Actors adequados e explica a diferença entre eles | Apify |
| Coletar dados | Executa o Actor com os parâmetros pedidos | Apify |
| Consultar resultados | Lê o resultado de uma execução e resume ou filtra | Apify |
| Guardar os dados | Acrescenta linhas em uma planilha | Google Sheets |
Exemplos de pedidos para copiar:
- "Pesquise no Apify Actors que coletem avaliações públicas de um site e me diga qual é o mais indicado para o meu caso."
- "Execute o Actor escolhido para a página que vou indicar e me traga título, descrição e data de cada item em uma tabela."
- "Consulte o resultado da última execução desse Actor e liste os itens que se repetem."
- "Rode a coleta com um limite pequeno de itens e me mostre uma amostra antes de seguir para o conjunto completo."
Como rodar a coleta de dados em uma rotina agendada?#
Uma rotina faz o agente trabalhar sozinho em um horário, e ela roda com as permissões de quem a criou. Você descreve a coleta e a frequência, e o agente executa o Actor e entrega o resultado.
Os gatilhos disponíveis incluem horário recorrente (todo dia às 8h, toda segunda, a cada hora), uma única vez numa data, webhook, e-mail recebido ou evento em um app conectado. Para coletas de pesquisa, o mais comum é o horário recorrente.
Exemplos de rotinas:
- "Toda segunda às 7h, execute o Actor de coleta que usamos e acrescente os novos itens na planilha de pesquisa."
- "Todo dia às 8h, consulte o resultado da última execução e me envie um resumo do que mudou."
Se um sistema externo precisa disparar a coleta, use webhooks. Para configurar rotinas por código, veja a documentação de gatilhos.
Como combinar o Apify com Google Sheets, Drive e Brain para guardar e analisar os dados?#
O Apify coleta; o resto da cadeia guarda, organiza e analisa. Combine conectores no mesmo agente para fechar o ciclo sem copiar e colar.
- Google Sheets: o agente acrescenta linhas em uma planilha a cada coleta, criando uma base histórica que o time consulta.
- Google Drive: o agente salva relatórios e arquivos gerados a partir dos dados em uma pasta combinada e compartilha com quem precisa.
- Brain: guarde na base de conhecimento os critérios de pesquisa, a lista de sites de interesse e o significado de cada campo, para o agente seguir o mesmo padrão em toda coleta.
- Artefatos: peça um relatório, uma planilha ou um painel ao vivo com os dados coletados e compartilhe com o time.
Exemplo: "Pegue o resultado da coleta de hoje, acrescente na aba Coletas da planilha de pesquisa, marque os itens novos e gere um resumo com os três principais achados."
Quando os dados chegam à planilha, vale conferi-los contra outras fontes. O guia sobre como conferir dados entre planilhas e sistemas mostra como. Para análises mais profundas, veja Hex com agente de IA.
Como manter o controle: permissões, confirmação e histórico de cada tarefa?#
Você decide o que cada agente pode fazer, e tudo fica registrado. Para cada agente, a empresa escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Ações que alteram dados podem ficar desligadas.
Os pontos de controle principais:
- Permissões por agente: o agente de pesquisa pode ter o Apify e o Google Sheets, sem acesso a e-mail ou CRM.
- Confirmação: antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez.
- Histórico: cada pedido vira uma tarefa na tela Tarefas, com o pedido, cada ferramenta usada e o resultado. Dá para saber quem pediu, o que foi feito e quando.
- Credenciais protegidas: senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM.
- Privacidade: o conteúdo da empresa não é usado para treinar modelos.
Para quem integra por código, as chaves de API permitem conversar com os agentes fora da interface.
Perguntas frequentes#
Preciso saber programar para usar o Apify com o agente?#
Não para pedir coletas: você descreve o que precisa com as próprias palavras. Conhecimento técnico ajuda a escolher bons Actors e a definir os parâmetros, mas o agente pode sugerir e explicar as opções.
O agente consegue criar um Actor novo no Apify?#
O conector permite pesquisar e executar Actors e consultar resultados. Criar ou editar o código de um Actor não faz parte do que está descrito para o conector, então faça isso direto no Apify.
Onde ficam os dados coletados?#
O resultado fica disponível no Apify e o agente pode consultá-lo. Para guardar no seu ambiente, peça que o agente grave os dados no Google Sheets ou gere um arquivo no Google Drive.
Posso deixar o agente executando coletas sozinho?#
Sim, por meio de rotinas agendadas ou gatilhos como webhook. A rotina roda com as permissões de quem a criou, e cada execução fica registrada no histórico de tarefas.
Qual a diferença entre o Apify e conectores como Firecrawl ou Tavily?#
Firecrawl, Tavily e Exa servem para extrair páginas e pesquisar na web. O Apify é indicado quando você quer executar um Actor específico de coleta e consultar os resultados dele.