Busca na web: o Robô pesquisando na internet pública

Visão geral

A busca na web dá ao Robô duas ferramentas para consultar a internet pública — coisas que ele não sabe e que não estão na sua conta: notícias, preços de mercado, dados públicos de empresas, documentação, qualquer coisa que mudou depois do treinamento do modelo.

As duas são somente leitura e não enviam nada ao contato: elas devolvem texto para o modelo, que então decide o que (e se) vai dizer. Por isso continuam disponíveis mesmo quando o Robô delega a um subagente.

Para o conteúdo da sua conta — contatos, negócios, catálogo, histórico — o Robô tem ferramentas próprias, e a base de conhecimento guarda o seu material. A busca na web é para o que está fora.

Pré-requisitos

• Maestro habilitado e um Robô configurado.
• Uma chave de API da Tavily disponível para o Robô (veja "A chave" abaixo).
• As ferramentas web_search e/ou web_fetch habilitadas na grade de ferramentas do Robô — sem elas, nada nesta seção tem efeito.

Passo a passo

1. Na configuração do Robô, abra a grade de Ferramentas e habilite Buscar na web e/ou Ler uma página da web (categoria Conhecimento).
2. Desça até a seção Busca na web. Se nenhuma das duas estiver ligada, um aviso avisa que nada ali terá efeito ainda.
3. Ajuste Profundidade da busca e Resultados por busca.
4. Se quiser restringir, preencha Buscar só nestes domínios e/ou Nunca nestes domínios.
5. Salve.

Para desligar a busca por completo, desabilite as duas ferramentas na grade. As configurações ficam guardadas para quando você voltar a ligá-las.

Configurações & opções

Como as duas listas de domínio se combinam

Elas não funcionam do mesmo jeito, e a diferença é proposital:

• Buscar só nestes domínios é uma restrição. Quando você preenche, a lista do Robô é ignorada — ele não consegue buscar em outro lugar, nem se pedir. Uma restrição que o modelo pode ampliar não é restrição.
• Nunca nestes domínios é uma lista de bloqueio. Os seus domínios valem sempre, e o Robô ainda pode acrescentar outros para uma consulta específica.

Digite os domínios separados por vírgula ou por linha. https://, www. e o caminho depois da barra são removidos automaticamente — a Tavily compara hosts, então https://exemplo.com/precos vira exemplo.com.

O que fica com o Robô (e não com você)

• Quantos resultados pedir naquela consulta: ele pode pedir menos que o seu teto, nunca mais.
• O tema da consulta (geral, notícias ou finanças) e a janela de tempo (último dia, semana, mês ou ano), decididos por pergunta. Hoje esses dois não têm campo fixo por Robô — o padrão é geral, sem recorte de tempo.
• Quais URLs ler no web_fetch — no máximo 5 por chamada.

A chave (Tavily)

A busca precisa de uma chave da Tavily. Ela é procurada nesta ordem:

1. A chave do próprio Robô (seção de chaves de API, provedor tavily).
2. A chave da sua conta, em Integrações.
3. A chave da instalação, configurada pelo operador.

Sem nenhuma delas, as ferramentas respondem que a busca não está configurada e o Robô segue a conversa com o que já sabe — a conversa não quebra.

Casos de uso

• Suporte técnico — consultar a documentação pública de um parceiro antes de orientar o cliente.
• Pré-venda — checar dados públicos da empresa do contato para qualificar melhor.
• Notícias e preços — responder sobre algo que mudou depois do treinamento do modelo.
• Base restrita — preencher Buscar só nestes domínios com o seu site e a sua documentação: o Robô pesquisa apenas ali, como uma busca interna sobre conteúdo público.

Dicas, limites e boas práticas

• Cada busca consome créditos da Tavily. A profundidade avançada e um número alto de resultados multiplicam o consumo — comece em Básica com o padrão de 5.
• Resultado a mais também é contexto a mais no turno: 20 resultados podem empurrar para fora informação da própria conversa.
• O web_fetch lê no máximo 5 páginas por chamada, e o texto de cada página é truncado para caber no turno.
• Uma URL que não pôde ser lida é informada ao Robô, não descartada em silêncio — assim ele não responde como se tivesse conferido.
• A web pública não é fonte de verdade sobre a sua operação. Para preço, política e prazo seus, use a base de conhecimento.
• Combine com Verificação de turno se quiser reter respostas que afirmem algo que o turno não apurou.

Solução de problemas

• "Configurei tudo e o Robô nunca busca" — as ferramentas web_search/web_fetch estão habilitadas na grade? O aviso na seção avisa quando não estão.
• "A busca não está configurada" — não há chave da Tavily em nenhum dos três níveis.
• "A chave da API é inválida" — a chave existe mas foi recusada; gere outra na Tavily.
• "O limite do plano foi atingido" — os créditos da conta Tavily acabaram.
• "A busca está limitada agora" — excesso de chamadas em pouco tempo; ele tenta de novo depois.
• "Ele buscou num site que eu não queria" — acrescente o domínio em Nunca nestes domínios, ou restrinja tudo com Buscar só nestes domínios.
• "Os resultados vêm de outro país/idioma" — deixe a consulta mais específica nas instruções do Robô e restrinja por domínio.

Veja também

• O que é o Maestro IA e o Cérebro da Conta
• Ferramentas do Maestro por módulo
• Base de conhecimento e ontologia
• Verificação do que o Robô afirma