Creación de un flujo de peticiones en Amazon Bedrock - Amazon Bedrock

Creación de un flujo de peticiones en Amazon Bedrock

nota

Flujos de peticiones de Amazon Bedrock está en versión preliminar y está sujeta a cambios.

Para crear un flujo de peticiones, debe proporcionar como mínimo un nombre y una descripción del flujo de peticiones y especificar un rol de servicio con los permisos adecuados (o dejar que la consola de Amazon Bedrock cree uno automáticamente). A continuación, debe definir el flujo de peticiones. Para ello, debe configurar los nodos, que actúan como pasos en el flujo de peticiones, y las conexiones entre los nodos. Antes de crear un flujo, le recomendamos que lea Funcionamiento de los flujos de peticiones de Amazon Bedrock para familiarizarse con los conceptos y términos de los flujos de peticiones de Amazon Bedrock y para obtener información sobre los tipos de nodo que tiene disponibles. Para obtener más información sobre cómo crear un flujo de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga estos pasos:

Console
Para crear un flujo

  1. Inicie sesión en la AWS Management Console con un rol de IAM con los permisos de Amazon Bedrock y abra la consola de Amazon Bedrock en Introducción a la AWS Management Console.

  2. Seleccione Flujos de peticiones de Amazon Bedrock en el panel de navegación de la izquierda.

  3. En la sección Flujos de peticiones de Amazon Bedrock, seleccione Crear flujo de peticiones.

  4. Indique un Nombre para el flujo y, opcionalmente, una Descripción.

  5. En Nombre del rol de servicio, elija una de las siguientes opciones:

  6. (Opcional) Para cifrar el flujo de peticiones con una clave de KMS, seleccione Personalizar la configuración de cifrado (avanzada) y elija la clave. Para obtener más información, consulte Política de claves que permite a Amazon Bedrock cifrar y descifrar un flujo.

  7. Seleccione Crear. Se crea el flujo y se le redirige al generador de flujos de peticiones, donde podrá diseñarlo.

  8. Puede continuar con el siguiente procedimiento para configurar el flujo o volver al generador de flujo de peticiones más adelante.

Creación del flujo

  1. Si aún no se encuentra en el generador de flujo de peticiones, haga lo siguiente:

    1. Inicie sesión en la AWS Management Console con un rol de IAM con los permisos de Amazon Bedrock y abra la consola de Amazon Bedrock en Introducción a la AWS Management Console.

    2. Seleccione Flujos de peticiones de Amazon Bedrock en el panel de navegación de la izquierda. A continuación, elija un flujo en la sección Flujos de peticiones de Amazon Bedrock.

    3. Seleccione Editar en el generador de flujo de peticiones.

  2. En la sección Generador de flujo de peticiones, el panel central muestra un nodo Entrada de flujo y un nodo Salida de flujo. Estos son los nodos de entrada y salida de su flujo.

  3. Adición y configuración de nodos

    1. En el panel Generador de flujo de peticiones, seleccione Nodos.

    2. Arrastre el nodo que desee usar para el primer paso del flujo y colóquelo en el panel central.

    3. Los círculos en los nodos son puntos de conexión. Para conectar el nodo de entrada de flujo al segundo nodo, arrastre una línea desde el círculo del nodo Entrada de flujo hasta el círculo de la sección Entrada del nodo que acaba de añadir.

    4. Seleccione el nodo que acaba de añadir.

    5. En la sección Configurar del panel Generador de flujo de peticiones, proporcione las configuraciones del nodo seleccionado y defina los nombres, los tipos de datos y las expresiones para las entradas y salidas del nodo.

    6. En el panel Generador de flujo de peticiones, seleccione Nodos.

    7. Repita los pasos para agregar y configurar los nodos restantes del flujo.

      nota

      Si utiliza un rol de servicio que Amazon Bedrock haya creado automáticamente para usted, el rol se actualizará con los permisos adecuados a medida que añada nodos. Sin embargo, si utiliza un rol de servicio personalizado, debe agregar los permisos adecuados a la política asociada al rol de servicio consultando Creación de un rol de servicio para los flujos de peticiones de Amazon Bedrock en Amazon Bedrock.

  4. Conecte la Salida del último nodo del flujo con la Entrada del nodo Salida del flujo. Puede tener varios nodos Salida de flujo. Para añadir nodos de salida de flujo adicionales, arrastre el nodo Salida de flujo y suéltelo junto al nodo en el que desee que se detenga el flujo. Asegúrese de establecer conexiones entre los dos nodos.

  5. Puede continuar con el siguiente procedimiento Prueba de un flujo de peticiones en Amazon Bedrock o volver más tarde. Elija Guardar para continuar con el siguiente paso. Para volver más tarde, seleccione Guardar y salir.

