Agregación de un grupo de acciones al agente en Amazon Bedrock

Tras configurar el OpenAPI esquema y función Lambda para su grupo de acciones, puede crear el grupo de acciones. Elija la pestaña del método que prefiera y, a continuación, siga los pasos:

nota

Si estás usando Anthropic Claude 3.5 Sonnet, asegúrese de que el nombre de la herramienta, que tendrá el formato, httpVerb__actionGroupName__apiName siga el formato ^[a-zA-Z0-9_-]{1,64}$ de nombre de la herramienta antrópica. Su actionGroupName y no apiName deben contener guiones bajos '__' dobles.

Console

Al crear un agente, puede añadir grupos de acciones al borrador de trabajo.

Una vez creado un agente, puede añadirle grupos de acciones siguiendo estos pasos:

Adición de un grupo de acciones a 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. Elija Editar en el Creador de agentes.

4. Seleccione Agregar en la sección Grupos de acciones.

5. (Opcional) En la sección Detalles del grupo de acciones, cambie el nombre generado automáticamente y proporcione 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. Definir con detalles de 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, consulte Definición de los detalles de las funciones de los grupos de acciones de su agente en Amazon Bedrock.

   2. Definir con API esquemas: defina las API operaciones que el agente puede invocar y los parámetros. Utilice un API esquema abierto 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 API esquema abierto, consulte Definir OpenAPI esquemas para los grupos de acción de su agente 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 función API o que debe invocar y recibir los parámetros que necesita. Seleccione 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 función API o 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 función API o que prediga y los parámetros, en función de la sesión, a la función Lambda.

     nota

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

   • Control de devolución: en lugar de pasar los parámetros de la función API o 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ó en la sesión, en InvokeAgentrespuesta. Para obtener más información, consulte Devolución del control al desarrollador del agente al enviar la información obtenida en una respuesta de InvokeAgent.

8. Según el Tipo de grupo de acciones que elija, verá una de las siguientes secciones:

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

     1. Proporcione un nombre y también se recomienda incluir una descripción (opcional).

     2. Para solicitar la confirmación del usuario antes de invocar la función, seleccione Activado. Solicitar una confirmación antes de invocar la función puede impedir que su aplicación tome medidas debido a inyecciones de peticiones maliciosas.

     3. En la subsección Parámetros, elija Agregar parámetro. Defina los campos siguientes:

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

     4. Para agregar otro parámetro, seleccione Agregar parámetro.

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

     6. 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 JSON objeto, elija JSONeditor en lugar de Tabla. El formato del JSON objeto 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 su grupo de acciones definiendo otro conjunto de parámetros, seleccione Agregar función de grupo de acciones.

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

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

     • Para definir el API esquema abierto 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 S3 URI 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 ha definido un API esquema, aparecerá un indicador verde de confirmación 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 API esquema.

10. No olvide seleccionar Preparar para aplicar los cambios que haya realizado en el agente antes de probarlo.

API

Para crear un grupo de acciones, envíe un CreateAgentActionGroupsolicite con un punto final de tiempo de compilación de Agents for Amazon Bedrock. Debe proporcionar un esquema de funciones o un esquema abierto. API

Ver ejemplos de código

En la siguiente lista se describen los campos de la solicitud:

• Los siguientes campos son obligatorios:

  Campo	Descripción breve
  agentId	Es el ID del agente al que pertenece el grupo de acciones.
  agentVersion	Es la versión del agente a la que pertenece el grupo de acciones.
  actionGroupName	Es el nombre del grupo de acciones.

• Para definir los parámetros del grupo de acciones, debe especificar uno de los siguientes campos (no puede especificar ambos).

  Campo	Descripción breve
  functionSchema	Define los parámetros del grupo de acciones que el agente obtiene del usuario. Para obtener más información, consulte Definición de los detalles de las funciones de los grupos de acciones de su agente en Amazon Bedrock.
  apiSchema	Especifica el API esquema Open que define los parámetros del grupo de acciones o los enlaces a un objeto de S3 que lo contiene. Para obtener más información, consulte Definir OpenAPI esquemas para los grupos de acción de su agente en Amazon Bedrock.

  A continuación se muestra el formato general del functionSchema y apiSchema:

  • Cada elemento de la functionSchema matriz es un FunctionSchemaobjeto. Para cada función, especifique lo siguiente:

    • Proporcione un name. También se recomienda incluir una description (opcional).

    • Si lo desea, especifique ENABLED para el campo requireConfirmation para solicitar la confirmación del usuario antes de invocar la función. Solicitar una confirmación antes de invocar la función puede impedir que su aplicación tome medidas debido a inyecciones de peticiones maliciosas.

    • En el parameters objeto, cada clave es un nombre de parámetro, asignado a los detalles sobre él en un ParameterDetailobjeto.

    La forma general del functionSchema es la siguiente:

    "functionSchema": [
        {
            "name": "string",
            "description": "string",
            "requireConfirmation": ENABLED | DISABLED,
            "parameters": {
                "<string>": {
                    "type": "string" | number | integer | boolean | array,
                    "description": "string",
                    "required": boolean
                },
                ... // up to 5 parameters
            }
        },
        ... // up to 11 functions
    ]

  • APISchemaPuede tener uno de los siguientes formatos:

    1. Para el siguiente formato, puede pegar directamente el formato JSON o YAML OpenAPI esquema como valor.

       "apiSchema": {
           "payload": "string"
       }

    2. Para el siguiente formato, especifique el nombre del bucket de Amazon S3 y la clave de objeto donde OpenAPI se almacena el esquema.

       "apiSchema": {
           "s3": {
               "s3BucketName": "string",
               "s3ObjectKey": "string"
           }
       }

• Para configurar la forma en que el grupo de acciones gestiona la invocación del grupo de acciones tras obtener los parámetros del usuario, debe especificar uno de los siguientes campos dentro del campo actionGroupExecutor.

  Campo	Descripción breve
  lambda	Para enviar los parámetros a una función de Lambda para gestionar los resultados de la invocación del grupo de acciones, especifique el nombre de recurso de Amazon (ARN) de la Lambda. Para obtener más información, consulte Configuración de las funciones de Lambda para enviar la información que un agente de Amazon Bedrock obtiene del usuario.
  customControl	Para omitir el uso de una función de Lambda y, en su lugar, devolver el grupo de acciones previsto, además de los parámetros y la información necesarios para ello, en la respuesta InvokeAgent, especifique RETURN_CONTROL. Para obtener más información, consulte Devolución del control al desarrollador del agente al enviar la información obtenida en una respuesta de InvokeAgent.

• Los siguientes campos son opcionales:

  Campo	Descripción breve
  parentActionGroupFirma	Especifique AMAZON.UserInput para permitir que el agente vuelva a solicitar al usuario más información si no tiene suficiente información para completar otro grupo de acciones. Debe dejar los campos description, apiSchema y actionGroupExecutor en blanco si especifica este campo.
  description	Es una descripción del grupo de acciones.
  actionGroupState	Indica si se debe permitir que el agente invoque el grupo de acciones o no.
  clientToken	Es un identificador para evitar que las solicitudes se dupliquen.