A Amazon Bedrock AgentCore Web Search API ficou disponível de forma geral em 10 de novembro de 2026. A operação InvokeWebSearch permite que aplicações, pipelines e loops de agentes consultem o índice web operado pela AWS sem criar um gateway, retornando resultados ranqueados com trecho, URL, título e, quando disponível, data de publicação. A integração simplifica pesquisa atual, mas não transforma resultados em fatos: a empresa ainda precisa definir fontes, permissões, orçamento, cache, citações e revisão antes de usar a resposta em decisões ou conteúdo.
Entenda quando usar a API direta
A API direta atende aplicações que já têm orquestração própria, pipelines de monitoramento, checagem de alegações e agentes que precisam de informação recente. Ela evita criar recursos de gateway quando o código só precisa pesquisar e tratar resultados. A chamada usa SDK ou CLI da AWS e autenticação pelo IAM.
O AgentCore Gateway continua indicado quando a organização quer reunir pesquisa e outras ferramentas em um endpoint MCP com autenticação e seleção de ferramentas centralizadas. A escolha não deve ser feita apenas pela quantidade de etapas iniciais: considere governança, compartilhamento, observabilidade e manutenção do conjunto de agentes.
Defina uma política de fontes e recência
A API aceita filtros de domínio e intervalo de publicação. Use essas regras para priorizar documentação, órgãos públicos, páginas oficiais, publicações científicas ou fornecedores autorizados conforme o caso. Uma lista de domínios confiáveis para preço não é necessariamente adequada para saúde, legislação ou segurança.
Datas ausentes ou incorretas exigem cautela. O resultado pode trazer a data de publicação quando disponível, mas a aplicação deve diferenciar data do fato, data da página e data de coleta. Para conteúdo volátil, exija confirmação em mais de uma fonte ou na fonte primária antes de produzir uma conclusão.
- Domínios permitidos e bloqueados por caso de uso
- Janela máxima de recência
- Quantidade mínima de fontes independentes
- Campos obrigatórios de URL, título e data
- Situações que exigem revisão humana
Aplique menor privilégio no IAM
A identidade que chama a API precisa da ação bedrock-agentcore:InvokeWebSearch no recurso gerenciado de pesquisa web. Crie uma função específica para o serviço, evite chaves estáticas e separe ambientes de desenvolvimento e produção. Registre alterações de política e restrinja quem pode ampliar a permissão.
A AWS informa suporte a PrivateLink e registro de chamadas como eventos de dados do CloudTrail. Esses controles ajudam a manter o tráfego e a auditoria no ambiente corporativo, mas não substituem proteção dos termos pesquisados. Consultas podem revelar clientes, incidentes, produtos ou estratégias; remova dados pessoais e segredos antes da busca.
Controle custo, volume e cache
O preço anunciado é de 7 dólares por mil consultas, sem cobrança de gateway na API direta. O custo unitário parece baixo, mas agentes podem repetir perguntas, abrir muitas ramificações ou pesquisar a cada etapa. Defina limite por tarefa, usuário e período antes de liberar execução autônoma.
Use cache com prazo compatível com a volatilidade. Uma consulta sobre documentação estável pode ser reaproveitada por mais tempo; preço, disponibilidade, norma e notícia exigem validade curta. Registre acertos de cache, pesquisas evitadas, latência e custo por resposta útil. Não reutilize resultado antigo sem mostrar a data da coleta.
Trate o resultado como evidência, não como resposta final
O trecho retornado serve para seleção e contexto, mas pode omitir ressalvas, tabela, atualização ou condição importante da página. Abra a fonte quando a afirmação sustentar uma decisão, uma recomendação ou um número. Verifique se o conteúdo realmente apoia a frase e não apenas contém palavras parecidas.
Faça o agente devolver URL e data junto da alegação. Bloqueie publicação quando uma fonte estiver inacessível, contradizer outra ou não tiver relação direta com a conclusão. Para temas de alto impacto, a revisão deve confirmar o documento original, a versão e a jurisdição aplicável.
Impeça que páginas controlem o agente
Conteúdo web pode conter instruções maliciosas direcionadas a modelos. Separe texto recuperado de instruções do sistema, trate a página como dado não confiável e não permita que um trecho autorize ferramentas, credenciais ou ações. O agente de pesquisa deve ter menos permissões que o agente de execução.
Valide URLs, limite tamanho, normalize conteúdo e descarte scripts ou campos desnecessários. Teste páginas que tentam mandar o agente ignorar regras, revelar segredos ou acessar outros sistemas. Uma citação correta não torna segura uma cadeia de execução com autonomia excessiva.
Crie um piloto mensurável
Comece com um caso de baixo risco, como monitorar notas de versão em domínios oficiais ou montar um resumo interno que sempre passe por revisão. Compare com o processo atual em cobertura, precisão das citações, tempo, custo e correções necessárias.
Avalie falsos positivos, fontes fracas, datas ausentes e alegações não sustentadas. Só amplie para clientes ou decisões quando a equipe consegue explicar como cada afirmação foi obtida, interromper a execução e reproduzir a pesquisa. Informação recente é útil apenas quando permanece rastreável.
Para levar daqui
A Web Search API reduz a infraestrutura para dar informação atual a agentes, mas a qualidade depende de uma política explícita de fontes, IAM mínimo, orçamento, cache, proteção contra instruções maliciosas e citações verificadas.
