Per configurare Web Answer, aggiungilo come target a un AgentCore Gateway esistente, autorizza il ruolo di servizio, attendi che il target risulti READY e poi chiamalo tramite MCP. La procedura AWS usa un Gateway in us-east-1 con autenticazione IAM (AWS_IAM): servono autorizzazioni distinte per chi chiama il Gateway e per il ruolo con cui il Gateway invoca Web Answer. La guida AWS descrive i passaggi e i requisiti.

Tieni separati i due permessi: InvokeGateway autorizza chi entra nel Gateway; InvokeWebAnswer consente al ruolo del Gateway di chiamare lo strumento.

Cosa restituisce Web Answer

Scegli Web Answer quando vuoi che l’agente riceva una risposta sintetizzata e corredata di citazioni; scegli Web Search se preferisci elaborare tu i risultati grezzi. AWS descrive così la differenza tra i due strumenti:

StrumentoRisultatoChi sintetizzaAttività adatta
Web SearchURL, titoli, estratti e metadati ordinatiIl modello del clienteElaborare direttamente i risultati della ricerca
Web AnswerUna risposta sintetizzata con attribuzioni e citazioniWeb AnswerOttenere una risposta citata come parte del compito dell’agente

AWS dichiara che Web Answer usa un indice web e un grafo di conoscenza gestiti da Amazon. La risposta che restituisce include citazioni, ma il formato, da solo, non sostituisce i controlli che il tuo sistema applica ai contenuti.

Prerequisiti per la configurazione

Prima di creare il target, prepara:

  • Un account AWS e un AgentCore Gateway esistente in us-east-1, configurato con autenticazione IAM in entrata (AWS_IAM).
  • Un’identità chiamante autorizzata con bedrock-agentcore:InvokeGateway sul Gateway.
  • Accesso al modello Amazon Bedrock scelto per l’agente.
  • Python 3.10 o successivo e i pacchetti boto3, strands-agents, mcp e mcp-proxy-for-aws.

Autorizza il ruolo di servizio del Gateway

  1. Concedi al ruolo del Gateway il permesso di invocare Web Answer. Aggiungi una policy che autorizzi bedrock-agentcore:InvokeWebAnswer sulla risorsa arn:aws:bedrock-agentcore:us-east-1:aws:tool/web-answer.v1. È il permesso in uscita usato dal Gateway per chiamare lo strumento, distinto dall’autorizzazione bedrock-agentcore:InvokeGateway assegnata all’identità chiamante. AWS specifica che questo ruolo non richiede bedrock:InvokeModel per il modello dell’agente.

Aggiungi il target e attendi READY

La dimostrazione di AWS, con interfaccia in inglese, mostra l’aggiunta del target, una query nel playground e una risposta accompagnata da citazioni.
  1. Crea il target Web Answer. Nell’esempio AWS, il client bedrock-agentcore-control opera in us-east-1, usa connectorId con valore web-answer e imposta GATEWAY_IAM_ROLE per l’autenticazione in uscita. Il Gateway usa così il proprio ruolo di servizio, senza credenziali separate per il connettore.
  2. Imposta eventuali limiti di dominio. L’amministratore del Gateway può definire domini inclusi o esclusi per il target. Un agente può restringere ulteriormente il filtro nella singola chiamata, ma non può ampliare i limiti fissati dall’amministratore.
  3. Controlla lo stato del target. Interroga get_gateway_target e aspetta che restituisca READY prima di invocare Web Answer.

Chiama Web Answer tramite MCP e leggi le citazioni

  1. Collega un client compatibile con MCP. Il Model Context Protocol permette al client di individuare e chiamare gli strumenti esposti dal Gateway. Nell’esempio AWS il client è Strands Agents.
  2. Individua lo strumento. Usa tools/list per elencare i tool disponibili. Nell’esempio AWS, il nome del tool è web-answer-tool___WebAnswer.
  3. Invia la richiesta. Chiama il tool con tools/call. AWS indica anche filtri facoltativi per dominio, intervallo di date di pubblicazione e paese. Il filtro di dominio della chiamata resta vincolato ai limiti del target.
  4. Leggi sia la risposta sia le citazioni. Web Answer restituisce testo Markdown con marcatori di citazione in linea e dati strutturati in structuredContent.answer, che contiene la risposta e l’elenco delle citazioni.

Costi, limite di chiamate e rimozione delle risorse

AWS indica un prezzo di 10 USD ogni 1.000 chiamate Web Answer. La pagina prezzi di Amazon Bedrock AgentCore elenca anche le invocazioni API di Gateway a 0,005 USD ogni 1.000 invocazioni; Search API e indicizzazione degli strumenti hanno voci distinte. Il totale dipende quindi dalle operazioni Gateway effettivamente usate.

Per us-east-1, AWS dichiara un limite di 10 transazioni al secondo per account; per chiederne un aumento, indica di contattare AWS Support.

  1. Elimina le risorse quando hai finito. Rimuovi il target Web Answer. Se hai creato il Gateway soltanto per questa configurazione, elimina prima i suoi target e poi il Gateway, il ruolo di servizio e la policy. AWS afferma che la rimozione delle risorse interrompe gli addebiti associati.