Implementación e integración de 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.

Implementación e integración de un agente de Amazon Bedrock en su aplicación

Al crear un agente de Amazon Bedrock por primera vez, tiene una versión de borrador de trabajo (DRAFT) y un alias de prueba (TSTALIASID) que apunta hacia la versión de borrador de trabajo. Al realizar cambios en su agente, los cambios se aplican al borrador de trabajo. Itere el borrador de trabajo hasta que apruebe el comportamiento del agente. A continuación, podrá configurar el agente para implementarlo e integrarlo en su aplicación creando los alias del agente.

Para implementar el 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 dirigir el alias hacia una versión del agente creada anteriormente. 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 de su agente en el momento en que las 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 apunten hacia esa versión.

Los alias le permiten cambiar de forma eficiente entre distintas versiones de su agente sin que la aplicación tenga que realizar un seguimiento de la versión. Por ejemplo, puede cambiar un alias para que apunte hacia una versión anterior del agente si hay cambios que necesita revertir rápidamente.

Implementación del agente

  1. Cree un alias y una versión de su agente. Elige la pestaña del método que prefieras y, a continuación, sigue los pasos:

    Console
    Creación de 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. En el panel de navegación de la izquierda, seleccione Agentes. A continuación, elija un agente en la sección Agentes.

    3. En la sección Alias, elija Crear.

    4. Introduzca un Nombre de alias exclusivo 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, elija la versión a la que desea asociar el alias.

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

    7. Seleccione Crear alias.

    API

    Para crear un alias para un agente, envía una CreateAgentAliassolicitud con un punto final 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 el nombre del 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éjelo en blanco para crear una nueva versión) y un Rendimiento aprovisionado para asociarlo al alias.
    clientToken Para garantizar que la API solicitud se complete solo una vez. Para obtener más información, consulte Ensuring idempotency.
    tags Para asociar etiquetas con el alias.

    Ver ejemplos de código

  2. Despliegue a su agente configurando su aplicación para crear un InvokeAgentsolicitud con un punto final de ejecución de Agents for Amazon Bedrock. En el campo agentAliasId, especifique el ID del alias que apunta hacia la versión del agente que quiere usar.

    El flujo de InvokeAgent respuesta contiene varios eventos con fragmentos para cada parte de la respuesta en orden. Si lo desea, puede habilitar la transmisión configurándola true en streamFinalResponse las configuraciones de transmisión.

    • Si su agente está configurado con un guardrail, también puede especificarlo applyGuardrailInterval en elStreamingConfigurations, para controlar la frecuencia con la que se realiza una ApplyGuardrail llamada con los caracteres de respuesta salientes (por ejemplo, cada 50 caracteres)

    • Actualmente, la transmisión de respuestas solo se admite con el mensaje de Orchestration.

    • Actualmente, las citas no se admiten en la transmisión.

    • Asegúrese de que la función de ejecución del agente incluya el bedrock:InvokeModelWithResponseStream permiso para el modelo de agente configurado.