

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Strumento di ricerca Web
<a name="gateway-target-connector-web-search-tool"></a>

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.

**Topics**
+ [Funzionalità chiave](#gateway-target-connector-web-search-tool-key-capabilities)
+ [Purpose-built indice web](#gateway-target-connector-web-search-tool-web-index)
+ [Privato fin dalla progettazione](#gateway-target-connector-web-search-tool-privacy)
+ [Come funziona](#gateway-target-connector-web-search-tool-how-it-works)
+ [Casi d’uso](#gateway-target-connector-web-search-tool-use-cases)
+ [Configura lo strumento di ricerca Web](#gateway-target-connector-web-search-tool-setup)
+ [Da utilizzare con un'imbracatura](#gateway-target-connector-web-search-tool-harness)
+ [Configura il filtraggio dei domini](#gateway-target-connector-web-search-tool-domain-filtering)
+ [Configurare il ruolo del servizio Gateway](#gateway-target-connector-web-search-tool-service-role)
+ [Schema di input](#gateway-target-connector-web-search-tool-input-schema)
+ [Formato della risposta](#gateway-target-connector-web-search-tool-response-format)
+ [Disponibilità](#gateway-target-connector-web-search-tool-availability)
+ [Uso accettabile](#gateway-target-connector-web-search-tool-acceptable-use)

## Funzionalità chiave
<a name="gateway-target-connector-web-search-tool-key-capabilities"></a>
+  **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.
+  **Filtraggio per dominio e data: limita le** ricerche con un elenco di esclusioni di domini a livello di destinazione. Nella versione Connector `1.2.0` e successive, le destinazioni supportano anche un elenco di inclusione del dominio e gli agenti possono passare elenchi di inclusione ed esclusione del dominio per richiesta e limiti di data di pubblicazione.
+  **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
<a name="gateway-target-connector-web-search-tool-web-index"></a>

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
<a name="gateway-target-connector-web-search-tool-privacy"></a>

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
<a name="gateway-target-connector-web-search-tool-how-it-works"></a>

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 utilizzando`connectorId: "web-search"`. Il Gateway crea un'istantanea dello schema dello strumento e fornisce l'integrazione.

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

1.  **Richiamata di ricerca: l'**agente chiama `tools/call` con una query in linguaggio naturale (fino a 200 caratteri) e, nella versione del connettore e successive, filtri opzionali a livello di richiesta per domini `1.2.0` e date di pubblicazione. Il Gateway si autentica nel backend e indirizza la richiesta internamente all'interno. AWS

1.  **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.

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

## Casi d’uso
<a name="gateway-target-connector-web-search-tool-use-cases"></a>
+  **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**: offrite agli agenti l'accesso alle informazioni pubblicate dopo l'interruzione del corso di formazione, ad esempio nuove versioni di software, modifiche alle politiche o sviluppi più recenti.

## Configura lo strumento di ricerca Web
<a name="gateway-target-connector-web-search-tool-setup"></a>

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](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-web-search-setup) nella guida alla configurazione di Target.

## Da utilizzare con un'imbracatura
<a name="gateway-target-connector-web-search-tool-harness"></a>

Per [AgentCore sfruttare la](harness.md) 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:InvokeGateway`autorizzazione sull'ARN del gateway. [Per una procedura dettagliata dall'inizio alla fine, consultate Tools nella documentazione del cablaggio.](harness-tools.md)

## Configura il filtraggio dei domini
<a name="gateway-target-connector-web-search-tool-domain-filtering"></a>

Web Search Tool supporta 2 livelli di filtraggio che si compongono in base a ogni richiesta:
+  **Target-level elenco di esclusione dei domini e elenco di inclusione.** Durante la configurazione della destinazione, l'amministratore configura gli elenchi di domini che la destinazione esclude o a cui limita ogni ricerca. Entrambi gli elenchi sono nascosti all'agente chiamante e applicati a ogni richiesta che attraversa la destinazione.
+  **Request-level filtri (versione del connettore `1.2.0` e successive).** L'agente chiamante può passare un `filters` oggetto opzionale ad ogni `tools/call` richiesta:
  +  `domainFilter`— `include` ed `exclude` elenchi, fino a 100 domini per elenco. Web Search Tool restituisce i risultati solo dai domini presenti nell'`include`elenco e elimina tutti i risultati il cui dominio appare nell'`exclude`elenco.
  +  `publishedDateFilter`— `from` e `to` limiti, UTC inclusi. ISO-8601 Web Search Tool restituisce solo i risultati con una data di pubblicazione corrispondente o compresa tra le date `from` e`to`.

Request-level i filtri si compongono con l'elenco di esclusione e l'elenco di inclusione a livello di destinazione:
+ Un dominio viene eliminato dai risultati se appare nell'elenco di esclusione a livello di destinazione o nell'elenco di esclusione a livello di richiesta.
+ Un dominio viene restituito solo se compare in ogni elenco di inclusione impostato. Se è impostato solo l'elenco di inclusione a livello di destinazione o solo l'elenco di inclusione a livello di richiesta, tale elenco viene rispettato. Se entrambi sono impostati, vengono restituiti solo i domini presenti in entrambi. Se i due non condividono alcun dominio, non viene restituito alcun risultato.

Request-level i filtri non possono sovrascrivere l'elenco di esclusione a livello di destinazione o espandere i risultati oltre l'elenco di inclusione a livello di destinazione.

Per esempi e dettagli sulla configurazione, consulta [Configurare il filtraggio del dominio](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-web-search-domain-filtering) nella guida alla configurazione di Target.

## Configurare il ruolo del servizio Gateway
<a name="gateway-target-connector-web-search-tool-service-role"></a>

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](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-web-search-service-role) nella guida alla configurazione di Target.

## Schema di input
<a name="gateway-target-connector-web-search-tool-input-schema"></a>

Il Web Search Tool accetta il seguente schema di input quando viene richiamato tramite`tools/call`. Il `filters` campo è disponibile solo quando la destinazione è collegata alla versione del connettore `1.2.0` o successiva. Nelle versioni precedenti, lo schema espone solo `query` e. `maxResults`

```
{
  "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"
      },
      "filters": {
        "description": "Optional request-level filters (connector version 1.2.0+). Applied on top of the target-level exclude list and include list.",
        "type": "object",
        "properties": {
          "domainFilter": {
            "description": "Per-call domain filter. Include and exclude lists each hold up to 100 domains. Root domain matches subdomains.",
            "type": "object",
            "properties": {
              "include": {
                "description": "Restrict results to these domains.",
                "type": "array",
                "items": {"type": "string"}
              },
              "exclude": {
                "description": "Drop results from these domains.",
                "type": "array",
                "items": {"type": "string"}
              }
            }
          },
          "publishedDateFilter": {
            "description": "Per-call published-date filter. Bounds inclusive, ISO-8601 UTC. Applies to web results only.",
            "type": "object",
            "properties": {
              "from": {
                "description": "Earliest publication date (ISO-8601 UTC).",
                "type": "string"
              },
              "to": {
                "description": "Latest publication date (ISO-8601 UTC).",
                "type": "string"
              }
            }
          }
        }
      }
    },
    "required": ["query"]
  }
}
```


| Campo | Tipo | Campo obbligatorio | Descrizione | 
| --- | --- | --- | --- | 
|  `query`  | stringa | Sì | Stringa della query di ricerca. Deve contenere al massimo 200 caratteri. | 
|  `maxResults`  | numero intero | No | Numero massimo di risultati da restituire. Intervallo valido: 1-25. Il valore predefinito è 10. | 
|  `filters`  | oggetto | No | Filtri opzionali a livello di richiesta. Disponibile nella versione con connettore `1.2.0` e successive. | 
|  `filters.domainFilter.include`  | matrice di stringhe | No | Domini da includere. Fino a 100 voci. | 
|  `filters.domainFilter.exclude`  | matrice di stringhe | No | Domini da escludere. Fino a 100 voci. | 
|  `filters.publishedDateFilter.from`  | stringa | No | Prima data di pubblicazione, ISO-8601 UTC. | 
|  `filters.publishedDateFilter.to`  | stringa | No | Data di pubblicazione più recente, ISO-8601 UTC. | 

## Formato della risposta
<a name="gateway-target-connector-web-search-tool-response-format"></a>

Il Web Search Tool 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 | Sì | 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à
<a name="gateway-target-connector-web-search-tool-availability"></a>

Il connettore Web Search Tool è disponibile nelle seguenti AWS regioni:
+ Stati Uniti orientali (Virginia settentrionale) `us-east-1` 
+ Stati Uniti orientali (Ohio) `us-east-2` 
+ Stati Uniti occidentali (Oregon) `us-west-2` 
+ Europa (Irlanda) `eu-west-1` 
+ Asia Pacifico (Sydney) `ap-southeast-2` 
+ Asia Pacifico (Tokyo) `ap-northeast-1` 
+  AWS GovCloud (US-West) `us-gov-west-1` 

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
<a name="gateway-target-connector-web-search-tool-acceptable-use"></a>

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.