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 e integración de un agente de Amazon Bedrock en su aplicación.

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 elAPI, el borrador de trabajo es la DRAFT versión. Para enviar la información a su agente, utilice InvokeAgentcon el alias de prueba o un alias diferente que apunte a una versión estática. TSTALIASID

Para ayudar a solucionar el comportamiento del agente, los agentes de Amazon Bedrock ofrecen la posibilidad de ver el rastreo durante una sesión con el agente. La traza muestra el proceso de step-by-step razonamiento del agente. Para obtener más información sobre el rastreo, consulte Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace.

A continuación se explican los pasos para probar el agente. Elija la pestaña del método que prefiera y, a continuación, siga los pasos:

Console

Prueba de un agente

1. Inicie sesión en el AWS Management Console uso de un IAMrol con los permisos de Amazon Bedrock y abra la consola de Amazon Bedrock en. https://console.aws.amazon.com/bedrock/

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

3. En la sección Agentes, seleccione el enlace del agente que desea probar en la lista de agentes.

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

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

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

7. (Opcional) Para seleccionar el rendimiento aprovisionado para su alias, el texto que aparece debajo del alias de prueba que ha seleccionado indicará que utiliza ODT o utiliza 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.

8. (Opcional) Para usar un mensaje de Prompt Management, seleccione el icono de opciones ( ) en el cuadro de mensaje y elija Importar mensaje. Seleccione el mensaje y la versión. Introduzca los valores de las variables de solicitud en la sección Valores de las variables de prueba. Para obtener más información sobre las solicitudes en la gestión de solicitudes, consulteCreación y almacenamiento de peticiones reutilizables con la administración de peticiones en Amazon Bedrock.

9. 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 rastreo. El rastreo se actualiza en tiempo real para que pueda verlo antes de que se devuelva la respuesta. Para expandir o contraer el rastreo, seleccione una flecha junto a un paso. Para obtener más información sobre la ventana Rastreo y los detalles que se muestran, consulte Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace.

   • 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 función API o para la acción y, a continuación, seleccione Enviar para generar una respuesta del agente. Para ver un ejemplo, consulte la siguiente imagen:

     

   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 Rastreo, seleccione el icono de expansión. Para cerrar la ventana Rastreo, 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 el AWS Management Console uso de un IAMrol con los permisos de Amazon Bedrock y abra la consola de Amazon Bedrock en. https://console.aws.amazon.com/bedrock/

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

3. En la sección Agentes, seleccione el enlace del agente que desea probar en la lista de agentes.

4. En la página de detalles del agente, en la sección Borrador de trabajo, seleccione el enlace para el Borrador de trabajo.

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

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

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

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

API

Antes de hacer la prueba a su agente por primera vez, debe empaquetarlo con los cambios en borrador mediante el envío de un PrepareAgentsolicite con un punto final de tiempo de compilación de Agents for Amazon Bedrock. Incluya el agentId en la solicitud. Los cambios se aplican a la versión DRAFT a la que apunta el alias TSTALIASID.

Ver ejemplos de código

nota

Cada vez que actualice el borrador de trabajo, deberá preparar al agente para empaquetarlo con los cambios más recientes. Como práctica recomendada, le recomendamos que envíe un GetAgentsolicite (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un punto final de tiempo de compilación de Agents for Amazon Bedrock y compruebe la preparedAt hora de su agente para comprobar que está probando su agente con las configuraciones más recientes.

Para probar a su agente, envíe un InvokeAgentsolicitud con un punto final de ejecución de Agents for Amazon Bedrock.

nota

El AWS CLI no es compatible InvokeAgent.

Ver ejemplos de código

La solicitud incluye los siguientes campos:

• Como mínimo, debe rellenar los siguientes campos obligatorios:

  Campo	Descripción breve
  agentId	ID del agente
  agentAliasId	Es el ID del alias. Utilice TSTALIASID para invocar la versión DRAFT
  sessionId	ID alfanumérico de la sesión (de 2 a 100 caracteres)
  inputText	Petición del usuario que se envía al agente

• Los siguientes campos son opcionales:

  Campo	Descripción breve
  enableTrace	Especifique TRUE para ver el rastreo.
  endSession	Especifique TRUE para finalizar la sesión con el agente después de esta solicitud.
  sessionState	Incluye el contexto que influye en el comportamiento del agente o en el comportamiento de las bases de conocimientos asociadas al agente. Para obtener más información, consulte Contexto de sesión del agente de control.

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. Si el agente ha consultado una base de conocimientos, el chunk también incluye citations. También se pueden devolver los siguientes objetos:

• Si ha activado el rastreo, 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 rastreo, consulte Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace.

• Si configura el grupo de acciones para que se omita mediante una función Lambda, se devuelve un ReturnControlPayloadobjeto en el returnControl campo. La estructura general del ReturnControlPayloadobjeto es la siguiente:

  {
      "invocationId": "string",
      "invocationInputs": [
          ApiInvocationInput or FunctionInvocationInput,
          ...
      ]
  }

  Cada miembro de la lista invocationInputs es uno de los siguientes objetos:

  • Se debe llamar a un ApiInvocationInputobjeto que contiene la API operación que el agente predice en función de la entrada del usuario, además de los parámetros y demás información que obtiene del usuario para cumplirla. API La estructura del objeto ApiInvocationInput es la siguiente:

    {
        "actionGroup": "string",
        "apiPath": "string",
        "httpMethod": "string",
        "parameters": [
            {
                "name": "string",
                "type": "string",
                "value": "string"
            },
            ...
        ],
        "requestBody": {
            <content-type>: {
                "properties": [
                    {
                        "name": "string",
                        "type": "string",
                        "value": "string"
                    }
                ]
            }
        }
    }

  • Se debe llamar a un FunctionInvocationInputobjeto que contenga la función que predice el agente en función de la entrada del usuario, además de los parámetros de esa función que obtenga del usuario. La estructura del FunctionInvocationInputes la siguiente:

    {
        "actionGroup": "string",
        "function": "string",
        "parameters": [
            {
                "name": "string",
                "type": "string",
                "value": "string"
            }
        ]
    }