Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Amazon Bedrock administró las bases de conocimiento como objetivo del conector

Las bases de conocimiento administradas de 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 ninguna 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 los agentes la descubren y consultan con llamadas del Protocolo de contexto modelo (MCP) estándar, sin necesidad de crear una integración de recuperación personalizada. Para obtener más información sobre la creación y la administración de una base de conocimientos gestionada, consulte las bases de conocimientos de Amazon Bedrock en la guía del usuario de Amazon Bedrock.

El conector muestra dos herramientas. La primera esAgenticRetrieveStream. En lugar de realizar una búsqueda única, planifica una estrategia de recuperación, ejecuta varios pasos de recuperación en las bases de conocimiento administradas y, si lo desea, amplía los documentos completos y transmite tanto los resultados justificativos como una respuesta sintetizada respaldada por citas. Retrieverealiza una única búsqueda híbrida y devuelve los pasajes más relevantes.

En las siguientes secciones se explica el funcionamiento del conector, la recuperación por agencia en profundidad, los casos de uso comunes, la configuración de 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 administradas de Amazon Bedrock. El Gateway gestiona la administración de esquemas, la resolución de puntos finales y la autenticación de 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 por agencia, consulte Recuperación por agencia.

Recuperación agencial

AgenticRetrieveStreamtrata la pregunta como una tarea: en lugar de una única búsqueda híbrida que Retrieve se ejecuta para una consulta, planifica una estrategia de recuperación, ejecuta varios pasos de recuperación en las bases de conocimiento gestionadas y transmite los resultados de respaldo y una respuesta sintetizada respaldada por citas, todo en una sola herramienta. La respuesta sintetizada se devuelve de forma predeterminada; se establece generateResponse para que solo devuelva false los 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 de MCP a medida que notifications/message pasa, y los resultados y la respuesta se muestran en el resultado de la herramienta.

Para obtener más información sobre cómo funciona la recuperación por agencia, 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 destino de puerta de enlace con la configuración del conector de Amazon Bedrock Managed Knowledge Bases, incluidos ejemplos de configuración con el SDK y la CLI de Python, consulte Configurar una base de conocimientos gestionada en la guía de configuración de destinos.

Configure la función de servicio Gateway

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 de servicio de puerta de enlace en la guía de configuración de destinos.

Invoca las herramientas

Tras crear el objetivo, el agente descubre las herramientas con las que se tools/list utiliza y las llama. tools/call El nombre de cada herramienta tiene como prefijo el nombre del objetivo, en la forma <target-name>_<tool-name>_AgenticRetrieveStream omanaged-kb___Retrieve).

AgenticRetrieveStreamEn efecto, su agente solo aprueba 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 el caso de que el identificador de la base de conocimientos administrada esté vinculado al destino, el agente solo aprueba la consulta:

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

Si ha expuesto los parámetros de recuperación al agente (consulte Controlar los parámetros que puede establecer 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 tools/list es el conjunto de campos que su agente puede configurar cuando llamaAgenticRetrieveStream. De forma predeterminada, el único campo visible para el agente es. messages Los recuperadores que se deben 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 establecer 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 definidos por el administrador agenticRetrieveConfiguration (modelo básicoretrievers, cambio de clasificación y verificaciónpolicyConfiguration) y generateResponse —maxAgentIteration, consulte Configurar una base de conocimientos gestionada y una referencia de configuración. Referencia de la configuración

AgenticRetrieveStream formato de respuesta

AgenticRetrieveStreamtransmite una secuencia de eventos. En MCP, los eventos de rastreo se muestran en función del progreso en tiempo real, y los resultados de la recuperación y la respuesta sintetizada se incluyen en el resultado de la herramienta. notifications/message 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 tools/list es el conjunto de campos que su agente puede configurar 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 están configurados por el administrador en el destino. Para mostrar 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 que se pueden anular (los metadatosnumberOfResults, el cambio de clasificación y las consultas de filter imágenes overrideSearchType multimodales), consulte la referencia de configuración. Referencia de la 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 de retrievalResults tiene la siguiente estructura:

Referencia de la configuración

El administrador establece los siguientes campos en parameterValues el agente o los expone a él parameterOverrides cuando se crea el destino. Para saber dónde configurarlos, consulte Configurar una base de conocimientos gestionada y Controlar los parámetros que puede establecer el agente.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Filtrado de control de acceso

Si su base de conocimientos gestionada usa el control de acceso para filtrar los resultados por usuario o grupo, la aplicación que realiza la llamada debe pasar una userContext junto con la solicitud. La puerta de enlace userContext pasa a la base de conocimientos, que aplica el filtrado de control de acceso basándose en 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"
    }
  }
}