View a markdown version of this page

Strumento di ricerca Web - Amazon Bedrock AgentCore

Strumento di ricerca Web

Gli agenti di intelligenza artificiale stanno trasformando il modo in cui le organizzazioni interagiscono con le informazioni, ma devono affrontare un limite fondamentale: le loro conoscenze sono congelate al momento della formazione. Quando un utente chiede informazioni sui prezzi odierni delle azioni o su una versione del software rilasciata un'ora fa, un agente che si affida esclusivamente ai dati di formazione non può fornire risposte accurate.

La creazione di integrazioni di ricerca Web personalizzate per risolvere questo problema è costosa: procurarsi API di ricerca di terze parti, gestire chiavi, quote e limiti di velocità, analizzare formati di risultati non coerenti tra i provider, creare una logica di estrazione degli snippet in modo che i modelli ottengano passaggi pertinenti anziché HTML non elaborato, ragionando su dove viaggiano le richieste dei clienti e su come conservare i dati e mantenere la freschezza e la copertura nel tempo. Ognuno di questi è un progetto a sé stante.

Lo strumento di ricerca Web su Amazon Bedrock AgentCore elimina questa complessità. È una funzionalità di ricerca MCP-compliant web completamente gestita che consente agli agenti di recuperare informazioni dal Web senza sovraccaricare l'infrastruttura. È disponibile come connettore gestito da collegare AgentCore al gateway. Gli agenti lo scoprono con una tools/list chiamata standard e lo richiamano come qualsiasi altro strumento del Model Context Protocol. Non ci sono API di ricerca da fornire, credenziali in uscita da gestire e nessun collante per l'analisi dei risultati da gestire.

Le sezioni seguenti illustrano le funzionalità chiave, l'architettura dell'indice web creato appositamente, le garanzie di privacy, i casi d'uso e come configurare Web Search Tool.

Funzionalità chiave

  • Up-to-date accesso alle informazioni: recupera i risultati web attuali con titoli, URL, frammenti e date di pubblicazione per inserire le risposte degli agenti in informazioni aggiornate.

  • Zero gestione dell'infrastruttura: nessuna API di ricerca di terze parti da fornire o scalare per configurare. Il Gateway espone automaticamente la ricerca sul Web come strumento MCP standard.

  • Indipendente dal framework: funziona con Strands Agents,, LangChain LangGraph, CrewAI o qualsiasi MCP-compatible client tramite lo standard Model Context Protocol.

  • Purpose-built indice web: supportato da un indice Amazon-operated web che comprende decine di miliardi di documenti.

  • Knowledge Graph per dati altamente attendibili: consente alle entità e alle loro relazioni di fornire risposte concrete anziché lasciare che sia il modello a dedurle dal testo estratto dalla pagina.

  • Estrazione di frammenti semantici: estrae i passaggi semanticamente rilevanti da ogni pagina Web, ottimizzati per la finestra contestuale di un modello, anziché restituire HTML grezzo o pagine complete.

Purpose-built indice web

Molte soluzioni che aggiungono la ricerca sul Web a un agente si basano su un motore di ricerca di terze parti. Lo strumento di ricerca Web su Amazon Bedrock AgentCore è diverso: è supportato da un indice web che Amazon crea e gestisce direttamente.

Ampia copertura

L'indice comprende decine di miliardi di documenti. Questa scala è importante ai fini della copertura: è possibile rispondere in modo più efficace a domande a lungo termine sulle librerie di nicchia o sulle specifiche oscure dei prodotti quando l'indice è ampio anziché limitato alle pagine più popolari.

Aggiornato continuamente

Amazon aggiorna l'indice su base continuativa, riflettendo contenuti nuovi e modificati in pochi minuti. Per gli agenti che rispondono a domande sui movimenti dei prezzi o ad annunci appena pubblicati, questa finestra di aggiornamento fa la differenza tra una risposta fondata e una sicuramente sbagliata. Quando il tuo agente cerca «cosa è successo oggi», i risultati riflettono ciò che è realmente accaduto oggi.

