Tutoriel : Création d'un flux qui traite les demandes de prêt hypothécaire - 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.

Tutoriel : Création d'un flux qui traite les demandes de prêt hypothécaire

Pour nous familiariser avec les ressources Amazon Bedrock et leurs fonctionnalités, nous allons utiliser un AWS CloudFormation modèle pour configurer un flux qui automatise les processus de demande de prêt hypothécaire en combinant différentes ressources Amazon Bedrock et d'autres ressources. AWS

Note

Pour ce didacticiel, nous utiliserons la us-east-1 région. Vous pouvez utiliser n'importe quelle région prenant en charge les agents, les flux, les garde-fous, les bases de connaissances et la gestion rapide. Pour un tableau des fonctionnalités prises en charge par région, voirFonctionnalités prises Région AWS en charge par Amazon Bedrock. Assurez-vous que vous êtes autorisé à créer des ressources Amazon S3, Amazon Bedrock, Lambda et DynamoDB dans la région que vous utilisez.

Ce flux n'est pas destiné à des fins de déploiement, mais plutôt à être utilisé comme didacticiel pour comprendre les ressources d'Amazon Bedrock. L'image suivante est la représentation visuelle du flux dans AWS Management Console :

Flux de traitement des prêts hypothécaires

Le flux combine un agent Amazon Bedrock, des invites et une fonction Lambda pour créer un flux de traitement des prêts hypothécaires qui prend en compte les informations financières du client et détermine si le client est éligible à un prêt. Une base de connaissances Amazon Bedrock et un garde-corps sont également attachés à l'agent du flux afin d'augmenter les réponses et de fournir des garanties. Pour des informations plus détaillées sur les composants du flux, consultezDétails sur le flux de traitement des prêts hypothécaires.

Prérequis

Pour créer ce flux, vous allez télécharger un fichier .zip et suivre les instructions pour exécuter un script qui configurera vos ressources et votre modèle pour vous.

Important

Les ressources Amazon que vous créez vous seront facturées jusqu'à ce que vous les supprimiez.

Complétez ensuite les prérequis suivants :

  1. Téléchargez le fichier cloudformation-mortgage-flow-setup.zip.

  2. Décompressez le fichier. Pour en savoir plus sur le contenu, rendez-vous surCloudFormation modèles.

  3. Demandez l'accès aux modèles de fondation Amazon Bedrock en procédant comme suit :

    1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse https://console.aws.amazon.com/bedrock.

    2. Assurez-vous que vous vous trouvez dans la région USA Est (Virginie du Nord) en cochant votre région dans le coin supérieur droit. Si ce n'est pas le cas, changez de région.

    3. Sélectionnez Accès au modèle en bas du volet de navigation de gauche.

    4. Choisissez Modifier l'accès au modèle.

    5. Effectuez l’une des actions suivantes :

      • Pour demander l'accès à tous les modèles, choisissez Activer tous les modèles. Sur la page vers laquelle vous êtes redirigé, les cases à cocher situées à côté de tous les modèles seront remplies.

      • Pour demander l'accès à des modèles spécifiques, choisissez Activer des modèles spécifiques. Sur la page vers laquelle vous êtes redirigé, vous disposez des options suivantes :

        • Pour demander à un fournisseur d'accéder à tous les modèles, cochez la case à côté du nom du fournisseur.

        • Pour demander l'accès à un modèle, cochez la case à côté du nom du modèle.

    6. Dans le cadre du didacticiel suivant, vous devez au minimum demander l'accès aux Claude 3 Haikumodèles Titan Embeddings G1 - Textet. Ensuite, sélectionnez Suivant.

    7. Passez en revue les modèles auxquels vous demandez l'accès et les conditions. Lorsque vous êtes prêt, choisissez Soumettre pour demander l'accès.

Créez le flux de traitement des prêts hypothécaires à l'aide de AWS CloudFormation

Pour créer le flux de traitement des prêts hypothécaires et les ressources associées, nous allons créer un CloudFormation modèle et l'utiliser pour créer une pile contenant les ressources Amazon Bedrock.

Important

Les ressources Amazon que vous créez vous seront facturées jusqu'à ce que vous les supprimiez.

Création des ressources et du fichier AWS CloudFormation modèle

