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.
# Prueba y solución de problemas de comportamiento del agente
Cuando cree un agente, tendrá un *borrador de trabajo*. El borrador de trabajo es una versión del agente que puede utilizar para compilar de forma iterativa el agente. Cada vez que realice cambios en el agente, se actualizará el borrador de trabajo. Cuando esté satisfecho con las configuraciones del agente, puede crear una *versión*, que es una instantánea del agente, y un *alias*, que apunta hacia la versión. A continuación, podrá implementar el agente en sus aplicaciones llamando al alias. Para obtener más información, consulte [Implementación y uso de un agente de Amazon Bedrock en su aplicación](agents-deploy.md).
En la siguiente lista se describe cómo se prueba un agente:
+ En la consola de Amazon Bedrock, abra la ventana de prueba lateral y envíe información para que el agente responda. Puede seleccionar el borrador de trabajo o una versión que haya creado.
+ En la API, el borrador de trabajo es la versión `DRAFT`. La información se envía al agente con [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) con el alias de prueba `TSTALIASID` o con un alias diferente que apunte hacia una versión estática. Para poder probar su agente, debe prepararlo llamando a [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html).
## Seguimiento del comportamiento del agente
Para ayudar a solucionar el comportamiento del agente, los agentes de Amazon Bedrock ofrecen la posibilidad de ver el *seguimiento* durante una sesión con el agente. El seguimiento muestra el proceso de razonamiento del agente, paso a paso. Para obtener más información sobre el seguimiento, consulte [Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace](trace-events.md).
## Prueba del agente
A continuación se explican los pasos para probar el agente. Elija la pestaña del método que prefiera y siga estos pasos:
------
#### [ Console ]
**Prueba 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. En la sección **Agentes**, seleccione el enlace del agente que desea probar en la lista de agentes.
1. La ventana **Prueba** aparecerá en un panel a la derecha.
**nota**
Si la **Ventana de prueba** está cerrada, puede volver a abrirla seleccionando **Prueba** en la parte superior de la página de detalles del agente o en cualquier página de la misma.
1. Después de crear el agente, debe empaquetarlo con los cambios del borrador de trabajo preparándolo de una de las siguientes maneras:
+ En la ventana **Prueba**, seleccione **Preparar**.
+ En la página **Borrador de trabajo**, seleccione **Preparar** en la parte superior de la página.
**nota**
Cada vez que actualice el borrador de trabajo, deberá preparar al agente para empaquetarlo con los cambios más recientes. Se recomienda comprobar siempre la hora de **Preparado por última vez** del agente en la sección **Descripción general del agente** de la página de **Borrador de trabajo** para comprobar que esté probando el agente con las configuraciones más recientes.
1. Utilice el menú desplegable de la parte superior de la **ventana de prueba** para elegir un alias y la versión asociada a probar. De forma predeterminada, está seleccionada la combinación **TestAlias: borrador de trabajo**.
1. (Opcional) Para seleccionar el rendimiento aprovisionado para el alias, el texto que aparece debajo del alias de prueba que ha seleccionado indicará **Uso de ODT** o **Uso de PT**. Para crear un modelo de rendimiento aprovisionado, seleccione **Cambiar**. Para obtener más información, consulte [Aumento de la capacidad de invocación de modelos con el rendimiento aprovisionado en Amazon Bedrock](prov-throughput.md).
1. (Opcional) Para usar una petición de Administración de peticiones, seleccione el icono de opciones (![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)) en el cuadro de mensaje y elija **Importar petición**. Seleccione la petición y la versión. Introduzca los valores de las variables de la petición en la sección **Valores de las variables de prueba**. Para obtener más información sobre las peticiones en Administración de peticiones, consulte [Creación y almacenamiento de peticiones reutilizables con la administración de peticiones en Amazon Bedrock](prompt-management.md).
1. Para probar el agente, introduzca un mensaje y seleccione **Ejecutar**. Mientras espera a que se genere la respuesta o después de que se genere, tiene las siguientes opciones:
+ Para ver los detalles de cada paso del proceso de orquestación del agente, incluidos la petición, las configuraciones de inferencia y el proceso de razonamiento del agente para cada paso, así como el uso de sus grupos de acción y bases de conocimientos, seleccione **Mostrar seguimiento**. El seguimiento se actualiza en tiempo real para que pueda verlo antes de que se devuelva la respuesta. Para expandir o contraer el seguimiento, seleccione una flecha junto a un paso. Para obtener más información sobre la ventana **Seguimiento** y los detalles que se muestran, consulte [Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace](trace-events.md).
+ Si el agente invoca una base de conocimientos, la respuesta contendrá notas a pie de página. Para ver el enlace al objeto S3 que contiene la información citada para una parte específica de la respuesta, seleccione la nota a pie de página correspondiente.
+ Si configura su agente para que devuelva el control en lugar de utilizar una función de Lambda para gestionar el grupo de acciones, la respuesta incluirá la acción prevista y sus parámetros. Proporcione un ejemplo de valor de salida de la API o función para la acción y, a continuación, seleccione **Enviar** para generar una respuesta del agente. Para ver un ejemplo, consulte la siguiente imagen:
![\[Solicitud de ventana de prueba para proporcionar un resultado de ejemplo para la acción.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/agents/roc-testwindow.png)
Puede realizar las siguientes acciones en la ventana **Prueba**:
+ Para iniciar una nueva conversación con el agente, seleccione el icono de actualización.
+ Para ver la ventana **Seguimiento**, seleccione el icono de expansión. Para cerrar la ventana **Seguimiento**, seleccione el icono de reducción.
+ Para cerrar la ventana **Prueba**, seleccione el icono de la flecha hacia la derecha.
Los grupos de acciones y las bases de conocimientos se pueden activar o desactivar. Utilice esta característica para depurar el agente y determinar qué acciones o bases de conocimientos deben actualizarse y evaluar su comportamiento con distintos ajustes.
**Para activar un grupo de acciones o 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. En la sección **Agentes**, seleccione el enlace del agente que desea probar en la lista de agentes.
1. En la página de detalles del agente, en la sección **Borrador de trabajo**, seleccione el enlace para el **Borrador de trabajo**.
1. En la sección **Grupos de acciones** o **Base de conocimientos**, pase el cursor sobre el **Estado** del grupo de acciones o de la base de conocimientos cuyo estado desea cambiar.
1. Aparece un botón de edición. Seleccione el icono de edición y, a continuación, elija en el menú desplegable si el grupo de acciones o la base de conocimientos están **activados** o **desactivados**.
1. Si un grupo de acciones está **desactivado**, significa que el agente no usa el grupo de acciones. Si una base de conocimientos está **desactivada**, significa que el agente no usa la base de conocimientos. Active o desactive los grupos de acciones o las bases de conocimientos y, a continuación, utilice la ventana de **prueba** para solucionar los problemas del agente.
1. Seleccione **Preparar** para aplicar los cambios que haya realizado al agente antes de probarlo.
------
#### [ API ]
Para los agentes que se crearon `after` 31 de marzo de 2025:
+ Si ha creado el agente en la consola, la transmisión está habilitada de forma predeterminada. Puede desactivar la transmisión en cualquier momento.
+ Asegúrese de que el rol de ejecución del agente incluya el permiso `bedrock:InvokeModelWithResponseStream` para el modelo de agente configurado.
Antes de probar el agente por primera vez, debe empaquetarlo con los cambios realizados en el borrador de trabajo enviando 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`.
```
def prepare_agent(self, agent_id):
"""
Creates a DRAFT version of the agent that can be used for internal testing.
:param agent_id: The unique identifier of the agent to prepare.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
prepared_agent_details = self.client.prepare_agent(agentId=agent_id)
except ClientError as e:
logger.error(f"Couldn't prepare agent. {e}")
raise
else:
return prepared_agent_details
```
Para obtener más información, consulte [Introducción a Agentes de Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
**nota**
Cada vez que actualice el borrador de trabajo, deberá preparar al agente para empaquetarlo con los cambios más recientes. Se recomienda enviar una solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html) (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) 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) y consultar la hora `preparedAt` para que el agente compruebe que usted está probando el agente con las configuraciones más recientes.
Para probar su agente, envíe una 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) al agente. Para ver el código de ejemplo, consulte [Invocación de un agente desde su aplicación](agents-invoke-agent.md).
**nota**
La AWS CLI no es compatible con [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).
La solicitud incluye los siguientes campos:
+ Como mínimo, debe rellenar los siguientes campos obligatorios:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/agents-test.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-test.html)
La respuesta se devuelve en un flujo de eventos. Cada evento contiene un `chunk`, que incluye parte de la respuesta en el campo `bytes`, que debe descodificarse. También se pueden devolver los siguientes objetos:
+ Si el agente ha consultado una base de conocimientos, el `chunk` también incluye `citations`.
+ Si la transmisión está habilitada y la barrera de protección está configurada para el agente, la respuesta se genera en los intervalos de caracteres especificados para el intervalo de la barrera de protección. De forma predeterminada, este intervalo está establecido en 50 caracteres.
+ Si ha activado el seguimiento, también se devuelve un objeto `trace`. Si se produce un error, se devuelve un campo con el mensaje de error. Para obtener más información sobre cómo leer el seguimiento, consulte [Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace](trace-events.md).
+ Si configura el grupo de acciones para que se omita mediante una función de Lambda, se devuelve un objeto [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html) en el campo `returnControl`. La estructura general del objeto [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html) es la siguiente:
```
{
"invocationId": "string",
"invocationInputs": [
[ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) or [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html),
...
]
}
```
Cada miembro de la lista `invocationInputs` es uno de los siguientes objetos:
+ Un objeto [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) que contiene la operación de la API que el agente predice que se debe llamar en función de la entrada del usuario, además de los parámetros y demás información que obtiene del usuario para cumplir con la API. La estructura de un objeto [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) es la siguiente:
```
{
"actionGroup": "string",
"apiPath": "string",
"httpMethod": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"requestBody": {
: {
"properties": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
}
}
```
+ Se debe llamar a un objeto [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html) que contiene la función que predice el agente en función de la entrada del usuario. También se debe llamar a los parámetros de esa función que obtiene del usuario. La estructura de [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html) es la siguiente:
```
{
"actionGroup": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
```
------