Didacticiel : création d’un flux qui traite les applications de prêts hypothécaires

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

2. Décompressez le fichier. Vous pouvez en savoir plus sur le contenu dans CloudFormation 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 en regard 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 située en regard du nom du fournisseur.

        • Pour demander l’accès à un modèle, cochez la case située en regard du nom du modèle.

   6. Dans le cadre du didacticiel suivant, vous devez au minimum demander l’accès aux modèles Titan Embeddings G1 - Text et Claude 3 Haiku. 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.

1. Dans un terminal, exécutez la commande suivante pour copier les ressources dans un compartiment Amazon S3 et remplir les fichiers main-stack.yaml et main-stack.json 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 invites. Une fois le déploiement terminé, vous devriez disposer d’un modèle main-stack.yaml et main-stack.json complet pour l’étape suivante.

1. Ouvrez la 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 Piles, dans le menu Créer une pile, choisissez Avec de nouvelles ressources (standard).

3. Spécifiez un modèle :

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

   2. Sous Spécifier le modèle, sélectionnez Charger un modèle de fichier.

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

   4. Choisissez Suivant.

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

   1. Dans Nom de la pile, entrez un nom pour la pile.

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

      Note

      La valeur Q01pS3BucketName 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 entre elles. Pour de plus amples informations, veuillez consulter Conditions préalables à l’utilisation d’un magasin de vecteurs que vous avez créé pour une base de connaissances.

   3. Choisissez Suivant.

5. Configurez les options de pile :

   1. Sous Options d’échec de 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 stratégie 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 Attribut DeletionPolicy dans le Guide de l’utilisateur CloudFormation .

   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. CloudFormation crée la pile. La création dure 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 provisionnées 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, sélectionnez Bases de connaissances et choisissez la base de connaissances créée, AWSDocsTutorial-MortgageKB.

   3. Dans la section Source de données, cochez la case en regard de la source de données créée, nommée AWSDocsTutorial-MortgageKB-DS.

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

Pour tester le flux

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 Flux. 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. Ce devrait être AWSDocsTutorial-MortgageFlow.

4. Choisissez Modifier dans le créateur 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 Flux de test, 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 Flux de test, 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 valeurs mlsId correspondent aux propriétés répertoriées sur le Multiple Listing Service. Vous pouvez trouver les valeurs mlsId 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 panneau de navigation de gauche, sélectionnez Tables.

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

   4. Sélectionnez Explorer les éléments de table.

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

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

2. Dans le volet de navigation de gauche, choisissez Piles.

3. Choisissez la pile que vous avez créée à partir du modèle. Ensuite, choisissez Supprimer, puis confirmez en sélectionnant Supprimer.

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