# Amazon Bedrock gestionó las bases de conocimiento como objetivo de conexión
Las bases de conocimiento gestionadas por Amazon Bedrock proporcionan una generación aumentada de recuperación (RAG) totalmente gestionada: Amazon Bedrock gestiona el almacenamiento vectorial, la ingesta de datos y la optimización de la recuperación, por lo que no hay una infraestructura de recuperación que pueda aprovisionar u operar. Amazon Bedrock AgentCore expone una base de conocimientos gestionada como un conector de puerta de enlace nativo: usted la conecta a su AgentCore puerta de enlace y sus agentes la descubren y consultan con llamadas estándar del Protocolo de contexto modelo (MCP), sin necesidad de crear una integración de recuperación personalizada. Para obtener más información sobre la creación y administración de una base de conocimientos gestionada, consulte [las bases de conocimiento de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html) en la Guía del *usuario de Amazon Bedrock*.
El conector incluye dos herramientas. La primera es`AgenticRetrieveStream`. En lugar de realizar una sola búsqueda, planifica una estrategia de recuperación, ejecuta varios pasos de recuperación en las bases de conocimiento gestionadas y, de forma opcional, se amplía a documentos completos y reproduce tanto los resultados de apoyo como una respuesta sintetizada y respaldada por citas. `Retrieve`realiza una única búsqueda híbrida y devuelve los pasajes más relevantes.
**nota**
Este conector solo es compatible con las bases de conocimiento gestionadas por Amazon Bedrock.
En las siguientes secciones se explica cómo funciona el conector, la recuperación de agentes en profundidad, los casos de uso comunes, cómo configurar un objetivo y los esquemas de entrada y respuesta de ambas herramientas.
**Topics**
+ [Funcionamiento](#gateway-target-connector-managed-kb-how-it-works)
+ [Recuperación de agentes](#gateway-target-connector-managed-kb-agentic-retrieval)
+ [Casos de uso](#gateway-target-connector-managed-kb-use-cases)
+ [Configure una base de conocimientos gestionada](#gateway-target-connector-managed-kb-setup)
+ [Configure la función de Gateway Service](#gateway-target-connector-managed-kb-service-role)
+ [Invoque las herramientas](#gateway-target-connector-managed-kb-invoke)
+ [AgenticRetrieveStream esquema de entrada](#gateway-target-connector-managed-kb-agentic-input-schema)
+ [AgenticRetrieveStream formato de respuesta](#gateway-target-connector-managed-kb-agentic-response-format)
+ [Recupera el esquema de entrada](#gateway-target-connector-managed-kb-input-schema)
+ [Recupera el formato de respuesta](#gateway-target-connector-managed-kb-response-format)
+ [Referencia de la configuración](#gateway-target-connector-managed-kb-config-reference)
+ [Filtrado de control de acceso](#gateway-target-connector-managed-kb-access-control)
## Funcionamiento
Amazon Bedrock AgentCore proporciona un conector integrado a las bases de conocimiento gestionadas de Amazon Bedrock. El Gateway se encarga de la gestión de esquemas, la resolución de los puntos finales y la autenticación de los servicios. El conector presenta dos herramientas, que el agente descubre con`tools/list`:
+ `AgenticRetrieveStream`: una función de recuperación de varios pasos basada en secuencias que devuelve los resultados, los eventos de rastreo de planificación y recuperación y una respuesta sintetizada con citas (se devuelve de forma predeterminada; se desactiva con). `generateResponse: false`
+ `Retrieve`— una búsqueda híbrida única que devuelve los pasajes más relevantes con referencias a las fuentes.
Una sola `Retrieve` invocación sigue este flujo:
1. **Configuración de la puerta** de enlace: cree una puerta de enlace y añada un objetivo de bases de conocimiento gestionadas de Amazon Bedrock, haciendo referencia a la base de conocimientos gestionada que desee exponer. El Gateway captura una instantánea del esquema de la herramienta y proporciona la integración.
1. **Detección de herramientas**: su agente llama `tools/list` al punto final de Gateway y descubre la herramienta de recuperación con su esquema de entrada.
1. **Invocación de recuperación**: su agente llama `tools/call` con una consulta en lenguaje natural. El Gateway se autentica en el backend y dirige la solicitud a la base de conocimientos gestionada, que ejecuta una búsqueda híbrida en el contenido ingerido.
1. **Resultados**: la herramienta devuelve los pasajes más relevantes con referencias a las fuentes en formato JSON dentro del contenido de texto del resultado de la herramienta.
1. **Respuesta fundamentada**: su agente utiliza los resultados para redactar una respuesta con las fuentes citadas.
[Para ver el flujo de recuperación de agentes, consulte Recuperación de agentes.](#gateway-target-connector-managed-kb-agentic-retrieval)
## Recuperación de agentes
`AgenticRetrieveStream`trata una pregunta como una tarea: en lugar de realizar una búsqueda híbrida única para una consulta, planifica una estrategia de recuperación, ejecuta varios pasos de recuperación en las bases de conocimiento gestionadas y reproduce los resultados de apoyo y una respuesta sintetizada y respaldada por citas, todo ello en una sola llamada de herramientas. `Retrieve` La respuesta sintetizada se devuelve de forma predeterminada; se establece en `generateResponse` para que `false` devuelva solo resultados.
Su agente la invoca con una conversación (`messages`). Los recuperadores que consulta (cada uno de los cuales apunta a una base de conocimientos gestionada) los configura el administrador en el destino, no los proporciona el agente. El progreso de la planificación y la recuperación se transmite a través del MCP de la misma `notifications/message` forma, y los resultados y la respuesta se devuelven en el resultado de la herramienta.
Para obtener más información sobre cómo funciona la recuperación de agentes, consulte las bases de [conocimiento de Amazon Bedrock en la Guía del usuario de *Amazon* Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html).
[Para ver el esquema de solicitudes y eventos, consulte el esquema de [AgenticRetrieveStream entrada](#gateway-target-connector-managed-kb-agentic-input-schema) y el formato de respuesta. AgenticRetrieveStream ](#gateway-target-connector-managed-kb-agentic-response-format)
## Casos de uso
+ **Asistentes de conocimiento empresarial**: las respuestas de los agentes se basan en las wikis internas, los manuales de instrucciones y los documentos de políticas que se han incorporado a una base de conocimientos gestionada.
+ **Preguntas y respuestas sobre documentos: responde a preguntas sobre grandes colecciones de documentos sin crear ni gestionar un** almacén vectorial.
+ **Multi-source RAG**: consulte contenido de varias fuentes de datos combinadas en una única base de conocimientos gestionada en una sola llamada de recuperación.
+ **Multi-step planificación**: se utiliza `AgenticRetrieveStream` para responder a preguntas ambiguas o de varias partes que requieren planificación y varios pasos de recuperación. De este modo, se obtiene una respuesta sintetizada y respaldada por citas en una sola llamada.
+ **Tool-augmented agentes**: combine la recuperación gestionada de la base de conocimientos con sus otras herramientas de Gateway para que un agente pueda buscar datos fundamentados y tomar medidas.
## Configure una base de conocimientos gestionada
Para obtener instrucciones sobre cómo crear un Gateway Target con la configuración del conector de las bases de conocimiento gestionadas de Amazon Bedrock, incluidos ejemplos de configuración mediante el SDK y la CLI de Python, consulte [Configurar una base de conocimientos gestionada](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-setup) en la guía de configuración de Target.
## Configure la función de Gateway Service
La puerta de enlace necesita una función de servicio que permita al AgentCore servicio realizar acciones de recuperación en la base de conocimientos gestionada en su nombre. Para conocer los permisos de IAM y la configuración de políticas necesarios, consulte [Configurar el rol del servicio de puerta](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-service-role) de enlace en la guía de configuración de destino.
## Invoque las herramientas
Tras crear el objetivo, el agente descubre las herramientas `tools/list` y las llama con `tools/call` ellas. El nombre de cada herramienta lleva el nombre del objetivo como prefijo `managed-kb___Retrieve` (`__AgenticRetrieveStream`o).
`AgenticRetrieveStream`En efecto, su agente solo transmite la conversación. El administrador configura los recuperadores en el destino, por lo que el agente no envía los ID de la base de conocimientos:
```
{
"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?" } }
]
}
}
}
```
`Retrieve`En efecto, el identificador de la base de conocimientos gestionada está vinculado al destino, por lo que su agente solo pasa la consulta:
```
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "managed-kb___Retrieve",
"arguments": {
"retrievalQuery": { "text": "What is Amazon Bedrock AgentCore?" }
}
}
}
```
Si expuso los parámetros de recuperación al agente (consulte [Controlar los parámetros que puede configurar el agente), el agente puede](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-parameters) anular los valores predeterminados configurados por el administrador en el momento de la llamada:
```
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "managed-kb___Retrieve",
"arguments": {
"retrievalQuery": { "text": "insurance benefits" },
"retrievalConfiguration": {
"managedSearchConfiguration": { "numberOfResults": 2 }
}
}
}
}
```
## AgenticRetrieveStream esquema de entrada
El esquema devuelto por `tools/list` es el conjunto de campos que su agente puede establecer cuando llama`AgenticRetrieveStream`. De forma predeterminada, el único campo visible para el agente es. `messages` [Los recuperadores que se van a consultar y toda la configuración de recuperación están configurados por el administrador en el destino (consulte Configurar una base de conocimientos gestionada).](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-setup) Para mostrar más campos al agente, configúrelos `parameterOverrides` en el destino (consulte [Controlar los parámetros que](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-parameters) puede configurar el agente).
```
{
"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"]
}
```
| Campo | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| `messages` | array | Sí | La conversación sobre la recuperación del agente. Cada mensaje tiene un `role` (`user`o`assistant`) y. `content.text` |
[Para ver los campos configurados por el administrador:`retrievers`, `agenticRetrieveConfiguration` (modelo básico, cambio de clasificación y barreras de protección`policyConfiguration`) y`maxAgentIteration`, consulte [Configurar una](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-setup) base de conocimientos gestionada y `generateResponse` la referencia de configuración.](#gateway-target-connector-managed-kb-config-reference)
## AgenticRetrieveStream formato de respuesta
`AgenticRetrieveStream`transmite una secuencia de eventos. A través del MCP, los eventos de rastreo se muestran en tiempo real `notifications/message` para indicar el progreso, y los resultados de la recuperación y la respuesta sintetizada se incluyen en el resultado de la herramienta. La transmisión emite los siguientes tipos de eventos:
| Event | Description (Descripción) |
| --- | --- |
| `traceEvent` | Un paso de planificación o recuperación, con un `step` (,, o) `Planning` `Retrieval``SpeculativeRetrieval`, un (, o`FullDocumentExpansion`), un `status` (`IN_PROGRESS``SUCCEEDED`, o`FAILED`), uno legible por humanos`message`, el `actions` realizado y cualquier o. `warnings` `failures` |
| `responseEvent` | Una parte del texto de respuesta generado. Se emite de forma predeterminada; se suprime solo cuando `generateResponse` se establece en. `false` |
| `result` | La recuperación `results` y, a menos que `generateResponse` esté establecida en`false`, la final `generatedResponse` con la respuesta y las citas. |
Un `result` evento tiene la siguiente estructura:
```
{
"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" } ]
}
]
}
}
}
```
| Campo | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| `results` | array | Sí | Los resultados de la recuperación. Cada elemento tiene `content` (con `text` o `byteContent` y a`mimeType`), el `sourceRetriever` que lo produjo y es opcional`metadata`. |
| `generatedResponse` | objeto | No | Está presente de forma predeterminada. Se omite solo cuando `generateResponse` está establecido en. `false` Contiene el resumen `answer` y `citations` la respuesta del mapa abarca (`startIndex`,`endIndex`) a los resultados de apoyo. |
| `nextToken` | cadena | No | Un token para recuperar el siguiente conjunto de resultados, si lo hay. |
## Recupera el esquema de entrada
El esquema devuelto por `tools/list` es el conjunto de campos que su agente puede establecer cuando llama`Retrieve`. De forma predeterminada, el único campo visible para el agente es. `retrievalQuery.text` El identificador de la base de conocimientos gestionada y todos los ajustes de recuperación los establece el administrador en el destino. Para exponer al agente los ajustes de recuperación, como `numberOfResults` los metadatos, `filter` configúrelos `parameterOverrides` en el destino (consulte [Controlar los parámetros que](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-parameters) puede establecer el agente).
```
{
"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"]
}
```
| Campo | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| `retrievalQuery` | objeto | Sí | La consulta que se va a enviar a la base de conocimientos gestionada. |
| `retrievalQuery.text` | cadena | Sí | El texto de la consulta. |
[Para ver los campos configurados por el administrador y los que se pueden anular (metadatos`numberOfResults`, cambios de clasificación y consultas de `filter` imágenes `overrideSearchType` multimodales), consulte la referencia de configuración.](#gateway-target-connector-managed-kb-config-reference)
## Recupera el formato de respuesta
La `Retrieve` herramienta devuelve un `tools/call` resultado de MCP envuelto en un JSON-RPC sobre. Los `content` campos `isError` y están dentro y `result` el `text` campo contiene la carga útil serializada`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\"}}]}"
}
]
}
}
```
Cada elemento `retrievalResults` tiene la siguiente estructura:
| Campo | Tipo | Obligatorio | Description (Descripción) |
| --- | --- | --- | --- |
| `content` | objeto | Sí | El contenido del fragmento recuperado. Incluye un `type` (`TEXT`,, `IMAGE` `ROW``AUDIO`, o`VIDEO`) y el contenido correspondiente, por ejemplo, en el caso de los `text` fragmentos de texto. |
| `location` | objeto | No | La ubicación de los datos de origen. Incluye un `type` (`S3`,`WEB`,`CONFLUENCE`,`SHAREPOINT`,`CUSTOM`,, etc.) y el objeto de ubicación coincidente, como`s3Location.uri`. |
| `score` | número | No | La relevancia del resultado para la consulta. |
| `metadata` | objeto | No | Los atributos de los metadatos y sus valores para el archivo de origen de la fuente de datos. |
## Referencia de la configuración
Al crear el destino`parameterValues`, el administrador establece los siguientes campos o los expone el agente al crear el destino. `parameterOverrides` Para saber dónde configurarlos, consulte [Configurar una base de conocimientos gestionada](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-setup) y [controlar los parámetros que puede configurar el agente](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-parameters).
** `AgenticRetrieveStream` — `agenticRetrieveConfiguration` **
| Campo | Valores válidos | Notas |
| --- | --- | --- |
| `foundationModelType` | `MANAGED`, `CUSTOM` | `MANAGED`utiliza el modelo gestionado por el servicio (predeterminado). `CUSTOM`utiliza un ARN modelo Bedrock que usted suministre. |
| `rerankingModelType` | `MANAGED`, `CUSTOM`, `NONE` | `MANAGED`utiliza el reescalonador gestionado por el servicio (predeterminado). `CUSTOM`usa el tuyo propio. `NONE`desactiva la reclasificación. |
| `foundationModelConfiguration.type` | `BEDROCK_FOUNDATION_MODEL` | Obligatorio cuando es. `foundationModelType` `CUSTOM` |
| `maxAgentIteration` | entero | Limita el número de iteraciones de planificación y recuperación. |
| `policyConfiguration.guardrailConfiguration` | `guardrailId`, `guardrailVersion` | Coloca una barandilla Amazon Bedrock. |
** `Retrieve` — `managedSearchConfiguration` **
| Campo | Valores válidos | Notas |
| --- | --- | --- |
| `numberOfResults` | entero (1—100) | Número de fragmentos de origen que se van a recuperar. |
| `overrideSearchType` | `HYBRID`, `SEMANTIC` | `HYBRID`combina la búsqueda vectorial y por palabras clave. `SEMANTIC`utiliza únicamente la búsqueda vectorial. |
| `rerankingModelType` | `MANAGED`, `CUSTOM`, `NONE` | Igual que para`AgenticRetrieveStream`. |
| `rerankingConfiguration.type` | `BEDROCK_RERANKING_MODEL` | Obligatorio cuando se utiliza una reclasificación personalizada. |
| `rerankingConfiguration.bedrockRerankingConfiguration.metadataConfiguration.selectionMode` | `SELECTIVE`, `ALL` | Controla qué campos de metadatos se pasan al reordenador. |
| `filter` | `equals`, `notEquals`, `greaterThan`, `greaterThanOrEquals`, `lessThan`, `lessThanOrEquals`, `in`, `notIn`, `startsWith`, `listContains`, `stringContains`, `andAll`, `orAll` | Filtro de metadatos. Proporcione exactamente un operador. |
## Filtrado de control de acceso
Si su base de conocimientos gestionada utiliza el control de acceso para filtrar los resultados por usuario o grupo, la aplicación que realiza la llamada debe aprobar la solicitud. `userContext` La pasarela `userContext` pasa a la base de conocimientos, que aplica un filtrado de control de acceso en función de ella. La puerta de enlace no se rellena `userContext` a partir de la identidad de IAM de la persona que llama; la aplicación debe proporcionarla de forma explícita.
Para usarlo:
1. `$.userContext`Expóngalo al agente configurándolo `parameterOverrides` en el objetivo; consulte [Controlar los parámetros que puede establecer el agente](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-managed-kb-parameters).
1. Haga que la aplicación que realiza la llamada (no el modelo) incluya `userContext` en los `tools/call` argumentos:
```
{
"arguments": {
"retrievalQuery": { "text": "insurance benefits" },
"userContext": {
"userId": "user@example.com"
}
}
}
```