Crear y configurar el agente manualmente - 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.

Crear y configurar el agente manualmente

Para crear un agente con Amazon Bedrock, debe configurar los siguientes componentes:

  • La configuración del agente, que define el propósito del agente e indica el modelo básico (FM) que utiliza para generar solicitudes y respuestas.

  • Al menos uno de los siguientes:

    • Grupos de acciones que definen las acciones para las que está diseñado el agente.

    • Una base de conocimientos de fuentes de datos para aumentar las capacidades generativas del agente al permitir la búsqueda y la consulta.

Como mínimo, puede crear un agente que solo tenga un nombre. Para preparar un agente de forma que pueda probarlo o desplegarlo, debe configurar como mínimo los siguientes componentes:

Configuración Descripción
Función de recurso de agente El rol ARN de servicio con permisos para llamar a API las operaciones del agente
Modelo básico (FM) Un FM para que el agente lo invoque para realizar la orquestación
Instrucciones Lenguaje natural que describe lo que debe hacer el agente y cómo debe interactuar con los usuarios

También debe configurar al menos un grupo de acciones o una base de conocimientos para el agente. Si prepara un agente sin grupos de acción ni bases de conocimientos, devolverá las respuestas basándose únicamente en la FM y en las instrucciones y plantillas de solicitudes básicas.

Para saber cómo crear un agente, selecciona la pestaña correspondiente al método que prefieras y sigue estos pasos:

Console
Para crear 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. Seleccione Agentes en el panel de navegación izquierdo.

  3. En la sección Agentes, elija Crear agente.

  4. (Opcional) Cambie el nombre generado automáticamente para el agente y proporcione una descripción opcional para el agente.

  5. Seleccione Crear. Se crea su agente y se le redirigirá al generador de agentes del agente recién creado, donde podrá configurarlo.

  6. Puede continuar con el siguiente procedimiento para configurar su agente o volver al Agent Builder más adelante.

