UltronChatUltronChat Docs
Agente de IA

Pesquisa na web

Deixe a IA buscar informacao atualizada na internet — restrita aos sites que voce autorizar em cada agente.

A IA responde a partir das instrucoes que voce escreveu no agente. Quando o cliente pergunta algo que nao esta la — um preco que mudou, um prazo, uma novidade — ela nao tem como saber, e acaba passando a conversa para um humano.

A pesquisa na web resolve isso: a IA busca no Google e pode ler a pagina, mas somente nos sites que voce listar. Nao existe modo "internet aberta".

Configure em duas etapas: a conta em Pesquisa na web no menu lateral (/dashboard/settings/web-search), e os sites em cada agente.

1. Conecte uma conta Serper

A busca usa a Serper, um servico de busca no Google. A conta e sua, e o custo das buscas tambem — assim voce controla o gasto.

  1. Crie uma conta gratuita em serper.dev/dashboard. O plano inicial vem com buscas gratis, sem cartao.
  2. Copie a Api Key.
  3. Cole em Pesquisa na web e clique em Conectar.

Validamos a chave com uma busca real antes de salvar. Se ela nao funcionar, nada e gravado e voce ve o motivo na hora.

Uma conta Serper vale para todos os seus agentes.

2. Autorize os sites em cada agente

Abra o agente, va na aba Avancado e ligue Pesquisa na web. Vai aparecer um campo para os sites.

Digite o dominio e pressione Enter. Pode colar a URL inteira que a gente limpa: https://www.suaempresa.com.br/precos vira suaempresa.com.br.

Enquanto essa lista estiver vazia, a IA nao pesquisa nada. Isso e proposital: sem os sites declarados, ela poderia trazer conteudo de concorrente ou de forum aleatorio falando em nome da sua empresa.

Alguns pontos:

  • Subdominios entram automaticamente. Autorizar suaempresa.com.br ja libera blog.suaempresa.com.br e ajuda.suaempresa.com.br.
  • Ate 20 sites por agente.
  • Cada agente tem a sua lista. Se voce atende duas marcas em conexoes diferentes, cada uma consulta so as proprias fontes.

Como a IA usa

Ela decide sozinha quando vale pesquisar — se a resposta ja esta nas instrucoes do agente, ela responde direto, sem gastar busca. Quando pesquisa, cita de onde tirou a informacao, para o cliente poder conferir.

Se a busca falhar ou nao achar nada nos seus sites, ela diz que vai verificar e retorna. Ela nao inventa preco, link nem afirma que algo nao existe.

Custo

Cada busca consome credito da sua conta Serper, e ler uma pagina consome mais que uma busca. Dois limites protegem a sua cota:

  • Ate 15 buscas e 10 leituras de pagina por conversa, por dia.
  • Resultados repetidos vem do cache por alguns minutos, sem gastar credito novo.

Em Preferencias de busca voce escolhe quantos resultados cada busca traz (1 a 10), o pais e o idioma. Menos resultados = menos texto para a IA processar.

Se a IA nao estiver pesquisando

Confira, nesta ordem:

  1. A lista de sites do agente esta vazia? E a causa mais comum.
  2. O badge em Pesquisa na web esta como Conectada? Se estiver "Chave invalida", gere uma nova em serper.dev e reconecte.
  3. O agente esta ativo e com chave de IA configurada?
  4. Seu plano e Pro? A pesquisa na web e um recurso dos planos Pro.

Se a IA pesquisa mas ignora um site especifico, confira se ele foi salvo como dominio puro (exemplo.com.br) — e nao com https:// ou barra no fim.

On this page