Implemente e integre un agente de Amazon Bedrock en su aplicación - 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.

Implemente e integre un agente de Amazon Bedrock en su aplicación

Al crear un agente de Amazon Bedrock por primera vez, dispondrá de una versión preliminar (DRAFT) y un alias de prueba (TSTALIASID) que apunta a la versión preliminar de trabajo. Cuando realiza cambios en su agente, los cambios se aplican al borrador de trabajo. Repites tu borrador de trabajo hasta que estés satisfecho con el comportamiento de tu agente. A continuación, puede configurar el agente para su despliegue e integración en la aplicación mediante la creación de los alias del agente.

Para implementar su agente, debe crear un alias. Durante la creación del alias, Amazon Bedrock crea automáticamente una versión de su agente. El alias apunta a esta versión recién creada. Como alternativa, puede apuntar el alias a una versión previamente creada de su agente. A continuación, configura la aplicación para realizar API llamadas a ese alias.

Una versión es una instantánea que conserva el recurso tal como estaba en el momento de su creación. Puede seguir modificando el borrador de trabajo y crear nuevos alias (y, en consecuencia, versiones) de su agente según sea necesario. En Amazon Bedrock, puede crear una nueva versión de su agente mediante la creación de un alias que apunte a la nueva versión de forma predeterminada. Amazon Bedrock crea las versiones en orden numérico, empezando por 1.

Las versiones son inmutables porque actúan como una instantánea del agente en el momento en que lo creó. Para realizar actualizaciones en un agente en producción, debe crear una nueva versión y configurar la aplicación para que realice llamadas al alias que apunta a esa versión.

Con los alias, puede cambiar de forma eficaz entre distintas versiones de su agente sin necesidad de que la aplicación realice un seguimiento de la versión. Por ejemplo, puede cambiar un alias para que apunte a una versión anterior de su agente si hay cambios que necesita revertir rápidamente.

Para implementar su agente

  1. Cree un alias y una versión de su agente. Selecciona la pestaña correspondiente al método que prefieras y sigue los pasos:

    Console
    Para crear un alias (y, si lo desea, una nueva versión)

    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. En la sección Alias, selecciona Crear.

    4. Introduzca un nombre de alias único y proporcione una descripción opcional.

    5. En Asociar una versión, elija una de las siguientes opciones:

      • Para crear una nueva versión, elija Crear una nueva versión y asociarla a este alias.

      • Para usar una versión existente, elija Usar una versión existente para asociar este alias. En el menú desplegable, elige la versión a la que quieres asociar el alias.

    6. En Seleccionar rendimiento, selecciona una de las siguientes opciones:

    7. Seleccione Crear alias.

    API

    Para crear un alias para un agente, envíe una CreateAgentAliassolicitud (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un punto límite de tiempo de compilación de Agents for Amazon Bedrock.

    Los siguientes campos son obligatorios:

    Campo Caso de uso
    agentId Para especificar el ID del agente para el que se va a crear un alias.
    agentName Para especificar un nombre para el alias.

    Los siguientes campos son opcionales:

    Campo Caso de uso
    description Para proporcionar una descripción del alias.
    routingConfiguration Para especificar una versión a la que asociar el alias (déjala en blanco para crear una nueva versión) y un rendimiento aprovisionado para asociarlo al alias.
    clientToken Identificador para garantizar que la API solicitud se complete solo una vez.
    etiquetas Para asociar etiquetas al alias.

    Consulte los ejemplos de código

  2. Despliegue su agente configurando su aplicación para crear un InvokeAgentsolicitud (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un punto de ejecución de Agents for Amazon Bedrock. En el agentAliasId campo, especifique el ID del alias que apunta a la versión del agente que quiere usar.