Creación de una colaboración entre múltiples agentes - Amazon Bedrock

Creación de una colaboración entre múltiples agentes

La creación de una colaboración entre múltiples agentes consta de los siguientes pasos:

  1. Cree e implemente agentes colaboradores. Asegúrese de configurar cada agente colaborador para que implemente una tarea específica dentro del flujo de trabajo de colaboración entre múltiples agentes.

  2. Cree un nuevo agente supervisor o asigne el rol de supervisor a un agente existente. Al crear un nuevo agente supervisor o identificar un agente existente como agente supervisor, también puede especificar cómo quiere que el agente supervisor trate la información entre varios agentes colaboradores.

    Puede asignar al agente supervisor la tarea de coordinar las respuestas de los agentes colaboradores o puede asignar al agente supervisor la tarea de enviar la información al agente colaborador adecuado para enviar la respuesta final. Al asignar al agente supervisor la tarea de enrutar la información, se reduce la latencia.

  3. Asocie la versión de alias de los agentes colaboradores al agente supervisor.

    nota

    En este momento, puede asociar un máximo de diez agentes colaboradores a un agente supervisor.

  4. Prepare y pruebe su equipo de colaboración entre múltiples agentes.

  5. Implemente e invoque el agente supervisor.

Puede crear una colaboración entre múltiples agentes en la consola de Amazon Bedrock, mediante las API, la CLI de AWS o el SDK de AWS. Para obtener más información sobre cómo crear una colaboración entre múltiples agentes, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:

Console
Paso 1: creación de agentes colaboradores

  • Siga las instrucciones para crear y configurar un agente. Asegúrese de configurar cada agente colaborador para que realice una tarea específica.

Paso 2: creación de un nuevo agente supervisor o asignación del rol de supervisor a un agente existente.

  1. Si va a crear un nuevo agente supervisor, siga las instrucciones descritas en Creación y configuración de agentes manualmente y continúe con el siguiente paso.

    Si ya tiene un agente configurado y desea asignarle el rol de supervisor, continúe con el siguiente paso.

  2. Si aún no se encuentra en el creador de agentes, haga lo siguiente:

    1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, 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. Elija Editar en el Creador de agentes.

    4. En el Creador de agentes, desplácese hacia abajo hasta la sección Colaboración entre múltiples agentes y seleccione Editar.

  3. En la página Colaboración entre múltiples agentes, en la sección Estado de la colaboración, active Colaboración entre múltiples agentes. Esto identificará el agente como agente supervisor.

  4. En la sección Configuración de colaboración, elija cómo quiere que el agente supervisor trate la información de varios agentes colaboradores para coordinar una respuesta final.

    1. Si desea que el agente supervisor coordine las respuestas de los agentes colaboradores, seleccione Supervisor.

    2. Si desea que el agente supervisor envíe la información al agente colaborador correspondiente para enviar la respuesta final, seleccione Supervisor con enrutamiento.

    3. Continúe con los siguientes pasos para añadir agentes colaboradores.

Paso 3: incorporación de agentes colaboradores

  1. Amplíe la sección Agente colaborador y proporcione detalles del agente colaborador que creó para la colaboración entre múltiples agentes.

    1. En Agente colaborador, seleccione un agente colaborador y un alias de agente en el menú desplegable. Puede elegir Ver para ver los detalles del agente colaborador.

    2. En Nombre del colaborador, introduzca un nombre alternativo para el agente colaborador. Este nombre no sustituirá al nombre original de este agente.

    3. En Instrucciones de colaboración, introduzca los detalles de cuándo el agente supervisor debe utilizar este agente colaborador.

    4. (Opcional) Active Habilitar el historial de conversaciones si desea que el agente supervisor comparta el contexto de las conversaciones anteriores con este agente colaborador. Si esta opción está activada, el supervisor incluirá el historial completo de la sesión actual, incluido el texto introducido por el usuario y la respuesta del agente supervisor en cada turno de la conversación.

  2. Seleccione Agregar colaborador para añadir este agente colaborador a su equipo de colaboración entre múltiples agentes. Para añadir más agentes colaboradores, repita el paso 1 hasta que haya añadido todos los agentes colaboradores.

  3. Cuando termine de añadir agentes colaboradores, seleccione una de las siguientes opciones:

    • Para continuar con la colaboración entre múltiples agentes, seleccione Guardar y continúe con el siguiente paso: preparación y prueba de su equipo de colaboración entre múltiples agentes.

    • Para volver a la página Detalles del agente, seleccione Guardar y salir.

