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

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 vengono congelate al momento della formazione. Quando un utente chiede informazioni sui prezzi azionari odierni o su una versione del software rilasciata un'ora fa, un agente che si affida esclusivamente ai propri dati di formazione non può fornire risposte accurate.

Creare integrazioni di ricerca web personalizzate per risolvere questo problema è costoso: procurarsi API di ricerca di terze parti, gestire chiavi, quote e limiti di velocità, analizzare formati di risultati incoerenti tra i vari provider, creare una logica di estrazione degli snippet in modo che i modelli ottengano passaggi pertinenti anziché HTML grezzo, ragionare su dove arrivano le richieste dei clienti e su come potrebbero essere conservati 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 tale complessità. È una funzionalità di ricerca MCP-compliant web completamente gestita che consente ai tuoi agenti di recuperare informazioni dal Web senza alcun sovraccarico dell'infrastruttura. È disponibile come connettore gestito da connettere al gateway AgentCore . 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 mantenere.

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

Funzionalità chiave

Purpose-built indice web

Molte soluzioni che aggiungono la ricerca web a un agente sono racchiuse in 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.

Privato in base alla progettazione

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

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.

Casi d’uso

Configura lo strumento di ricerca sul 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, vedi Configurare Web Search Tool nella guida alla configurazione di destinazione.

Da utilizzare con un'imbracatura

Per fornire a AgentCore Harness la funzionalità di ricerca web, collega il gateway che hai creato in Set up Web Search Tool all'harness come strumento. agentcore_gateway Il ruolo di esecuzione dell'harness richiede l'bedrock-agentcore:InvokeGatewayautorizzazione sull'ARN del gateway. Per una procedura dettagliata completa, consulta Strumenti nella documentazione di Harness.

Configura il filtro dei domini

Web Search Tool supporta 2 livelli di filtro che si compongono per ogni richiesta:

Request-level i filtri si compongono con l'elenco di esclusione e l'elenco di inclusione a livello di destinazione:

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 filtro del dominio nella guida alla configurazione di destinazione.

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 destinazione.

Schema di input

Il Web Search Tool accetta il seguente schema di input quando viene richiamato tramitetools/call. Il filters campo è disponibile solo quando la destinazione è fissata 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"]
  }
}

Formato della risposta

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\"}]}"
    }
  ]
}

Disponibilità

Il connettore Web Search Tool è disponibile nelle seguenti AWS regioni:

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

Uso accettabile

Se utilizzate Web Search Tool, siete responsabili dell'uso, e di qualsiasi uso da parte dei vostri utenti finali, dei contenuti recuperati da Web Search Tool («Risultati della ricerca»). È necessario conservare e visualizzare le citazioni di origine e i collegamenti forniti con ciascun risultato della ricerca in qualsiasi output fornito agli utenti finali che utilizza il risultato della ricerca. Non puoi utilizzare lo Strumento di ricerca Web per (a) estrarre, archiviare o riprodurre in blocco contenuti dai Risultati della ricerca o (b) creare o popolare un indice o un database concorrente.