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.
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
-
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/
-
En el panel de navegación de la izquierda, seleccione Agentes. A continuación, elija un agente en la sección Agentes.
-
Elija Editar en el Creador de agentes.
-
Seleccione Agregar en la sección Grupos de acciones.
-
(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.
-
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:
-
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.
-
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
-
-
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.
-
-
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:
-
Proporcione un nombre y también se recomienda incluir una descripción (opcional).
-
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.
-
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. -
Para agregar otro parámetro, seleccione Agregar parámetro.
-
Para editar un campo de un parámetro, selecciónelo y edítelo según sea necesario.
-
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.
-
Seleccione el formato del esquema mediante el menú desplegable situado junto a Formato.
-
Para importar un esquema existente de S3 para editarlo, seleccione Importar esquema, proporcione el S3 URI y seleccione Importar.
-
Para restaurar el esquema al esquema de ejemplo original, seleccione Restablecer y, a continuación, confirme el mensaje que aparece seleccionando Restablecer nuevamente.
-
-
-
-
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.
-
-
No olvide seleccionar Preparar para aplicar los cambios que haya realizado en el agente antes de probarlo.