Grafico della conoscenza per fatti ad alta confidenza

Web Search Tool include un Knowledge Graph integrato che fonda le entità e le loro relazioni. Per domande concrete, ad esempio chi ricopre un ruolo o quando è stata fondata qualcosa, il knowledge graph fornisce risposte estremamente affidabili anziché lasciare che il modello le deduca dal testo estratto dalla pagina. Ciò riduce il tipo di sottile deriva fattuale che può verificarsi quando un agente ricrea una risposta a partire dai soli frammenti.

Estrazione semantica di frammenti ottimizzata per il contesto del modello

Anziché consegnare al modello un dump HTML non elaborato o una pagina intera, lo strumento esegue l'estrazione di frammenti semanticamente rilevanti. Estrae i passaggi da ogni pagina Web che effettivamente riguardano la query e li restituisce in una forma ottimizzata per la finestra contestuale di un modello. Il risultato è un contesto più denso e pertinente per token: il modello vede le parti che contano e spende meno token su boilerplate e navigation chrome, il che aiuta a migliorare la precisione delle risposte citate.

Privato fin dalla progettazione

Per molte aziende, la domanda che blocca l'implementazione della ricerca sul Web non è «funziona», ma «dove vanno a finire le domande dei miei utenti e cosa succede loro?» Web Search Tool è progettato in modo che tali risposte siano semplici.

Le domande non se ne vanno mai AWS

Quando il tuo agente effettua una ricerca, la query viene fornita interamente all'interno AWS dell'infrastruttura. Le richieste dei clienti non vengono inviate a un motore di ricerca di terze parti o indirizzate all'esterno. AWS Il Gateway si autentica sul connettore di AWS proprietà e indirizza la richiesta internamente, in modo che il percorso dei dati rimanga interno da un capo all'altro. AWS Per i team con problemi di uscita dei dati, ciò rimuove un'intera categoria di revisione.

Come funziona

Il Web Search Tool è un connettore integrato. Il Gateway gestisce la gestione degli schemi, la governance dei parametri, la risoluzione degli endpoint e l'autenticazione dei servizi.

  1. Configurazione del gateway: crea un gateway e aggiungi un obiettivo del Web Search Tool utilizzandoconnectorId: "web-search". Il Gateway crea un'istantanea dello schema dello strumento e fornisce l'integrazione.

  2. Individuazione degli strumenti: l'agente chiama tools/list l'endpoint Gateway e scopre WebSearch lo strumento con il relativo schema di input.

  3. Richiamo di ricerca: l'agente chiama tools/call con una query in linguaggio naturale (fino a 200 caratteri). Il Gateway si autentica nel backend e indirizza la richiesta internamente all'interno. AWS

  4. Risultati strutturati: lo strumento restituisce risultati con frammenti di testo, URL, titoli e date di pubblicazione semanticamente rilevanti sia in formato di testo che in formato JSON strutturato.

  5. Risposta fondata: il tuo agente utilizza i risultati per comporre una risposta con fonti citate.

Casi d’uso

  • Up-to-date ricerca: rispondi a domande su eventi attuali, prezzi delle azioni o annunci recenti effettuando ricerche sul Web e sintetizzando i risultati con citazioni di fonti.

  • Fact-checking— Verifica le affermazioni nei documenti cercando le fonti primarie e confermando o correggendo i dati utilizzando risposte fattuali supportate da Knowledge Graph.

  • Informazioni sulla concorrenza: monitora gli annunci dei concorrenti, i lanci di prodotti o le variazioni dei prezzi da fonti web pubbliche.

  • Eliminazione delle conoscenze obsolete: consenti agli agenti di accedere alle informazioni pubblicate dopo l'interruzione del corso di formazione, come nuove versioni di software, modifiche alle politiche o sviluppi più recenti.

Configura lo strumento di ricerca Web

