Tutorial: creare un flusso che elabori le richieste di mutuo

1. Scarica il file cloudformation-mortgage-flow-setup.zip.

2. Decomprimere il file. Per ulteriori informazioni sul contenuto, consulta Modelli CloudFormation.

3. Per richiedere l’accesso ai modelli di fondazione Amazon Bedrock. esegui queste operazioni:

   1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo https://console.aws.amazon.com/bedrock.

   2. Verifica di trovarti nella Regione Stati Uniti orientali (Virginia settentrionale) controllandola nell’angolo in alto a destra. In caso contrario, cambia Regione.

   3. Seleziona Accesso la modello nella parte inferiore del riquadro di navigazione a sinistra.

   4. Scegli Modifica l’accesso al modello.

   5. Esegui una di queste operazioni:

      • Per richiedere l’accesso a tutti i modelli, scegli Abilita tutti i modelli. Nella pagina di destinazione, vengono selezionate tutte le caselle di controllo accanto a tutti i modelli.

      • Per richiedere l’accesso a modelli specifici, scegli Abilita modelli specifici. Nella pagina di destinazione, sono disponibili le opzioni seguenti:

        • Per richiedere l’accesso a tutti i modelli di un provider, seleziona la casella di controllo accanto al nome del provider.

        • Per richiedere l’accesso a un modello, seleziona la casella di controllo accanto al nome del modello.

   6. Ai fini del seguente tutorial, è necessario richiedere almeno l’accesso ai modelli Titan Embeddings G1 - Text e Claude 3 Haiku. Quindi scegli Successivo.

   7. Esamina i modelli a cui richiedi l’accesso e consulta i Termini di servizio. Al termine, scegli Invia per richiedere l’accesso.

1. In un terminale, esegui il comando seguente per copiare le risorse in un bucket Amazon S3 e popolare i file main-stack.json e main-stack.yaml and con il nome del bucket S3 come valore predefinito per il parametro che indica il nome del bucket.

   bash deploy.sh

   Nota

   L’uso dello script è bash deploy.sh <region> <bucket-name>, in cui <region> e <bucket-name> sono argomenti facoltativi. Se non li indichi, vengono utilizzati i valori predefiniti seguenti:

   • <region>: Regione AWS predefinita specificata nella configurazione delle credenziali AWS.

   • <bucket-name>: al bucket viene assegnato il nome mortgage-flow-deployment-<AccountId>-<Region>, dove <AccountId> è il tuo ID account AWS e <Region> corrisponde al valore fornito oppure alla Regione AWS predefinita specificata nella configurazione delle credenziali AWS.

2. Conferma i prompt. Al termine dell’implementazione, dovrebbe essere disponibile un modello main-stack.yaml e main-stack.json completo per il passaggio successivo.

1. Apri la console CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation. Verifica di trovarti nella Regione Stati Uniti orientali (Virginia settentrionale) controllandola nell’angolo in alto a destra. In caso contrario, cambia Regione.

2. Nella pagina Stack, scegli Con nuove risorse (standard) nel menu Crea stack.

3. Specifica il modello:

   1. In Prerequisito, seleziona Scegli un modello esistente.

   2. In Specifica modello, seleziona Carica un file di modello.

   3. Seleziona Scegli file, quindi passa al modello main-stack.yaml o main-stack.json e selezionalo.

   4. Scegli Next (Successivo).

4. Specifica i dettagli dello stack:

   1. Nel campo Nome stack, immetti un nome per lo stack.

   2. Nel campo Parametri, lascia i valori predefiniti.

      Nota

      Il valore Q01pS3BucketName deve corrispondere al nome del bucket S3 in cui hai caricato le risorse per questo modello. Gli argomenti rimanenti sono correlati alle configurazioni della knowledge base: se ne modifichi qualcuno, verifica che le configurazioni siano compatibili tra loro. Per ulteriori informazioni, consulta Prerequisiti per l’utilizzo di un archivio vettoriale creato per una knowledge base.

   3. Scegli Next (Successivo).

