Implemente un agente de 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.

Implemente un agente de Amazon Bedrock

Al crear un agente de Amazon Bedrock por primera vez, dispondrá de una versión de borrador activa (DRAFT) y un alias de prueba (TSTALIASID) que apunta a la versión de borrador 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 que realice llamadas a la API 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 rol de AWS Management Console uso de IAM 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:

      • Para permitir que su agente realice la inferencia de modelos con las tasas establecidas para su cuenta, seleccione Bajo demanda (ODT). Para obtener más información, consulte Cuotas para Amazon Bedrock.

      • Para permitir que su agente ejecute la inferencia de modelos a un ritmo mayor utilizando un rendimiento aprovisionado que haya adquirido previamente para el modelo, seleccione Rendimiento aprovisionado (PT) y, a continuación, seleccione un modelo aprovisionado. Para obtener más información, consulte Rendimiento aprovisionado para Amazon Bedrock.

    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 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 un nombre para el alias.

    Los siguientes campos son opcionales:

    Campo Caso de uso
    description Para proporcionar una descripción del alias.
    Configuración de enrutamiento 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 Identificador para garantizar que la solicitud de API se complete solo una vez.
    etiquetas Para asociar etiquetas al alias.

    Consulte los ejemplos de código

  2. Implemente a su agente configurando su aplicación para realizar una 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.

Para aprender a administrar las versiones y los alias de los agentes, seleccione uno de los siguientes temas.

Temas