Tout d'abord, utilisez le script du fichier .zip pour télécharger les ressources dans un compartiment S3 et créer les CloudFormation modèles.

  1. Dans un terminal, exécutez la commande suivante pour copier les ressources dans un compartiment Amazon S3 et remplir les main-stack.json fichiers main-stack.yaml et avec le nom du compartiment S3 comme valeur par défaut pour le paramètre du nom du compartiment.

    bash deploy.sh
    Note

    L'utilisation du script estbash deploy.sh <region> <bucket-name>, where <region> et <bucket-name> sont des arguments facultatifs. Si vous ne les fournissez pas, les valeurs par défaut suivantes seront utilisées :

    • <region>— La AWS région par défaut spécifiée dans la configuration de vos AWS informations d'identification.

    • <bucket-name>— Le bucket sera nommémortgage-flow-deployment-<AccountId>-<Region>, où se <AccountId> trouve votre identifiant de AWS compte et <Region> correspond à la valeur que vous avez fournie ou à la AWS région par défaut spécifiée dans la configuration de vos AWS informations d'identification.

  2. Confirmez les instructions. Une fois le déploiement terminé, vous devriez disposer d'un modèle complet main-stack.yaml et d'un main-stack.json modèle pour l'étape suivante.

Note

Si le script échoue, vous pouvez préparer les ressources manuellement en procédant comme suit :

  1. Téléchargez le contenu (n'incluez pas le dossier lui-même) du cloudformation-mortgage-flow-setup dossier décompressé dans un compartiment S3 situé dans l'est des États-Unis (Virginie du Nord) sur la console Amazon S3 à l'adresse. https://console.aws.amazon.com/s3/

  2. Recherchez le templates/json/main-stack-tmp.json fichier templates/json/main-stack-tmp.yaml or et procédez comme suit :

    1. Remplacez la Default valeur du Q01pS3BucketName paramètre par le nom MortgageFlowBucket de votre compartiment S3.

    2. -tmpSupprimez-le du nom du fichier, de telle sorte qu'il devienne templates/json/main-stack.yaml outemplates/json/main-stack.json.

Créez la pile à l'aide de la AWS CloudFormation console

Ensuite, utilisez le modèle que vous avez enregistré pour approvisionner une CloudFormation pile.

  1. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation. Assurez-vous que vous vous trouvez dans la région USA Est (Virginie du Nord) en cochant votre région dans le coin supérieur droit. Si ce n'est pas le cas, changez de région.

  2. Sur la page Stacks, dans le menu Créer une pile, choisissez Avec de nouvelles ressources (standard).

  3. Spécifiez le modèle :

    1. Sous Prérequis, choisissez Choisir un modèle existant.

    2. Sous Spécifier le modèle, choisissez Télécharger un fichier modèle.

    3. Choisissez Choisir un fichier, accédez au main-stack.yaml ou au main-stack.json modèle, puis sélectionnez-le.

    4. Choisissez Suivant.

  4. Spécifiez les détails de la pile :

    1. Dans le champ Nom de la pile, entrez le nom de la pile.

    2. Dans le champ Paramètres, laissez les valeurs par défaut.

      Note

      La Q01pS3BucketName valeur doit correspondre au nom du compartiment S3 dans lequel vous avez chargé les ressources de ce modèle. Les autres arguments concernent les configurations de la base de connaissances. Si vous modifiez l'un d'entre eux, assurez-vous que les configurations sont compatibles les unes avec les autres. Pour de plus amples informations, veuillez consulter Conditions préalables à l'utilisation d'un magasin vectoriel que vous avez créé pour une base de connaissances.

    3. Choisissez Suivant.

  5. Configurez les options de pile :

    1. Sous Options d'échec de la pile, choisissez Supprimer toutes les ressources nouvellement créées.

      Note

      Le choix de cette option vous évite d'être facturé pour des ressources dont la politique de suppression indique qu'elles doivent être conservées même en cas d'échec de la création de la pile. Pour plus d'informations, consultez la section DeletionPolicyattribut dans le guide de AWS CloudFormation l'utilisateur.

    2. Sous Fonctionnalités, cochez la case pour confirmer que des ressources IAM CloudFormation peuvent être créées dans votre compte.

    3. Choisissez Suivant.

  6. Vérifiez les détails de la pile et choisissez Soumettre. AWS CloudFormation crée la pile. La création prendra plusieurs minutes. Une fois la création de la pile terminée, vous pouvez utiliser l'onglet Ressources de la page détaillée de la pile pour afficher les ressources mises en service dans votre compte.

  7. Une fois la création de la pile terminée, procédez comme suit pour synchroniser la source de données de la base de connaissances afin que celle-ci puisse être interrogée :

    1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse https://console.aws.amazon.com/bedrock.

    2. Dans le volet de navigation de gauche, choisissez Bases de connaissances, puis sélectionnez la base de connaissances créée, nomméeAWSDocsTutorial-MortgageKB.

    3. Dans la section Source de données, cochez la case à côté de la source de données créée, nomméeAWSDocsTutorial-MortgageKB-DS.

    4. Choisissez Sync. Une fois la synchronisation terminée, vous pouvez tester le flux.

Testez le flux de traitement des prêts hypothécaires

Une fois le flux de traitement des prêts hypothécaires créé, vous pouvez utiliser la console Amazon Bedrock pour examiner, tester et modifier le flux. Vous pouvez également examiner, tester et modifier les ressources individuelles du flux.

Pour tester le débit
  1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse https://console.aws.amazon.com/bedrock.

  2. Dans le volet de navigation de gauche, sélectionnez Flows. Assurez-vous que vous vous trouvez dans la région USA Est (Virginie du Nord) en cochant votre région dans le coin supérieur droit. Si ce n'est pas le cas, changez de région.

  3. Dans la section Flux, sélectionnez le flux créé à partir du CloudFormation modèle. Ça devrait être AWSDocsTutorial-MortgageFlow.

  4. Choisissez Modifier dans le générateur de flux. Vous pouvez faire glisser des nœuds individuels dans le flux pour modifier la représentation visuelle du flux.

  5. Dans le volet Test flow, entrez ce qui suit dans le champ de texte, puis sélectionnez Exécuter.

    { "income": 80000, "totalDebt": 5000, "loanTerm": 30, "loanAmount": 600000, "creditScore": 750, "mlsId": "MLS-5678" }

    Le montant du prêt étant supérieur au prêt abordable maximal calculé, l'invite IncomeDebt est déclenchée et le flux génère une lettre de rejet. Vous pouvez choisir Afficher la trace pour voir les nœuds exécutés dans le flux.

  6. Encore une fois, dans le volet Test flow, entrez ce qui suit dans le champ de texte, puis sélectionnez Exécuter.

    { "income": 120000, "totalDebt": 5000, "loanTerm": 30, "loanAmount": 200000, "creditScore": 650, "mlsId": "MLS-3456" }

    Le montant du prêt étant inférieur au montant maximal du prêt abordable calculé, l'invite ProcessApplication est déclenchée et envoyée au mortgageProcessingAgent, qui consulte la base de connaissances jointe et génère une réponse évaluant, sur la base des valeurs saisies, si le client est éligible à un prêt.

  7. (Facultatif) Essayez d'exécuter le flux en utilisant différentes valeurs pour les champs de l'objet JSON. Les mlsId valeurs correspondent aux propriétés répertoriées sur le Multiple Listing Service. Vous pouvez trouver des mlsId valeurs valides en procédant comme suit :

    1. Connectez-vous à la console DynamoDB AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/dynamodb/

    2. Dans le volet de navigation de gauche, sélectionnez Tables.

    3. Sélectionnez le tableau qui indique AWSDocsTutorial-PropertyListing.

    4. Sélectionnez Explore table items (Explorer les éléments de la table).

    5. Vous pouvez utiliser n'importe laquelle des valeurs de la colonne mls_id dans l'entrée du flux.

Vous pouvez également accéder aux pages de gestion Agents, Bases de connaissances, Guardrails et Prompt AWS Management Console pour examiner indépendamment chaque ressource Amazon Bedrock utilisée dans le flux. Pour en savoir plus sur le flux et comprendre les composants de manière plus détaillée, voirDétails sur le flux de traitement des prêts hypothécaires.

Nettoyage : suppression de ressources

Une fois que vous aurez exploré les ressources et que vous aurez mieux compris les fonctionnalités des différentes ressources Amazon Bedrock, nous supprimerons la pile et les ressources qu'elle contient.

Important

Les ressources Amazon que vous créez vous seront facturées jusqu'à ce que vous les supprimiez.

  1. Ouvrez le fichier https://console.aws.amazon.com/cloudformation.

  2. Dans la barre de navigation de gauche, choisissez Stacks.

  3. Choisissez la pile que vous avez créée à partir du modèle. Choisissez ensuite Supprimer, puis confirmez Supprimer.

    CloudFormation initie la suppression de la pile principale, de toutes ses piles imbriquées et de toutes les ressources incluses dans les piles.