Créez un flux rapide dans Amazon Bedrock - Amazon Bedrock

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez un flux rapide dans Amazon Bedrock

Note

Amazon Bedrock Prompt flows est en version préliminaire et est sujet à modification.

Pour créer un flux d'invite, vous devez au minimum fournir un nom et une description pour le flux d'invite et vous spécifiez un rôle de service avec les autorisations appropriées (ou vous laissez la console Amazon Bedrock en créer un automatiquement pour vous). Vous allez ensuite définir le flux d'invite en configurant les nœuds, qui agissent comme des étapes dans le flux d'invite, et les connexions entre les nœuds. Avant de créer un flux, nous vous recommandons de lire Comment fonctionne Amazon Bedrock Prompt Flows pour vous familiariser avec les concepts et les termes des flux Amazon Bedrock Prompt et pour en savoir plus sur les types de nœuds mis à votre disposition. Pour savoir comment créer un flux rapide, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes suivantes :

Console
Pour créer un flux

  1. Connectez-vous à l' AWS Management Console aide d'un IAMrôle avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock sur Getting Started with the. AWS Management Console

  2. Sélectionnez Amazon Bedrock Prompt flows dans le volet de navigation de gauche.

  3. Dans la section Amazon Bedrock Prompt flows, choisissez Create prompt flow.

  4. Entrez un nom pour le flux et une description facultative.

  5. Pour le nom du rôle de service, choisissez l'une des options suivantes :

  6. (Facultatif) Pour chiffrer votre flux de messages à l'aide d'une KMS clé, sélectionnez Personnaliser les paramètres de chiffrement (avancés) et choisissez la clé. Pour de plus amples informations, veuillez consulter Politique clé permettant à Amazon Bedrock de chiffrer et de déchiffrer un flux.

  7. Sélectionnez Créer. Votre flux est créé et vous serez redirigé vers le générateur de flux rapide où vous pourrez créer votre flux.

  8. Vous pouvez passer à la procédure suivante pour créer votre flux ou revenir ultérieurement au générateur de flux rapide.

Pour créer votre flux

  1. Si vous n'êtes pas encore dans le générateur de flux d'appels, procédez comme suit :

    1. Connectez-vous à l' AWS Management Console aide d'un IAMrôle avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock sur Getting Started with the. AWS Management Console

    2. Sélectionnez Amazon Bedrock Prompt flows dans le volet de navigation de gauche. Choisissez ensuite un flux dans la section Amazon Bedrock Prompt flows.

    3. Choisissez Modifier dans le générateur de flux rapide.

  2. Dans la section Prompt Flow Builder, le volet central affiche un nœud d'entrée de flux et un nœud de sortie de flux. Il s'agit des nœuds d'entrée et de sortie de votre flux.

  3. Pour ajouter et configurer des nœuds

    1. Dans le volet Prompt Flow Builder, sélectionnez Nodes.

    2. Faites glisser le nœud que vous souhaitez utiliser pour la première étape de votre flux et déposez-le dans le volet central.

    3. Les cercles sur les nœuds sont des points de connexion. Pour connecter votre nœud d'entrée de flux au second nœud, faites glisser une ligne entre le cercle du nœud d'entrée de flux et le cercle de la section Entrée du nœud que vous venez d'ajouter.

    4. Sélectionnez le nœud que vous venez d'ajouter.

    5. Dans la section Configurer du volet Prompt flow builder, fournissez les configurations pour le nœud sélectionné et définissez les noms, les types de données et les expressions pour les entrées et les sorties du nœud.

    6. Dans le volet Prompt Flow Builder, sélectionnez Nodes.

    7. Répétez les étapes pour ajouter et configurer des nœuds (les nœuds restants de votre flux).

      Note

      Si vous utilisez un rôle de service qu'Amazon Bedrock a automatiquement créé pour vous, le rôle sera mis à jour avec les autorisations appropriées au fur et à mesure que vous ajouterez des nœuds. Toutefois, si vous utilisez un rôle de service personnalisé, vous devez ajouter les autorisations appropriées à la politique associée à votre rôle de service en vous référant àCréation d'un rôle de service pour les flux Amazon Bedrock Prompt dans Amazon Bedrock.

  4. Connectez la sortie du dernier nœud de votre flux à l'entrée du nœud de sortie du flux. Vous pouvez avoir plusieurs nœuds de sortie Flow. Pour ajouter des nœuds de sortie de flux supplémentaires, faites glisser le nœud de sortie de flux et déposez-le à côté du nœud où vous souhaitez que le flux s'arrête. Assurez-vous d'établir des connexions entre les deux nœuds.

  5. Vous pouvez passer à la procédure suivante Testez un flux rapide dans Amazon Bedrock ou y revenir plus tard. Pour passer à l'étape suivante, choisissez Enregistrer. Pour y revenir plus tard, choisissez Enregistrer et quittez.

