Web Answer instellen in Amazon Bedrock AgentCore

Voeg Web Answer toe als target aan een bestaande AgentCore Gateway, geef de aanroeper en de Gateway-servicerol elk hun eigen IAM-recht en wacht tot het target READY is. Daarna kan een MCP-client de tool aanroepen. AWS beschrijft deze configuratie voor us-east-1 in zijn handleiding voor Web Answer op Amazon Bedrock AgentCore.

Controleer vóór de eerste aanroep twee aparte rechten: wie de Gateway mag aanroepen en welke tool de Gateway-servicerol mag gebruiken.

Web Answer of Web Search?

AWS beschrijft Web Answer als een tool die webinformatie ophaalt, samenvoegt en met citaties teruggeeft. Web Search levert gerangschikte resultaten aan, waarna het model van de klant zelf de informatie verwerkt. Kies op basis van wat je agent nodig heeft:

Vereisten voor de configuratie

AWS' walkthrough gebruikt een bestaande AgentCore Gateway in us-east-1 met IAM als inkomende authenticatie (AWS_IAM). Zorg daarnaast voor:

• Een aanroepende identiteit met bedrock-agentcore:InvokeGateway op de Gateway.
• Toegang tot het Bedrock-model dat de agent gebruikt.
• Python 3.10 of hoger en de pakketten boto3, strands-agents, mcp en mcp-proxy-for-aws.

IAM is het AWS-systeem voor identiteiten en toegangsrechten. De Gateway controleert daarmee wie haar mag aanroepen; een afzonderlijk recht bepaalt welke tool de Gateway zelf mag gebruiken.

Web Answer instellen

1. Controleer het recht van de aanroeper. Geef de identiteit die de Gateway aanroept bedrock-agentcore:InvokeGateway op die Gateway. Dit recht staat toegang tot de Gateway toe.
2. Geef de Gateway-servicerol toegang tot Web Answer. Voeg aan de servicerol een inline beleid toe met bedrock-agentcore:InvokeWebAnswer op arn:aws:bedrock-agentcore:us-east-1:aws:tool/web-answer.v1. Dit is het uitgaande recht van de Gateway en vervangt het recht van de aanroeper niet. AWS zegt dat deze servicerol geen bedrock:InvokeModel nodig heeft voor het model van de agent.
3. Maak het connector-target aan. Gebruik connectorId met de waarde web-answer en GATEWAY_IAM_ROLE als uitgaande authenticatie. Daarmee gebruikt de Gateway haar servicerol voor de verbinding; AWS' procedure maakt hiervoor geen aparte connectorgegevens aan.
4. Stel zo nodig domeingrenzen in. Een Gateway-beheerder kan op targetniveau toegestane of uitgesloten domeinen instellen. Een filter voor een afzonderlijke aanroep kan die grenzen verder beperken, maar niet verruimen. AWS noemt ook een datumbereik voor publicaties en landlokalisatie als optionele instellingen.
5. Wacht tot het target gereed is. Controleer met get_gateway_target of de status READY is voordat je de tool aanroept.

Roep de tool aan via MCP

MCP, het Model Context Protocol, laat een compatibele client tools ontdekken en aanroepen. Verbind de agent met de Gateway en gebruik tools/list om de beschikbare tool te vinden; voer de aanroep uit met tools/call. AWS gebruikt Strands Agents als voorbeeld en noemt de tool web-answer-tool___WebAnswer.

De respons bevat Markdown-tekst met citaties in de tekst. De gestructureerde respons staat onder structuredContent.answer en bevat ook een citatielijst. Verwerk dus zowel het antwoord als de bijbehorende citaties in de applicatie die de respons gebruikt.

Prijs, limiet en opruimen

AWS noemt een prijs van US$ 10 per 1.000 Web Answer-toolaanroepen. Het gebruik van AgentCore Gateway wordt daarnaast gefactureerd; AWS geeft daarvoor in dezelfde prijsvermelding geen totaalbedrag. AWS noemt voor us-east-1 een limiet van 10 transacties per seconde per account. Een verhoging kan bij AWS Support worden aangevraagd.

Verwijder het Web Answer-target wanneer je het niet meer nodig hebt. Verwijder je een Gateway die alleen voor de walkthrough is gemaakt, verwijder dan eerst de targets en daarna de Gateway, de servicerol en het beleid. AWS vermeldt dat het verwijderen van deze resources verdere kosten voor die resources stopt.