Para configurar su agente

  1. Si aún no está en el generador de agentes, haga lo siguiente:

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

  2. En la sección de detalles del agente, puede configurar las siguientes configuraciones:

    1. Edite el nombre o la descripción del agente.

    2. Para el rol de recurso de agente, seleccione una de las siguientes opciones:

      • Cree y utilice un nuevo rol de servicio: deje que Amazon Bedrock cree el rol de servicio y configure los permisos necesarios en su nombre.

      • Use un rol de servicio existente: use un rol personalizado que haya configurado previamente.

    3. En el modelo Select, selecciona un FM para que tu agente lo invoque durante la orquestación.

    4. En Instrucciones para el agente, introduzca los detalles para decirle al agente lo que debe hacer y cómo debe interactuar con los usuarios. Las instrucciones sustituyen al marcador de posición $instructions$ en la plantilla de solicitud de orquestación. A continuación se muestra un ejemplo de instrucciones:

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    5. Si expande la configuración adicional, puede modificar las siguientes configuraciones:

      • Intérprete de código: (opcional) Elija si desea permitir que el agente se encargue de las tareas que implican escribir, ejecutar, probar y solucionar problemas del código. Para obtener más información, consulte Genere, ejecute y pruebe código con la interpretación del código.

      • Entrada del usuario: (opcional) elija si desea permitir que el agente solicite más información al usuario si no tiene suficiente información. Para obtener más información, consulte Configure el agente para solicitar información al usuario.

      • KMSselección de claves: (opcional) De forma predeterminada, AWS cifra los recursos del agente con una clave AWS administrada. Para cifrar a su agente con su propia clave gestionada por el cliente, en la sección de selección de KMS claves, seleccione Personalizar la configuración de cifrado (avanzada). Para crear una clave nueva, selecciona Crear una AWS KMS clave y, a continuación, actualiza esta ventana. Para usar una clave existente, selecciona una clave en Elige una AWS KMS clave.

      • Tiempo de espera de la sesión inactiva: de forma predeterminada, si un usuario no ha respondido durante 30 minutos en una sesión con un agente de Amazon Bedrock, el agente ya no conserva el historial de conversaciones. El historial de conversaciones se utiliza tanto para reanudar una interacción como para aumentar las respuestas en función del contexto de la conversación. Para cambiar este período de tiempo predeterminado, introduzca un número en el campo Tiempo de espera de la sesión y elija una unidad de tiempo.

    6. En la sección de IAMpermisos, en el rol de recurso de agente, elija un rol de servicio. Para permitir que Amazon Bedrock cree el rol de servicio en su nombre, elija Crear y usar un nuevo rol de servicio. Para usar un rol personalizado que haya creado anteriormente, elija Usar un rol de servicio existente.

      nota

      El rol de servicio que Amazon Bedrock crea para usted no incluye permisos para las funciones que se encuentran en versión preliminar. Para usar estas funciones, asocie los permisos correctos al rol de servicio.

    7. (Opcional) De forma predeterminada, AWS cifra los recursos del agente con un Clave administrada de AWS. Para cifrar a su agente con su propia clave gestionada por el cliente, en la sección de selección de KMS claves, seleccione Personalizar la configuración de cifrado (avanzada). Para crear una clave nueva, selecciona Crear una AWS KMS clave y, a continuación, actualiza esta ventana. Para usar una clave existente, selecciona una clave en Elige una AWS KMS clave.

    8. (Opcional) Para asociar etiquetas a este agente, en la sección Etiquetas: opcional, selecciona Añadir nueva etiqueta y proporciona un par clave-valor.

    9. Cuando haya terminado de configurar la configuración del agente, seleccione Siguiente.

  3. En la sección Grupos de acciones, puede elegir Agregar para agregar grupos de acciones a su agente. Para obtener más información sobre la configuración de grupos de acción, consulteUse grupos de acciones para definir las acciones que debe realizar su agente. Para obtener información sobre cómo añadir grupos de acciones a su agente, consulteAñada un grupo de acción a su agente en Amazon Bedrock.

  4. En la sección Bases de conocimiento, puede elegir Añadir para asociar grupos de conocimiento a su agente. Para obtener más información sobre la configuración de bases de conocimiento, consulteRecupere datos y genere respuestas de IA con bases de conocimiento. Para obtener información sobre cómo asociar las bases de conocimiento con su agente, consulteAumente la generación de respuestas para su agente con una base de conocimientos.

  5. En la sección de detalles de las barandillas, puede elegir Editar para asociar una barandilla a su agente y bloquear y filtrar el contenido dañino. Seleccione la barandilla que desee utilizar en el menú desplegable de la sección Seleccionar barandilla y, a continuación, elija la versión que desee utilizar en la sección Versión de barandilla. Puede seleccionar Ver para ver la configuración de la barandilla. Para obtener más información, consulte Detenga el contenido dañino en los modelos que utilizan Amazon Bedrock Guardrails.

  6. En la sección de mensajes avanzados, puede elegir Editar para personalizar los mensajes que su agente envía a la FM en cada paso de la organización. Para obtener más información sobre las plantillas de mensajes que puede utilizar para la personalización, consulte. Mejore la precisión de los agentes con plantillas de avisos avanzadas en Amazon Bedrock Para obtener información sobre cómo configurar las solicitudes avanzadas, consulte.

  7. Cuando termine de configurar el agente, seleccione una de las siguientes opciones:

    • Para permanecer en el generador de agentes, seleccione Guardar. A continuación, puede preparar el agente para probarlo con las configuraciones actualizadas en la ventana de pruebas. Para obtener información sobre cómo probar su agente, consulteProbar y solucionar problemas de comportamiento de los agentes.

    • Para volver a la página de detalles del agente, selecciona Guardar y salir.

API

Para crear un agente, envíe un CreateAgentsolicitud (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.

Consulte los ejemplos de código

Para preparar el agente y probarlo o desplegarlo, de modo que pueda probarlo o desplegarlo, debe incluir como mínimo los siguientes campos (si lo prefiere, puede omitir estas configuraciones y configurarlas más adelante enviando un UpdateAgentsolicitud):

Campo Caso de uso
agentResourceRoleArn Para especificar una función ARN de servicio con permisos para llamar a API las operaciones del agente
foundationModel Para especificar un modelo básico (FM) con el que el agente pueda orquestar
instrucción Proporcionar instrucciones para decirle al agente lo que debe hacer. Se utiliza en el marcador de posición $instructions$ de la plantilla de solicitud de orquestación.

Los siguientes campos son opcionales:

Campo Caso de uso
description Describe lo que hace el agente
idleSessionTTLInSeconds Duración tras la cual el agente finaliza la sesión y elimina la información almacenada.
customerEncryptionKeyArn ARNde una KMS clave para cifrar los recursos del agente
etiquetas Para asociar etiquetas a su agente.
promptOverrideConfiguration Para personalizar las instrucciones que se envían a la FM en cada paso de la orquestación.
guardrailConfiguration Para añadir una barandilla al agente. Especifique el identificador ARN de la barandilla y la versión que se va a utilizar.
clientToken Identificador para garantizar que la API solicitud se complete solo una vez.

La respuesta devuelve un CreateAgentobjeto que contiene detalles sobre el agente recién creado. Si no se puede crear su agente, el CreateAgentel objeto de la respuesta devuelve una lista de failureReasons y una lista de recommendedActions para que pueda solucionar los problemas.