Supprimer un nœud ou une connexion

Au cours du processus de création de votre flux, il se peut que vous deviez supprimer un nœud ou des connexions à un nœud.

Pour supprimer un nœud

  1. Sélectionnez le nœud que vous souhaitez supprimer.

  2. Dans le volet Prompt Flow Builder, choisissez l'icône de suppression ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ).

    Note

    Si vous utilisez un rôle de service qu'Amazon Bedrock a automatiquement créé pour vous, le rôle sera mis à jour avec les autorisations appropriées au fur et à mesure que vous ajouterez des nœuds. Toutefois, si vous supprimez des nœuds, les autorisations correspondantes ne seront pas supprimées. Nous vous recommandons de supprimer les autorisations dont vous n'avez plus besoin en suivant les étapes de la section Modification d'un rôle.

Pour supprimer une connexion

  • Sur la page Flow Builder, survolez la connexion que vous souhaitez supprimer jusqu'à ce que l'icône d'extension apparaisse, puis faites glisser la connexion hors du nœud.

API

Pour créer un flux, envoyez une CreateFlowdemande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison Agents for Amazon Bedrock build-time.

Les champs suivants sont obligatoires :

Champ Description de base
name Nom du flux.
executionRoleArn Le rôle ARN de service autorisé à créer et à gérer des flux.

Les champs suivants sont facultatifs :

Champ Cas d’utilisation
définition Contient le nodes et connections qui constituent le flux.
description Pour décrire le flux.
balises Pour associer des balises au flux. Pour de plus amples informations, veuillez consulter Marquer les ressources Amazon Bedrock.
customerEncryptionKeyArn Pour chiffrer le flux à l'aide d'une KMS clé. Pour de plus amples informations, veuillez consulter Politique clé permettant à Amazon Bedrock de chiffrer et de déchiffrer un flux.
clientToken Pour garantir que la API demande ne soit traitée qu'une seule fois. Pour plus d'informations, consultez la section Garantir l'idempuissance.

Bien que le definition champ soit facultatif, il est obligatoire pour que le flux soit fonctionnel. Vous pouvez choisir de créer un flux sans la définition au préalable et de le mettre à jour ultérieurement.

Pour chaque nœud de votre nodes liste, vous spécifiez le type de nœud dans le type champ et fournissez la configuration correspondante du nœud dans le config champ. Pour plus de détails sur la API structure des différents types de nœuds, consultezTypes de nœuds dans Prompt Flow.

Les exigences suivantes s'appliquent à la création d'un flux :

  • Votre flux ne doit comporter qu'un seul nœud d'entrée de flux et au moins un nœud de sortie de flux.

  • Vous ne pouvez pas inclure d'entrées pour un nœud d'entrée de flux.

  • Vous ne pouvez pas inclure de sorties pour un nœud de sortie de flux.

  • Chaque sortie d'un nœud doit être connectée à une entrée d'un nœud en aval (dans leAPI, cela se fait via un FlowConnectionwith a FlowDataConnectionConfiguration).

  • Chaque condition (y compris celle par défaut) d'un nœud de condition doit être connectée à un nœud en aval (dans leAPI, cela se fait via un FlowConnectionavec a FlowConditionalConnectionConfiguration).

Les conseils suivants s'appliquent à la création d'un flux :

  • Commencez par définir le type de données pour la sortie du nœud d'entrée du flux. Ce type de données doit correspondre à ce que vous comptez envoyer en entrée lorsque vous appelez le flux.

  • Lorsque vous définissez les entrées d'un flux à l'aide d'expressions, vérifiez que le résultat correspond au type de données que vous avez choisi pour l'entrée.

  • Si vous incluez un nœud itérateur, incluez un nœud collecteur en aval après avoir envoyé la sortie via les nœuds dont vous avez besoin. Le nœud collecteur renverra les sorties sous forme de tableau.