Añada un grupo de acción a su agente en Amazon Bedrock

Para añadir un grupo de acciones a un agente

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

2. Seleccione Agentes en el panel de navegación izquierdo. A continuación, elija un agente en la sección Agentes.

3. Elija Editar en Agent Builder.

4. En la sección Grupos de acciones, elija Agregar.

5. (Opcional) En la sección de detalles del grupo de acciones, cambia el nombre generado automáticamente y proporciona una descripción opcional para el grupo de acciones.

6. En la sección Tipo de grupo de acciones, seleccione uno de los siguientes métodos para definir los parámetros que el agente puede obtener de los usuarios para ayudar a llevar a cabo las acciones:

   1. Defina con los detalles de la función: defina los parámetros que el agente debe obtener del usuario para llevar a cabo las acciones. Para obtener más información sobre cómo añadir funciones, consulteDefina los detalles de las funciones de los grupos de acción de su agente en Amazon Bedrock.

   2. Definir con esquemas de API: defina las operaciones de API que el agente puede invocar y los parámetros. Utilice un esquema de OpenAPI que haya creado o utilice el editor de texto de la consola para crear el esquema. Para obtener más información sobre la configuración de un esquema de OpenAPI, consulte Defina OpenAPI esquemas para los grupos de acción de sus agentes en Amazon Bedrock

7. En la sección de invocación de grupos de acciones, se configura lo que hace el agente después de predecir la API o función que debe invocar y recibir los parámetros que necesita. Elija una de las siguientes opciones:

   • Creación rápida de una nueva función Lambda (se recomienda): deje que Amazon Bedrock cree una función Lambda básica para su agente que luego pueda modificar según su caso AWS Lambda de uso. El agente pasará la API o función que prediga y los parámetros, en función de la sesión, a la función Lambda.

   • Seleccione una función Lambda existente: elija una función Lambda que haya creado anteriormente AWS Lambda y la versión de la función que desee utilizar. El agente pasará la API o función que prediga y los parámetros, en función de la sesión, a la función Lambda.

     nota

     Para permitir que el director del servicio de Amazon Bedrock acceda a la función Lambda, adjunte una política basada en recursos a la función Lambda para permitir que el director del servicio de Amazon Bedrock acceda a la función Lambda.

   • Control de devolución: en lugar de pasar los parámetros de la API o función que predice a la función Lambda, el agente devuelve el control a la aplicación pasando la acción que predice que se debe invocar, además de los parámetros y la información de la acción que determinó a partir de la sesión, en la respuesta. InvokeAgent Para obtener más información, consulte Devuelva el control al desarrollador del agente enviando la información obtenida en una respuesta InvokeAgent .

8. Según el tipo de grupo de acciones que elijas, verás una de las siguientes secciones:

   • Si seleccionaste Definir con detalles de la función, tendrás una sección de funciones del grupo de acciones. Haga lo siguiente para definir la función:

     1. Proporcione un nombre y una descripción opcional (pero recomendada).

     2. En la subsección Parámetros, elija Añadir parámetro. Defina los campos siguientes:

        Campo	Descripción
        Nombre	Asigne un nombre al parámetro.
        Descripción (opcional)	Describa el parámetro.
        Tipo	Especifique el tipo de datos del parámetro.
        Obligatoria	Especifique si el agente requiere el parámetro del usuario.

     3. Para añadir otro parámetro, elija Añadir parámetro.

     4. Para editar un campo de un parámetro, selecciónelo y edítelo según sea necesario.

     5. Para eliminar un parámetro, seleccione el icono de eliminación ( ) en la fila que contiene el parámetro.

     Si prefiere definir la función mediante un objeto JSON, elija el editor JSON en lugar de Tabla. El formato del objeto JSON es el siguiente (cada clave del parameters objeto es un nombre de parámetro que usted proporciona):

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     Para añadir otra función a tu grupo de acciones definiendo otro conjunto de parámetros, selecciona Añadir función de grupo de acciones.

   • Si seleccionaste Definir con esquemas de API, tendrás una sección de esquemas de grupos de acciones con las siguientes opciones:

     • Para usar un esquema de OpenAPI que haya preparado previamente con descripciones, estructuras y parámetros de API para el grupo de acción, seleccione Seleccionar esquema de API y proporcione un enlace al URI de Amazon S3 del esquema.

     • Para definir el esquema OpenAPI con el editor de esquemas en línea, seleccione Definir mediante el editor de esquemas en línea. Aparece un esquema de ejemplo que puede editar.

       1. Seleccione el formato del esquema mediante el menú desplegable situado junto a Formato.

       2. Para importar un esquema existente de S3 para editarlo, seleccione Importar esquema, proporcione el URI de S3 y seleccione Importar.

       3. Para restaurar el esquema al esquema de ejemplo original, seleccione Restablecer y, a continuación, confirme el mensaje que aparece seleccionando Restablecer nuevamente.

9. Cuando haya terminado de crear el grupo de acciones, elija Agregar. Si has definido un esquema de API, aparecerá un aviso de éxito verde si no hay ningún problema. Si hay problemas al validar el esquema, aparece un banner rojo. Dispone de las opciones siguientes:

   • Desplácese por el esquema para ver las líneas en las que existe un error o una advertencia sobre el formato. Una X indica un error de formato, mientras que un signo de exclamación indica una advertencia sobre el formato.

   • Seleccione Ver detalles en el banner rojo para ver una lista de errores relacionados con el contenido del esquema de la API.

10. Asegúrese de estar preparado para aplicar los cambios que ha realizado al agente antes de probarlo.