AWS abre a Web Search API para agentes: uma chamada, sem gateway nem chaves

O modelo não sabe o que aconteceu na semana passada. Para que um agente responda sobre lançamentos, preços ou leis recentes, ele precisa de busca. A AWS já tinha essa busca, mas apenas via AgentCore Gateway: você cria um gateway, adiciona um destino de busca na web e chama a ferramenta a partir de um cliente MCP. Para uma equipe de plataforma com regras comuns, isso é adequado. Para um desenvolvedor que só precisa de resultados de busca, é uma camada desnecessária.

Agora a AWS lançou uma Web Search API independente. É a operação InvokeWebSearch no data plane do serviço bedrock-agentcore. Não é preciso criar nada antecipadamente: pegue as credenciais do IAM, faça a chamada e receba os resultados.

Como fica na prática

No Boto3, é um único método, invoke_web_search. Você passa uma string de consulta (até 200 caracteres), o número de resultados de 1 a 25 e filtros. Por exemplo, é possível limitar a busca aos domínios aws.amazon.com e kubernetes.io e pedir páginas publicadas depois de 1º de janeiro de 2026. A resposta é uma lista ranqueada. Cada resultado tem um trecho de texto, enquanto título, URL e data de publicação aparecem se o índice os conhecer. Por isso, é preciso lê-los com get, e não por chave.

A autenticação é feita via SigV4, ou seja, não há chaves de API. Se o código roda em Lambda, ECS, EC2 ou EKS, basta adicionar à role uma permissão: bedrock-agentcore:InvokeWebSearch no recurso gerenciado web-search.v1. É a mesma permissão usada pela service role do gateway, então uma única política cobre os dois caminhos.

Também dá para testar sem código: no CloudShell, basta um comando, aws bedrock-agentcore invoke-web-search. Para Python, é necessário o Boto3 1.43.127 ou mais recente.

Onde isso é útil

A AWS cita vários cenários em que o gateway é excessivo:

• seu próprio loop de agente ou frameworks como LangChain e LlamaIndex;
• tarefas que não são de agentes: dashboards, checagem de fatos, enriquecimento de conteúdo, monitoramento;
• casos em que você quer cuidar por conta própria de retries, cache e tratamento de erros;
• aplicações que já têm sua própria camada de API.

Para o LangChain há um toolkit pronto no langchain-aws 1.9.3 e posteriores. Nele é possível fixar regras que o modelo não pode alterar: domínios excluídos, um limite inferior de data e um orçamento de busca. Isso é útil quando você não quer que o agente amplie por conta própria o escopo da busca. Também há o wrapper WebSearchClient no AgentCore Python SDK 1.26.0.

Segurança e limitações

O principal argumento para equipes corporativas é que as consultas são atendidas por um índice gerenciado pela Amazon e não vão para um buscador de terceiros. O mesmo índice está por trás de Alexa+, Kiro e Quick. O acesso é regulado via IAM e SCP, e as chamadas podem passar pelo PrivateLink sem sair para a internet. Com a condição aws:SourceVpce, é possível permitir a busca apenas a partir da sua VPC.

Há ressalvas:

• O CloudTrail registra as chamadas como data events, mas eles vêm desativados por padrão. É preciso adicionar manualmente um seletor para o recurso AWS::BedrockAgentCore::WebSearch. O texto da consulta e os filtros não aparecem nos logs.
• O limite padrão é de 10 requisições por segundo por região por conta. Para pipelines de grande volume, será preciso pedir aumento.
• Os termos de uso obrigam a guardar e exibir os links das fontes junto com os resultados. Se o seu produto esconde as fontes, isso é um problema.
• Os endpoints de VPC do tipo interface são cobrados pelas tarifas padrão do PrivateLink.
• O índice pertence à Amazon, então vale verificar a cobertura e a atualidade com as suas próprias consultas antes de abandonar Brave, Tavily ou Bing.

O que fazer

Se você já está na AWS e quer adicionar web grounding a um agente, comece pela API direta: leva cinco minutos e não é preciso implantar um gateway. Se você tem muitos agentes e uma política comum de ferramentas, o gateway continua sendo a opção. Para comparar com outras APIs de busca, rode o mesmo conjunto de consultas nas duas e, em produção, ative logo os data events do CloudTrail e restrinja os domínios no toolkit.