Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

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

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

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.

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.

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:

  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 ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ) 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.

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:

  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 ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ) 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.

PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.