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 en la Guía del usuario de Amazon Bedrock.

El conector incluye dos herramientas. La primera esAgenticRetrieveStream. 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. Retrieverealiza una única búsqueda híbrida y devuelve los pasajes más relevantes.

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.

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 contools/list:

Una sola Retrieve invocación sigue este flujo:

Para ver el flujo de recuperación de agentes, consulte Recuperación de agentes.

Recuperación de agentes

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

Para ver el esquema de solicitudes y eventos, consulte el esquema de AgenticRetrieveStream entrada y el formato de respuesta. AgenticRetrieveStream

Casos de uso

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 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 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 (<target-name>_<tool-name>_AgenticRetrieveStreamo).

AgenticRetrieveStreamEn 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?" } }
      ]
    }
  }
}

RetrieveEn 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 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 llamaAgenticRetrieveStream. 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). Para mostrar más campos al agente, configúrelos parameterOverrides en el destino (consulte Controlar los parámetros que 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"]
}

Para ver los campos configurados por el administrador:retrievers, agenticRetrieveConfiguration (modelo básico, cambio de clasificación y barreras de protecciónpolicyConfiguration) ymaxAgentIteration, consulte Configurar una base de conocimientos gestionada y generateResponse la referencia de configuración.

AgenticRetrieveStream formato de respuesta

AgenticRetrieveStreamtransmite 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:

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

Recupera el esquema de entrada

El esquema devuelto por tools/list es el conjunto de campos que su agente puede establecer cuando llamaRetrieve. 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 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"]
}

Para ver los campos configurados por el administrador y los que se pueden anular (metadatosnumberOfResults, cambios de clasificación y consultas de filter imágenes overrideSearchType multimodales), consulte la referencia de configuración.

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 serializadaretrievalResults:

{
  "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:

Referencia de la configuración

Al crear el destinoparameterValues, 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 y controlar los parámetros que puede configurar el agente.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

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:

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