Basi di conoscenza gestite da Amazon Bedrock come destinazione del connettore

Amazon Bedrock Managed Knowledge Bases fornisce una generazione di recupero aumentata (RAG) completamente gestita: Amazon Bedrock gestisce l'archiviazione vettoriale, l'inserimento dei dati e l'ottimizzazione del recupero, quindi non esiste un'infrastruttura di recupero da fornire o gestire. Amazon Bedrock AgentCore offre una knowledge base gestita come connettore gateway nativo: lo colleghi al AgentCore gateway e i tuoi agenti lo scoprono e lo interrogano con chiamate standard Model Context Protocol (MCP), senza alcuna integrazione di recupero personalizzata da creare. Per informazioni dettagliate sulla creazione e la gestione di una knowledge base gestita, consulta Knowledge base per 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ù fasi di recupero nelle knowledge base gestite, facoltativamente si espande a documenti completi e trasmette 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 target e gli schemi di input e risposta per entrambi gli strumenti.

Come funziona

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

Una singola Retrieve invocazione segue questo flusso:

Per il flusso di recupero agentico, vedi Agentic retrieval.

Recupero agentico

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

Il tuo agente la richiama con una conversazione (). messages I retriever interrogati, ognuno dei quali punta a una knowledge base gestita, sono configurati dall'amministratore sulla destinazione e non forniti dall'agente. I flussi di avanzamento della pianificazione e del recupero su MCP vengono visualizzati come risultato dello strumento e i risultati e la notifications/message risposta vengono 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 delle richieste e degli eventi, consulta AgenticRetrieveStream lo schema di input e il formato di risposta. AgenticRetrieveStream

Casi d’uso

Configura una knowledge base gestita

Per istruzioni su come creare un Gateway Target con la configurazione del connettore Amazon Bedrock Managed Knowledge Bases, inclusi esempi di configurazione utilizzando Python SDK e 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 AgentCore servizio che gli consenta di eseguire azioni di recupero sulla Knowledge Base gestita 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.

Invoca gli strumenti

Dopo aver creato l'obiettivo, il tuo agente scopre gli strumenti con tools/list cui li chiama. tools/call Il nome di ogni strumento è preceduto dal nome della destinazione, nel formato <target-name>_<tool-name>_AgenticRetrieveStream omanaged-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?" } }
      ]
    }
  }
}

InfattiRetrieve, l'identificatore della knowledge base gestita è associato alla destinazione, quindi l'agente trasmette 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 Controlla 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 tools/list è l'insieme di campi che l'agente può impostare quando chiamaAgenticRetrieveStream. Per impostazione predefinita, l'unico campo visibile all'agente è. messages I retriever da interrogare e tutte le configurazioni di recupero sono impostati dall'amministratore sulla destinazione. Vedi Configurare una knowledge base gestita. Per esporre più campi all'agente, configuralo parameterOverrides sulla destinazione: vedi Controlla 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, reranking e guardrails throughpolicyConfiguration) e generateResponse — consulta Configurazione di una knowledge base gestita e riferimenti alla configurazione. maxAgentIteration

AgenticRetrieveStream formato di risposta

AgenticRetrieveStreamtrasmette una sequenza di eventi. Tramite MCP, gli eventi di traccia vengono forniti in base all'avanzamento in tempo reale, mentre notifications/message 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 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 gestita e tutte le impostazioni di recupero sono impostate dall'amministratore sulla destinazione. Per esporre le impostazioni di recupero, ad esempio numberOfResults o i metadati, filter all'agente, configuratele parameterOverrides sulla destinazione. Consultate Controllare i parametri che 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 sovrascrivibilinumberOfResults, ovvero i metadati, la riclassificazione e le interrogazioni sulle immagini multimodali filteroverrideSearchType, consulta la guida di riferimento alla configurazione.

Recupera il formato di risposta

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

{
  "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 retrievalResults ha la seguente struttura:

Informazioni di riferimento sulla configurazione

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

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Filtraggio per il controllo degli accessi

Se la knowledge base gestita utilizza il controllo degli accessi per filtrare i risultati per utente o gruppo, l'applicazione chiamante deve passare userContext insieme alla richiesta. Il Gateway userContext passa alla knowledge base, che applica il filtro di controllo degli accessi basato su di esso. Il gateway non viene compilato userContext in base all'identità IAM del chiamante: l'applicazione deve fornirla in modo esplicito.

Per utilizzarlo:

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