Cree un flujo en 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.

Cree un flujo en Amazon Bedrock

Para crear un flujo, debe proporcionar como mínimo un nombre y una descripción para el flujo 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, definirá el flujo configurando los nodos, que actúan como pasos del flujo, y las conexiones entre los nodos. Antes de crear un flujo, le recomendamos que lea Cómo funciona Amazon Bedrock Flows para familiarizarse con los conceptos y términos de Amazon Bedrock Flows y para obtener información sobre los tipos de nodos que tiene a su disposición.

Amazon Bedrock cifra los datos en reposo. De forma predeterminada, Amazon Bedrock cifra estos datos mediante una clave administrada de AWS . Si lo desea, puede cifrar los datos de ejecución del flujo mediante una clave gestionada por el cliente. Para obtener más información, consulte Cifrado de los recursos de Amazon Bedrock Flows.

Para obtener información sobre cómo crear un flujo, elija la pestaña correspondiente al método que prefiera y, a continuación, siga estos pasos:

Console
Para crear un flujo

  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 Getting Started with the. AWS Management Console

  2. Seleccione Amazon Bedrock Flows en el panel de navegación izquierdo.

  3. En la sección Amazon Bedrock Flows, selecciona Crear flujo.

  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 con una clave KMS, seleccione Personalizar la configuración de cifrado (avanzada) y elija la clave. Para obtener más información, consulte Cifrado de los recursos de Amazon Bedrock Flows.

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

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

Creación del flujo

  1. Si aún no está en el generador de flujos, haga lo siguiente:

    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 Getting Started with the. AWS Management Console

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

    3. Elija Editar en el generador de flujos.

  2. En la sección del generador de flujos, el panel central muestra un nodo de entrada de Flow y un nodo de salida de Flow. Estos son los nodos de entrada y salida de su flujo.

  3. Adición y configuración de nodos

    1. En el panel Flow Builder, 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 Flow Builder, proporcione las configuraciones del nodo seleccionado y defina los nombres, tipos de datos y expresiones para las entradas y salidas del nodo.

    6. En el panel Generador de flujos, 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 Cree un rol de servicio para Amazon Bedrock Flows 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 Pruebe un flujo 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 Flow Builder, elija el icono de 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ía una CreateFlowsolicitud con un punto final de tiempo de compilación de Agents for Amazon Bedrock.

Los siguientes campos son obligatorios:

Campo Descripción básica
nombre 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
definition 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 recurso con una clave KMS. Para obtener más información, consulte Cifrado de los recursos de Amazon Bedrock Flows.
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 flujo.

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 mediante a FlowConnectioncon a FlowDataConnectionConfiguration).

  • Todas las condiciones (incluida la predeterminada) de un nodo de condición deben estar conectadas a un nodo descendente (en la API, esto se hace mediante a FlowConnectioncon a 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.