5. Configura le opzioni dello stack:

   1. In Opzioni di errore dello stack, scegli Elimina tutte le nuove risorse create.

      Nota

      Scegliendo questa opzione si evita di ricevere addebiti per risorse la cui policy di eliminazione specifica che devono essere mantenute anche se la creazione dello stack non riesce. Per ulteriori informazioni, consulta la pagina relativa all’attributo DeletionPolicy nella Guida per l’utente di CloudFormation.

   2. In Funzionalità, seleziona la casella per confermare che CloudFormation può creare risorse IAM nel tuo account.

   3. Scegli Next (Successivo).

6. Esamina i dettagli dello stack e scegli Invia. CloudFormation crea lo stack. L’operazione richiede diversi minuti. Dopo aver completato la creazione dello stack, puoi utilizzare la scheda Risorse nella pagina dei dettagli dello stack per visualizzare le risorse disponibili nel tuo account.

7. Dopo aver completato la creazione dello stack, esegui queste operazioni per sincronizzare l’origine dati per la knowledge base in modo che sia possibile inviare query alla knowledge base:

   1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo https://console.aws.amazon.com/bedrock.

   2. Nel riquadro di navigazione a sinistra, scegli Knowledge base, quindi seleziona la knowledge base creata, denominata AWSDocsTutorial-MortgageKB.

   3. Nella sezione Origine dati, seleziona la casella di controllo accanto all’origine dati creata, denominata AWSDocsTutorial-MortgageKB-DS.

   4. Scegli Sincronizza. Al termine della sincronizzazione, puoi testare il flusso.

Come testare il flusso

1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo https://console.aws.amazon.com/bedrock.

2. Nel riquadro di navigazione a sinistra, scegli Flussi. Verifica di trovarti nella Regione Stati Uniti orientali (Virginia settentrionale) controllandola nell’angolo in alto a destra. In caso contrario, cambia Regione.

3. Nella sezione Flussi, seleziona il flusso creato dal modello CloudFormation. Dovrebbe essere AWSDocsTutorial-MortgageFlow.

4. Scegli Modifica nel generatore di flussi. Puoi trascinare singoli nodi nel flusso per modificarne la rappresentazione visiva.

5. Nel riquadro Testa flusso, immetti i valori indicati di seguito nel campo di testo, quindi seleziona Esegui.

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

   Poiché l’importo del prestito è superiore al prestito massimo accessibile calcolato, viene attivato il prompt incomeDebt e il flusso genera una lettera di rifiuto. Puoi scegliere Mostra traccia per visualizzare i nodi eseguiti nel flusso.

6. Nel riquadro Testa flusso, immetti i valori indicati di seguito nel campo di testo, quindi seleziona Esegui.

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

   Poiché l’importo del prestito è inferiore al prestito massimo accessibile calcolato, il prompt processApplication viene attivato e inviato a mortgageProcessingAgent, che esegue una ricerca nella knowledge base collegata e genera una risposta che valuta, in base ai valori di input, se il cliente è idoneo a ricevere un prestito.

7. (Facoltativo) Prova a eseguire il flusso utilizzando valori diversi per i campi dell’oggetto JSON. I valori mlsId valori corrispondono alle proprietà elencate in Multiple Listing Service. Per trovare valori mlsId validi, esegui queste operazioni:

   1. Accedi alla console Console di gestione AWS e apri la console DynamoDB all'indirizzo https://console.aws.amazon.com/elasticache/.

   2. Nel riquadro di navigazione a sinistra, seleziona Tabelle.

   3. Seleziona la tabella con AWSDocsTutorial-PropertyListing.

   4. Scegli Explore table items (Esplora elementi della tabella).

   5. Puoi utilizzare uno qualsiasi dei valori della colonna mls_id nell’input del flusso.

1. Apri https://console.aws.amazon.com/cloudformation.

2. Nel riquadro di navigazione a sinistra, scegli Stack.

3. Scegli lo stack creato a partire dal modello. Scegli Elimina, quindi conferma Elimina.

   CloudFormation avvia l’eliminazione dello stack principale, di tutti i relativi stack annidati e di tutte le risorse incluse negli stack.