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:

  1. 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.
  2. Abra a tela Conectores e conecte o Apify. A conexão pode ser pessoal, do time ou da empresa.
  3. Na tela Agentes, abra o agente que fará a coleta (por exemplo, um agente de pesquisa) e ative o Apify para ele.
  4. 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.
  5. 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.

ObjetivoO que o agente fazConector usado
Descobrir uma ferramentaPesquisa Actors adequados e explica a diferença entre elesApify
Coletar dadosExecuta o Actor com os parâmetros pedidosApify
Consultar resultadosLê o resultado de uma execução e resume ou filtraApify
Guardar os dadosAcrescenta linhas em uma planilhaGoogle 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.