Paso 4: preparación y prueba de su equipo de colaboración entre múltiples agentes

  • Siga las instrucciones para preparar y probar su equipo de colaboración entre múltiples agentes.

Paso 5: implementación de una colaboración entre múltiples agentes

  • Implemente la colaboración entre múltiples agentes configurando el agente supervisor para que realice una solicitud InvokeAgent.

API

Para crear un equipo de colaboración entre múltiples agentes, siga estos pasos.

Paso 1: creación de agentes colaboradores

  • Siga las instrucciones para crear y configurar un agente. Asegúrese de configurar cada agente colaborador para que realice una tarea específica.

Paso 2: creación de un nuevo agente supervisor o asignación del rol de supervisor a un agente existente.

  • Para crear un nuevo agente supervisor, envíe una solicitud CreateAgent (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock.

    Para asignar un rol de supervisor a un agente existente, envíe una solicitud UpdateAgent con un punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock. Dado que se sobrescribirán todos los campos, incluya los dos campos que quiera actualizar, así como los campos que quiera mantener sin cambios.

    Debe rellenar, como mínimo, los siguientes campos:

    Campo Caso de uso
    agentResourceRoleArn Para especificar un ARN del rol de servicio que dispone de permisos para llamar a las operaciones de la API en el agente.
    foundationModel Para especificar un modelo fundacional (FM) con el que el agente pueda orquestar.
    instruction Para proporcionar instrucciones que le indiquen al agente lo que debe hacer. Se utiliza en el marcador de posición $instructions$ de la plantilla de petición de orquestación.
    agentCollaboration

    Asignar el rol de supervisor al agente.

    Especifique SUPERVISOR si desea que el agente supervisor coordine las respuestas de los agentes colaboradores y genere la respuesta.

    Especifique SUPERVISOR_ROUTER si desea que el agente supervisor envíe la información al agente colaborador correspondiente para enviar la respuesta final.

    De forma predeterminada, este campo está establecido en DISABLED.

    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 ARN de una clave de KMS para cifrar los recursos del agente.
    etiquetas Para asociar etiquetas a su agente.
    promptOverrideConfiguration Para personalizar las peticiones que se envían al FM en cada paso de la orquestación.
    guardrailConfiguration Para añadir una barrera de protección al agente. Especifique el ID o el ARN de la barrera de protección y la versión que se deben utilizar.
    clientToken Para garantizar que la solicitud de la API se complete solo una vez. Para obtener más información, consulte Ensuring idempotency.

    La respuesta devuelve un objeto CreateAgent que contiene detalles sobre el agente que se acaba de crear. Si no se puede crear el agente, la respuesta del objeto CreateAgent devolverá una lista de failureReasons junto con una lista de recommendedActions para que pueda solucionar los problemas.

Paso 3: incorporación de agentes colaboradores

  • Para asociar agentes colaboradores al agente supervisor, envíe una solicitud AssociateAgentCollaborator (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock.

    Debe rellenar, como mínimo, los siguientes campos:

    Campo Caso de uso
    collaboratorName Especificar un nombre alternativo para el agente colaborador. Este nombre solo aparecerá en las instrucciones de colaboración y no sustituye al nombre original del agente.
    agentDescriptor Especificar el ARN del alias del agente.
    collaborationInstruction Proporcionar instrucciones que indiquen al agente lo que debe hacer.
    relayConversationHistory

    Establézcalo en TO_COLLABORATOR para especificar que el agente supervisor compartirá el contexto de las conversaciones anteriores con este agente colaborador.

    Valores válidos: TO_COLLABORATOR | DISABLED.
Paso 4: preparación y prueba de su equipo de colaboración entre múltiples agentes

  • Siga las instrucciones para preparar y probar su equipo de colaboración entre múltiples agentes.

Paso 4: implementación de la colaboración entre múltiples agentes

  • Implemente la colaboración entre múltiples agentes configurando el agente supervisor para que realice una solicitud InvokeAgent.