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

Le Knowledge Base gestite da Amazon Bedrock come obiettivo del connettore

Le Managed Knowledge Bases di Amazon Bedrock forniscono una generazione aumentata di recupero (RAG) completamente gestita: Amazon Bedrock gestisce l'archivio vettoriale, l'inserimento dei dati e l'ottimizzazione del recupero, quindi non c'è alcuna infrastruttura di recupero da fornire o gestire. Amazon Bedrock AgentCore espone una knowledge base gestita come connettore Gateway nativo: la colleghi al tuo AgentCore Gateway e i tuoi agenti la scoprono e la interrogano con chiamate MCP (Model Context Protocol) standard, senza alcuna integrazione di recupero personalizzata da creare. Per informazioni dettagliate sulla creazione e la gestione di una knowledge base gestita, consulta Knowledge bases for Amazon Bedrock nella Amazon Bedrock User Guide.

Il connettore espone due strumenti. Il primo èAgenticRetrieveStream. Invece di una singola ricerca, pianifica una strategia di recupero, esegue più passaggi di recupero nelle knowledge base gestite, opzionalmente si espande fino a ottenere documenti completi e riproduce in streaming sia i risultati di supporto che una risposta sintetizzata e supportata da citazioni. Retrieveesegue una singola ricerca ibrida e restituisce i passaggi più pertinenti.

Le sezioni seguenti illustrano il funzionamento del connettore, il recupero degli agenti in modo approfondito, i casi d'uso comuni, come impostare un obiettivo e gli schemi di input e risposta per entrambi gli strumenti.

Come funziona

Amazon Bedrock AgentCore fornisce un connettore integrato alle Amazon Bedrock Managed Knowledge Base. Il Gateway gestisce la gestione degli schemi, la risoluzione degli endpoint e l'autenticazione dei servizi. Il connettore presenta due strumenti, che l'agente scopre con: tools/list

Una singola Retrieve invocazione segue questo flusso:

Per il flusso di recupero dell'agente, vedere Recupero dell'agente. Recupero agentico

Recupero agentico

AgenticRetrieveStreamTratta una domanda come un'attività: anziché eseguire una singola ricerca ibrida per una sola query, pianifica una strategia di recupero, Retrieve esegue più passaggi di recupero nelle knowledge base gestite e trasmette in streaming i risultati di supporto e una risposta sintetizzata e supportata da citazioni, il tutto in un unico strumento. La risposta sintetizzata viene restituita per impostazione predefinita; è impostata per restituire solo i risultati. generateResponse false

Il tuo agente la richiama con una conversazione (). messages I retriever che interroga, ognuno dei quali punta a una knowledge base gestita, sono configurati dall'amministratore sulla destinazione, non forniti dall'agente. I progressi della pianificazione e del recupero vengono trasmessi tramite MCP as e i risultati e le risposte vengono notifications/message restituiti nel risultato dello strumento.

Per ulteriori informazioni su come funziona l'agentic retrieval, consulta le Knowledge base per Amazon Bedrock nella Amazon Bedrock User Guide.

Per lo schema della richiesta e dell'evento, consulta AgenticRetrieveStream lo schema di input e il formato della risposta. AgenticRetrieveStream

Casi d’uso

Configura una base di conoscenza gestita

Per istruzioni su come creare un Gateway Target con la configurazione del connettore Amazon Bedrock Managed Knowledge Bases, inclusi esempi di configurazione utilizzando l'SDK Python e la CLI, consulta Configurare una knowledge base gestita nella guida alla configurazione di target.

Configura il ruolo del servizio Gateway

Il Gateway necessita di un ruolo di servizio che consenta al AgentCore servizio di eseguire azioni di recupero sulla knowledge base gestita per tuo conto. Per le autorizzazioni IAM richieste e la configurazione delle policy, consulta Configure the Gateway Service Role nella guida alla configurazione di destinazione.

Richiama gli strumenti

Dopo aver creato il target, il tuo agente scopre gli strumenti tools/list e li chiama. tools/call Il nome di ogni strumento è preceduto dal nome della destinazione, nel formato (<target-name>_<tool-name>_AgenticRetrieveStreamomanaged-kb___Retrieve).

PerchéAgenticRetrieveStream, il tuo agente trasmette solo la conversazione. I retriever sono configurati sulla destinazione dall'amministratore, quindi l'agente non invia gli ID della knowledge base:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___AgenticRetrieveStream",
    "arguments": {
      "messages": [
        { "role": "user", "content": { "text": "How do I configure a knowledge base target?" } }
      ]
    }
  }
}

PerchéRetrieve, l'identificatore della knowledge base gestito è associato alla destinazione, quindi l'agente passa solo la query:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "What is Amazon Bedrock AgentCore?" }
    }
  }
}

Se hai esposto i parametri di recupero all'agente (vedi Controllare i parametri che l'agente può impostare), l'agente può sovrascrivere le impostazioni predefinite configurate dall'amministratore al momento della chiamata:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "insurance benefits" },
      "retrievalConfiguration": {
        "managedSearchConfiguration": { "numberOfResults": 2 }
      }
    }
  }
}

AgenticRetrieveStream schema di input

