Para configurar o Web Answer, adicione-o como target a um AgentCore Gateway existente, conceda as permissões IAM necessárias, aguarde o status READY e então chame a ferramenta por MCP. O passo a passo da AWS usa um Gateway com autenticação IAM na região us-east-1; a orientação técnica da AWS detalha cada etapa.

O que o Web Answer retorna

O Web Answer faz a recuperação e a síntese das informações e devolve uma resposta com citações. Já o Web Search entrega resultados classificados para que o modelo do cliente faça a síntese. A escolha depende do que seu agente precisa receber:

FerramentaResultadoQuem faz a sínteseQuando usar
Web SearchURLs, títulos, trechos e metadados classificadosO modelo do clienteQuando o fluxo precisa trabalhar com resultados brutos
Web AnswerResposta sintetizada com citaçõesA ferramentaQuando o agente precisa receber uma resposta factual citada

Pré-requisitos

A configuração descrita pela AWS exige:

  • Um AgentCore Gateway existente em us-east-1, com autenticação de entrada AWS_IAM.
  • Uma identidade que possa chamar o Gateway e tenha a permissão bedrock-agentcore:InvokeGateway sobre ele.
  • Acesso ao modelo do Amazon Bedrock escolhido para o agente.
  • Python 3.10 ou posterior e os pacotes boto3, strands-agents, mcp e mcp-proxy-for-aws.

IAM é o sistema da AWS para gerenciar identidades e permissões. Aqui, há duas direções de acesso diferentes: a identidade do cliente chama o Gateway; a função de serviço do Gateway chama o Web Answer.

Configure e chame o target

demonstração da AWS: criação do target, consulta no playground e resposta com citações; interface em inglês
  1. Autorize a função de serviço do Gateway. Conceda a ela bedrock-agentcore:InvokeWebAnswer no recurso arn:aws:bedrock-agentcore:us-east-1:aws:tool/web-answer.v1. Essa permissão autoriza a chamada de saída ao Web Answer. A AWS informa que essa função não precisa de bedrock:InvokeModel para o modelo usado pelo agente.
  2. Crie o target do Web Answer. No exemplo da AWS, o connectorId é web-answer e a autenticação de saída é GATEWAY_IAM_ROLE. Assim, o Gateway usa sua própria função de serviço para acessar o conector.
  3. Defina os limites de domínio, se necessário, e aguarde. O administrador pode configurar domínios permitidos ou bloqueados no target. Um filtro passado pelo agente em uma chamada pode restringir esses limites, mas não ampliá-los. Antes de invocar a ferramenta, espere até que get_gateway_target informe READY.
  4. Descubra a ferramenta pelo MCP e faça a chamada. MCP, o Model Context Protocol, permite que um cliente compatível descubra e invoque ferramentas. Use tools/list para encontrar o target e tools/call para chamá-lo. O exemplo da AWS com Strands Agents identifica a ferramenta como web-answer-tool___WebAnswer.
  5. Leia a resposta e as citações. O retorno inclui texto Markdown com citações em linha e dados estruturados em structuredContent.answer, incluindo a resposta e uma lista de citações. A AWS também descreve parâmetros opcionais para filtrar por domínio, intervalo de datas de publicação e país.
Confira o status READY antes da chamada MCP e aplique o filtro de domínio no target quando precisar limitar as fontes que o agente pode solicitar.

Preço, limite regional e remoção dos recursos

A AWS informa o preço de US$ 10 por 1.000 chamadas do Web Answer. O uso do Gateway também é cobrado, mas a AWS não quantifica esse custo junto ao preço da ferramenta. A AWS informa ainda um limite de 10 transações por segundo por conta em us-east-1; é possível solicitar um aumento ao AWS Support.

A AWS informa disponibilidade em US East (N. Virginia), us-east-1, e diz que outras regiões viriam em seguida. Para encerrar o uso, exclua o target do Web Answer. Se o Gateway tiver sido criado apenas para esse fluxo, exclua primeiro seus targets e depois o Gateway, a função de serviço e a política associada. A AWS informa que a remoção desses recursos interrompe as cobranças correspondentes.