

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.

# Aumento de la generación de respuestas para el agente con una base de conocimientos
<a name="agents-kb-add"></a>

La bases de conocimientos de Amazon Bedrock le ayudan a aprovechar la generación aumentada por recuperación (RAG), una técnica popular que consiste en extraer información de un almacén de datos para aumentar las respuestas generadas por los modelos de lenguaje grandes (LLM). Al configurar una base de conocimientos con su origen de datos y el almacén vectorial, la aplicación puede consultarla para obtener información que permita responder a la consulta, ya sea con citas directas de los orígenes o con respuestas naturales generadas a partir de los resultados de la consulta.

Para utilizar las bases de conocimientos de Amazon Bedrock con su agente de Amazon Bedrock, primero tendrá que crear una base de conocimientos y, a continuación, asociarla al agente. Si aún no ha creado una base de conocimientos, consulte [Recuperación de datos y generación de respuestas de IA con Bases de conocimiento de Amazon Bedrock](knowledge-base.md) para obtener más información sobre las bases de conocimientos y cree una. Puede asociar una base de conocimientos al [crear el agente](agents-create.md) o después de crearlo. Para asociar una base de conocimiento a un agente existente, seleccione la pestaña correspondiente al método que prefiera y siga estos pasos:

------
#### [ Console ]

**Agregación de una base de conocimientos**

1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**.

1. Elija **Editar en el Creador de agentes**.

1. Seleccione **Agregar** en la sección **Bases de conocimientos**.

1. Elija una base de conocimientos que haya creado y proporcione instrucciones sobre cómo debe interactuar el agente con ella.

1. Elija **Agregar**. En la parte superior aparece un banner de confirmación.

1. Seleccione **Preparar** para aplicar los cambios que haya realizado al agente antes de probarlo.

------
#### [ API ]

Para asociar una base de conocimientos a un agente, envíe una solicitud [AssociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_AssociateAgentKnowledgeBase.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

En la siguiente lista se describen los campos de la solicitud:
+ Los siguientes campos son obligatorios:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/agents-kb-add.html)
+ Los siguientes campos son opcionales:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/agents-kb-add.html)

------

Puede modificar las [configuraciones de consulta](kb-test-config.md) de una base de conocimientos asociada a su agente utilizando el campo `sessionState` de la solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) cuando invoca el agente. Para obtener más información, consulte [Contexto de sesión del agente de control](agents-session-state.md).

# Visualización de información sobre una asociación de agente y base de conocimientos
<a name="agents-kb-view"></a>

Para saber cómo ver información sobre una base de conocimiento, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:

------
#### [ Console ]

**Visualización de información sobre una base de conocimientos asociada a un agente**

1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**.

1. Elija **Editar en el Creador de agentes**.

1. En la sección **Bases de conocimientos**, seleccione la base de conocimientos de la que quiere ver la información.

------
#### [ API ]

Para obtener información sobre una base de conocimiento asociada a un agente, envíe una solicitud [GetAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentKnowledgeBase.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique los siguientes campos:

Para mostrar la información sobre las base de conocimiento asociadas a un agente, envíe una solicitud [ListAgentKnowledgeBases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentKnowledgeBases.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique el `agentId` y la `agentVersion` para las que desea ver las bases de conocimientos asociadas.


****  

| Campo | Descripción breve | 
| --- | --- | 
| maxResults | El número máximo de resultados que se devuelven en una respuesta. | 
| nextToken | Si hay más resultados que el número que ha especificado en el campo maxResults, la respuesta devolverá un valor nextToken. Para ver el siguiente lote de resultados, envíe el valor nextToken en otra solicitud. | 

[Ver ejemplos de código](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-agent_example_bedrock-agent_ListAgentKnowledgeBases_section.html)

------

# Modificación de una asociación de agente y base de conocimientos
<a name="agents-kb-edit"></a>

Para obtener información sobre cómo modificar una base de conocimiento de un agente, seleccione la pestaña correspondiente al método que prefiera y siga estos pasos:

------
#### [ Console ]

**Modificación de una asociación de agente y base de conocimientos**

1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**.

1. Elija **Editar en el Creador de agentes**.

1. En la sección **Grupos de acciones**, seleccione un grupo de acciones para editarlo. A continuación, elija **Editar**.

1. Edite los campos existentes según sea necesario. Para obtener más información, consulte [Aumento de la generación de respuestas para el agente con una base de conocimientos](agents-kb-add.md).

1. Para controlar si el agente puede utilizar la base de conocimientos, seleccione **Habilitada** o **Deshabilitada**. Utilice esta función para ayudar a solucionar los problemas de comportamiento de su agente.

1. Para permanecer en la misma ventana y poder probar el cambio, elija **Guardar**. Seleccione **Guardar y salir** para volver a la página **Borrador de trabajo**.

1. Para aplicar los cambios que ha realizado en el agente antes de probarlo, seleccione **Preparar** en la ventana **Probar** o en la parte superior de la página **Borrador de trabajo**.

------
#### [ API ]

Para modificar la configuración de una base de conocimiento asociada a un agente, envíe una solicitud [UpdateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentKnowledgeBase.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Dado que se sobrescribirán todos los campos, incluya los dos campos que quiera actualizar, así como los campos que quiera mantener sin cambios. Debe especificar la `agentVersion` como `DRAFT`. Para obtener más información sobre los campos obligatorios y opcionales, consulte [Aumento de la generación de respuestas para el agente con una base de conocimientos](agents-kb-add.md).

Para aplicar cambios al borrador de trabajo, envíe una solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Incluya el `agentId` en la solicitud. Los cambios se aplican a la versión `DRAFT` a la que apunta el alias `TSTALIASID`.

------

# Desasociar una base de conocimientos de un agente
<a name="agents-kb-delete"></a>

Para obtener información sobre cómo asociar una base de conocimiento a un agente existente, seleccione la pestaña correspondiente al método que prefiera y siga estos pasos:

------
#### [ Console ]

**Desasociación de una base de conocimientos de un agente**

1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**.

1. Elija **Editar en el Creador de agentes**.

1. En la sección **Bases de conocimientos**, seleccione el botón de opción situado junto a la base de conocimiento que desea quitar. A continuación, elija **Eliminar**.

1. Confirme el mensaje que aparece y, a continuación, seleccione **Eliminar**.

1. Para aplicar los cambios que ha realizado en el agente antes de probarlo, seleccione **Preparar** en la ventana **Probar** o en la parte superior de la página **Borrador de trabajo**.

------
#### [ API ]

Para desasociar una base de conocimiento de un agente, envíe una solicitud [DisassociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DisassociateAgentKnowledgeBase.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Especifique el `knowledgeBaseId`, el `agentId` y la `agentVersion` del agente del que desea desasociarla.

Para aplicar cambios al borrador de trabajo, envíe una solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Incluya el `agentId` en la solicitud. Los cambios se aplican a la versión `DRAFT` a la que apunta el alias `TSTALIASID`.

------