# Dê busca na web a todos os modelos — sem montar RAG

> Injeção de busca na camada do gateway: blocos de busca nativos por protocolo (Anthropic / OpenAI / Responses), modelos abertos ganham fundamentação por busca; alternância tripla, degradação suave, excluída da cobrança.

Canônico: https://www.gatellm.io/pt-BR/use-cases/web-search-grounding/

Injeção de busca na camada do gateway: blocos de busca nativos sintetizados por protocolo de cliente, para que modelos abertos também ganhem fundamentação por busca. Degradação suave, e a busca interceptada não é cobrada.

## Do que a comunidade realmente reclama
Modelos abertos / auto-hospedados não têm busca, então qualquer coisa sensível ao tempo os expõe; montar uma pilha de RAG só para isso é pesado demais. As APIs de busca dos fornecedores têm cada uma seu próprio formato e preço por chamada, então cada troca de modelo significa reintegrar.
"O gateway consegue simplesmente adicionar busca para todos os modelos" é um pedido recorrente de integradores.

## Como o GateLLM faz isso
O GateLLM intercepta a busca na camada do gateway: configure um mecanismo de busca (serper, testável no próprio console), então uma alternância tripla por modelo (seguir a declaração de capacidade / forçar ligado / forçar desligado) decide quais modelos recebem busca. Em um acerto, o gateway recupera primeiro, injeta os resultados na mensagem do usuário como material de referência e só então chama o modelo upstream — o texto do fornecedor nunca é retornado diretamente.
O conteúdo injetado é sintetizado em blocos de busca nativos por protocolo de cliente (server_tool_use do Anthropic / url_citation do OpenAI / web_search_call do Responses), para que os clientes renderizem citações no formato nativo de cada SDK.
Falhas de busca degradam suavemente sem bloquear a requisição, e a busca interceptada é excluída da cobrança de uso.

## 5 alavancas que realmente funcionam
- Gestão de mecanismos: chave de API do serper + teste no console + prioridade entre vários mecanismos
- Alternância tripla por modelo: seguir a capacidade / forçar ligado / forçar desligado, precedência modelo > upstream > declaração de capacidade
- Blocos de busca nativos por protocolo: Anthropic / OpenAI / Responses renderizam cada um seu próprio formato de citação
- Degradação segura: falha de busca nunca bloqueia a requisição; os motivos de degradação chegam à área de avisos de detalhe do log
- Cobrança transparente: busca interceptada excluída da cobrança de uso; o uso de memória tem uma fórmula de teto documentada

## FAQ
### Como os resultados de busca injetados aparecem para o cliente?
Blocos de busca nativos por protocolo: server_tool_use para Anthropic, url_citation para OpenAI Chat, web_search_call para Responses — os SDKs renderizam citações nativas sem alteração de código.

### Se a busca cair, a conversa quebra?
Não. A busca falha de forma suave em todos os casos: a injeção é pulada e a chamada upstream prossegue; o motivo da degradação é registrado na área de avisos de detalhe do log para observabilidade.

- [Guia completo: Busca na web (docs)](https://docs.gatellm.io/en/console/search)

## Relacionados
- [Início](https://www.gatellm.io/pt-BR/index.md)
- [Preços](https://www.gatellm.io/pt-BR/pricing.md)
- [Calculadora de custos](https://www.gatellm.io/pt-BR/calculator.md)
- [Sobre](https://www.gatellm.io/pt-BR/about.md)
- [Agendar uma demonstração](https://www.gatellm.io/pt-BR/demo.md)
- [FAQ](https://www.gatellm.io/pt-BR/faq.md)
- [Comparar gateways de IA](https://www.gatellm.io/pt-BR/compare.md)
- [Comparar LiteLLM](https://www.gatellm.io/pt-BR/compare/litellm.md)
- [Comparar OpenRouter](https://www.gatellm.io/pt-BR/compare/openrouter.md)
- [Comparar Alibaba Cloud AI Gateway](https://www.gatellm.io/pt-BR/compare/alibaba-cloud.md)
- [Comparar Azure API Management](https://www.gatellm.io/pt-BR/compare/azure-apim.md)
- [Comparar Apigee](https://www.gatellm.io/pt-BR/compare/apigee.md)
- [Comparar Cloudflare AI Gateway](https://www.gatellm.io/pt-BR/compare/cloudflare.md)
- [Comparar Kong AI Gateway](https://www.gatellm.io/pt-BR/compare/kong.md)
- [Comparar Portkey](https://www.gatellm.io/pt-BR/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway](https://www.gatellm.io/pt-BR/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter](https://www.gatellm.io/pt-BR/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey](https://www.gatellm.io/pt-BR/compare/litellm-vs-portkey.md)
- [Casos de uso](https://www.gatellm.io/pt-BR/use-cases.md)
- [Reduzir custo de LLM](https://www.gatellm.io/pt-BR/use-cases/reduce-cost.md)
- [Alta disponibilidade](https://www.gatellm.io/pt-BR/use-cases/high-availability.md)
- [Isolamento multilocatário](https://www.gatellm.io/pt-BR/use-cases/multi-tenant.md)
- [Conformidade e auditoria](https://www.gatellm.io/pt-BR/use-cases/compliance-audit.md)
- [Solução de problemas por sintoma](https://www.gatellm.io/pt-BR/use-cases/troubleshooting.md)
- [Stack de modelos multivendor](https://www.gatellm.io/pt-BR/use-cases/mixed-model-stack.md)
- [IA auto-hospedada dentro do Office](https://www.gatellm.io/pt-BR/use-cases/self-hosted-office-ai.md)
- [Visibilidade e atribuição do uso de tokens](https://www.gatellm.io/pt-BR/use-cases/token-ops.md)
- [Token FinOps: alocação e controle de custos de IA](https://www.gatellm.io/pt-BR/use-cases/token-finops.md)
- [Governança de ferramentas MCP](https://www.gatellm.io/pt-BR/use-cases/mcp-tool-governance.md)
- [Rotação e standby de múltiplas chaves](https://www.gatellm.io/pt-BR/use-cases/multi-key-pooling.md)
- [Controle de admissão de clientes](https://www.gatellm.io/pt-BR/use-cases/client-admission-control.md)
- [Aplicar política de uso de modelos](https://www.gatellm.io/pt-BR/use-cases/enforce-model-policy.md)
- [Sem escolha de modelo no cliente](https://www.gatellm.io/pt-BR/use-cases/automatic-model-tiering.md)
- [Um protocolo, qualquer modelo](https://www.gatellm.io/pt-BR/use-cases/one-protocol-any-model.md)
- [Suplemento Office / Microsoft 365](https://www.gatellm.io/pt-BR/office-addin.md)
- [Glossário](https://www.gatellm.io/pt-BR/glossary.md)
- [Catálogo de modelos](https://www.gatellm.io/pt-BR/models.md)
- [Integrações de SDK e frameworks](https://www.gatellm.io/pt-BR/integrations.md)
- [Agentes de código de IA e harnesses](https://www.gatellm.io/pt-BR/coding-agents.md)
- [Segurança e conformidade](https://www.gatellm.io/pt-BR/security.md)