Lo schema restituito da tools/list è l'insieme di campi che l'agente può impostare quando chiamaAgenticRetrieveStream. Per impostazione predefinita, l'unico campo visibile all'agente è. messages I recuperatori da interrogare e tutte le configurazioni di recupero sono impostate dall'amministratore sulla destinazione. Vedi Configurare una knowledge base gestita. Configura una knowledge base gestita Per esporre più campi all'agente, configurali parameterOverrides sulla destinazione: consulta Controllare i parametri che l'agente può impostare.

{
  "type": "object",
  "properties": {
    "messages": {
      "description": "The messages for the agentic retrieval conversation. Contains the user query and conversation history.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "description": "The role of the message sender (user or assistant).",
            "type": "string",
            "enum": ["user", "assistant"]
          },
          "content": {
            "description": "The content of the message.",
            "type": "object",
            "properties": {
              "text": {
                "description": "The text content of the message.",
                "type": "string"
              }
            }
          }
        },
        "required": ["content", "role"]
      }
    }
  },
  "required": ["messages"]
}

Per i campi impostati dall'amministratore agenticRetrieveConfiguration (modello di baseretrievers, riposizionamento e guardrails throughpolicyConfiguration) emaxAgentIteration, consulta Impostare una knowledge base gestita e generateResponse riferimenti alla configurazione. Informazioni di riferimento sulla configurazione

AgenticRetrieveStream formato di risposta

AgenticRetrieveStreamtrasmette una sequenza di eventi. Tramite MCP, gli eventi di tracciamento vengono forniti in base notifications/message all'avanzamento in tempo reale e i risultati del recupero e la risposta sintetizzata vengono forniti nel risultato dello strumento. Lo stream emette i seguenti tipi di eventi:

Un result evento ha la seguente struttura:

{
  "result": {
    "results": [
      {
        "content": {
          "text": "Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...",
          "mimeType": "text/plain"
        },
        "sourceRetriever": { "identifier": "kb-retriever-1" },
        "metadata": { "x-amz-bedrock-kb-source-uri": "s3://example-bucket/docs/overview.pdf" }
      }
    ],
    "generatedResponse": {
      "answer": "A managed knowledge base lets Amazon Bedrock AgentCore handle the vector store, ingestion, and retrieval for you.",
      "citations": [
        {
          "startIndex": 0,
          "endIndex": 98,
          "references": [ { "..." : "references to supporting results" } ]
        }
      ]
    }
  }
}

Recupera lo schema di input

Lo schema restituito da tools/list è l'insieme di campi che l'agente può impostare quando chiamaRetrieve. Per impostazione predefinita, l'unico campo visibile all'agente è. retrievalQuery.text L'identificatore della knowledge base gestito e tutte le impostazioni di recupero sono impostati dall'amministratore sulla destinazione. Per esporre le impostazioni di recupero, ad esempio i metadati, all'numberOfResultsagente, esegui la configurazione parameterOverrides sulla destinazione: filter consulta Controllare i parametri che l'agente può impostare. Controlla quali parametri l'agente può impostare

{
  "type": "object",
  "properties": {
    "retrievalQuery": {
      "description": "Contains the query to send the managed knowledge base.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text of the query made to the managed knowledge base.",
          "type": "string"
        }
      }
    }
  },
  "required": ["retrievalQuery"]
}

Per i campi impostati dall'amministratore e sovrascrivibili (metadatinumberOfResults, riclassificazione e interrogazioni di immagini multimodali) filteroverrideSearchType, vedere Riferimento alla configurazione. Informazioni di riferimento sulla configurazione

Recupera il formato della risposta

Lo Retrieve strumento restituisce un tools/call risultato MCP racchiuso in una JSON-RPC busta. I content campi isError e sono all'interno e result il text campo contiene il payload serializzatoretrievalResults:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "{\"retrievalResults\":[{\"content\":{\"type\":\"TEXT\",\"text\":\"Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...\"},\"location\":{\"type\":\"S3\",\"s3Location\":{\"uri\":\"s3://example-bucket/docs/overview.pdf\"}},\"score\":0.87,\"metadata\":{\"x-amz-bedrock-kb-source-uri\":\"s3://example-bucket/docs/overview.pdf\"}}]}"
      }
    ]
  }
}

Ogni elemento in retrievalResults ha la seguente struttura:

Informazioni di riferimento sulla configurazione

I seguenti campi vengono impostati dall'amministratore o esposti all'agente con parameterOverrides la creazione della destinazione. parameterValues Per sapere dove impostarli, consulta Configurare una knowledge base gestita e Controllare quali parametri l'agente può impostare.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Filtraggio per il controllo degli accessi

Se la tua knowledge base gestita utilizza il controllo degli accessi per filtrare i risultati per utente o gruppo, l'applicazione chiamante deve inviare un messaggio di userContext risposta alla richiesta. Il Gateway userContext passa alla knowledge base, che applica un filtro di controllo degli accessi basato su di essa. Il Gateway non si compila userContext a partire dall'identità IAM del chiamante: l'applicazione deve fornirla esplicitamente.

Per utilizzarlo:

{
  "arguments": {
    "retrievalQuery": { "text": "insurance benefits" },
    "userContext": {
      "userId": "user@example.com"
    }
  }
}