Eliminación de un nodo o una conexión

Durante el proceso de creación del flujo, es posible que tenga que eliminar un nodo o las conexiones de los nodos.

Eliminación de un nodo

  1. Seleccione el nodo que desee eliminar.

  2. En el panel Creador del flujo de peticiones, seleccione el icono para eliminar ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ).

    nota

    Si utiliza un rol de servicio que Amazon Bedrock haya creado automáticamente para usted, el rol se actualizará con los permisos adecuados a medida que añada nodos. Sin embargo, si elimina nodos, no se eliminarán los permisos correspondientes. Le recomendamos que elimine los permisos que ya no necesite. Para ello, siga los pasos que se indican en Modificación de un rol.

Eliminación de etiquetas de una conexión

  • En la página Generador de flujos, coloque el cursor sobre la conexión que desea eliminar hasta que aparezca el icono de expansión y, a continuación, arrastre la conexión para separarla del nodo.

API

Para crear un flujo, envíe una solicitud CreateFlow (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.

Los siguientes campos son obligatorios:

Campo Descripción básica
name Nombre para el flujo
executionRoleArn ARN del rol de servicio con permisos para crear y administrar flujos

Los siguientes campos son opcionales:

Campo Caso de uso
definición Contiene los nodes y connections que componen el flujo.
description Para describir el flujo.
etiquetas Para asociar etiquetas con el flujo. Para obtener más información, consulte Etiquetado de los recursos de Amazon Bedrock.
customerEncryptionKeyArn Para cifrar el flujo con una clave de KMS. Para obtener más información, consulte Política de claves que permite a Amazon Bedrock cifrar y descifrar un flujo.
clientToken Para garantizar que la solicitud de la API se complete solo una vez. Para obtener más información, consulte Ensuring idempotency.

Si bien el campo definition es opcional, es necesario para que el flujo funcione. Puede optar por crear primero un flujo sin la definición y actualizar el flujo más adelante.

Para cada nodo de la lista de nodes, especifique el tipo de nodo en el campo type y proporcione la configuración correspondiente del nodo en el campo config. Para obtener más información sobre la estructura de API de los distintos tipos de nodo, consulte Tipos de nodos en el flujo de peticiones.

A la hora de crear un flujo se aplican los siguientes requisitos:

  • El flujo debe tener solo un nodo de entrada de flujo y al menos un nodo de salida de flujo.

  • No puede incluir las entradas de un nodo de entrada de flujo.

  • No puede incluir las salidas de un nodo de salida de flujo.

  • Cada salida de un nodo debe estar conectada a una entrada de un nodo descendente (en la API, esto se hace a través de una FlowConnection con una FlowDataConnectionConfiguration).

  • Cada condición (incluida la predeterminada) de un nodo de condición debe estar conectada a un nodo descendente (en la API, esto se hace a través de una FlowConnection con una FlowConditionalConnectionConfiguration).

A la hora de crear un flujo se deben cumplir los siguientes requisitos:

  • Primero debe configurar el tipo de datos para la salida del nodo de entrada de flujo. Este tipo de datos debe coincidir con lo que espera enviar como entrada al invocar el flujo.

  • Cuando defina las entradas de un flujo mediante expresiones, compruebe que el resultado coincide con el tipo de datos que ha elegido para la entrada.

  • Si incluye un nodo iterador, incluya un nodo recopilador descendente después de enviar la salida a través de los nodos que necesite. El nodo recopilador devolverá las salidas de una matriz.