## 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.

| Ferramenta | O que faz |
|---|---|
| **`web_search`** | Pesquisa na web e devolve resultados ranqueados com **título, URL e um trecho** de cada página. |
| **`web_fetch`** | Lê o **texto completo** de páginas específicas por URL — depois de uma busca, quando o trecho não basta, ou quando o Robô já tem a URL. |

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

| Opção | O que faz | Padrão |
|---|---|---|
| **Profundidade da busca** | **Básica** ou **Avançada**. A avançada lê mais de cada página e acerta mais, mas **consome mais créditos** por chamada. Vale também para o `web_fetch` ao ler uma página. | Básica |
| **Resultados por busca** | Teto de **1 a 20**. Vazio = o padrão da ferramenta (**5**). | Vazio (5) |
| **Buscar só nestes domínios** | Restringe a busca a esses domínios. Vazio = a web inteira. | Vazio |
| **Nunca nestes domínios** | Bloqueia esses domínios sempre. | Vazio |

### 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](/hc/ajuda/articles/maestro-brain-overview-pt-br)
- [Ferramentas do Maestro por módulo](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-pt-br)
- [Base de conhecimento e ontologia](/hc/ajuda/articles/maestro-brain-base-de-conhecimento-e-ontologia-pt-br)
- [Verificação do que o Robô afirma](/hc/ajuda/articles/maestro-brain-verificacao-do-que-o-robo-afirma-pt-br)