Per istruzioni su come creare un Gateway Target con la configurazione del connettore Web Search Tool, inclusi esempi di configurazione utilizzando Python SDK e CLI, consulta Configurare lo strumento di ricerca Web nella guida alla configurazione di Target.

Utilizzare con un'imbracatura

Per AgentCore sfruttare la funzionalità di ricerca Web, collegate il gateway creato in Configurazione dello strumento di ricerca Web all'harness come strumento. agentcore_gateway Il ruolo di esecuzione del cablaggio richiede l'bedrock-agentcore:InvokeGatewayautorizzazione sull'ARN del gateway. Per una procedura dettagliata dall'inizio alla fine, consultate Tools nella documentazione del cablaggio.

Configura il filtraggio dei domini

È possibile limitare i domini su cui il Web Search Tool può interrogare configurando una denylist di domini. Per esempi e dettagli di configurazione, consulta Configura il filtraggio dei domini nella guida alla configurazione di Target.

Configurare il ruolo del servizio Gateway

Il Gateway necessita di un ruolo di servizio che consenta al AgentCore servizio di eseguire azioni per conto dell'utente. Per le autorizzazioni IAM richieste e la configurazione delle policy, consulta Configurare il ruolo del servizio Gateway nella guida alla configurazione di Target.

Schema di input

Il Web Search Tool accetta il seguente schema di input quando viene richiamato tramitetools/call:

{ "inputSchema": { "type": "object", "properties": { "query": { "description": "The search query string", "type": "string" }, "maxResults": { "description": "Maximum number of results to return. Valid range: 1-25. Defaults to 10.", "type": "integer" } }, "required": ["query"] } }
Campo Tipo Campo obbligatorio Descrizione

query

stringa

Stringa della query di ricerca. Deve contenere 200 caratteri o meno.

maxResults

numero intero

No

Numero massimo di risultati da restituire. Intervallo valido: 1-25. Il valore predefinito è 10.

Formato della risposta

Lo strumento di ricerca Web restituisce i risultati nel seguente MCP-compliant formato:

{ "isError": false, "content": [ { "type": "text", "text": "{\"id\":\"824f89d0\",\"results\":[{\"text\":\"Python 3.13 was released on October 7, 2024, featuring improvements to the interactive interpreter, experimental free-threaded mode, and a preliminary JIT compiler...\",\"publishedDate\":\"2024-10-07\",\"url\":\"https://example.com/python/releases/3.13\",\"title\":\"Python 3.13 Release Highlights\"}]}" } ] }
Campo Tipo Campo obbligatorio Descrizione

text

stringa

Contenuto testuale o frammento del risultato della ricerca

url

stringa

No

URL della pagina web di origine

title

stringa

No

Titolo della pagina web di origine

publishedDate

stringa

No

Data di pubblicazione del risultato

Disponibilità

Il connettore Web Search Tool è disponibile nella us-east-1 regione Stati Uniti orientali (Virginia settentrionale).

Poiché Amazon gestisce l'intero stack di ricerca, i miglioramenti in termini di freschezza, copertura, pertinenza e qualità degli snippet arrivano automaticamente ai tuoi agenti attraverso lo stesso connettore gestito. Non sono necessari aggiornamenti o migrazioni di versione da parte tua.

Uso accettabile

Se si utilizza lo Strumento di ricerca Web, l'utente è responsabile dell'utilizzo e di qualsiasi utilizzo da parte degli utenti finali dei contenuti recuperati dallo Strumento di ricerca Web («Risultati della ricerca»). È necessario conservare e visualizzare le citazioni di origine e i collegamenti forniti con ciascun risultato di ricerca in qualsiasi output che viene fornito agli utenti finali che utilizzano il risultato della ricerca. Non è possibile utilizzare Web Search Tool per (a) estrarre, archiviare o riprodurre in blocco contenuti dai risultati di ricerca o (b) creare o popolare un indice o un database concorrente.