Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Tutorial: creare un flusso che elabori le richieste di mutuo Per acquisire familiarità con le risorse di Amazon Bedrock e le relative funzionalità, utilizzeremo un CloudFormation modello per configurare un [flusso](flows.md) che automatizzi i processi di richiesta di mutuo combinando varie risorse Amazon Bedrock e altre. AWS **Nota** Per questo tutorial, useremo la regione. {{us-east-1}} Si può utilizzare qualsiasi Regione che supporti la gestione di agenti, flussi, guardrail, knowledge base e prompt. Per una tabella delle funzionalità supportate per Regione, consulta [Funzionalità supportate da Regione AWS Amazon Bedrock](features-regions.md). Verificare di disporre delle autorizzazioni per creare risorse Amazon S3, Amazon Bedrock, Lambda e DynamoDB nella Regione specifica. Questo flusso non è pensato per scopi di implementazione, ma viene utilizzato come tutorial per comprendere le risorse di Amazon Bedrock. L’immagine seguente rappresenta visivamente il flusso nella Console di gestione AWS: ![Flusso di elaborazione dei mutui](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/images/cloudformation/mortgage-processing-flow.png) Il flusso combina un [agente](agents.md) di Amazon Bedrock, [prompt](prompt-management.md) e una [funzione Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) per creare un flusso di elaborazione dei mutui che raccolga le informazioni finanziarie dei clienti e decida se il cliente rispetta i requisiti per ottenere un prestito. All’agente del flusso sono inoltre collegati una [knowledge base](knowledge-base.md) e un [guardrail](guardrails.md) di Amazon Bedrock per potenziare le risposte e fornire protezioni. Per ulteriori informazioni sui componenti del flusso, consulta [Dettagli sul flusso di elaborazione dei mutui](getting-started-mortgage-flow-details.md). **Topics** + [Prerequisiti](#getting-started-mortgage-flow-prereqs) + [Crea il flusso di elaborazione dei mutui utilizzando CloudFormation](#getting-started-mortgage-flow-create) + [Testare il flusso di elaborazione dei mutui](#getting-started-mortgage-flow-test) + [Pulizia: eliminazione delle risorse](#getting-started-mortgage-flow-delete) + [CloudFormation modelli](getting-started-mortgage-flow-template.md) + [Dettagli sul flusso di elaborazione dei mutui](getting-started-mortgage-flow-details.md) ## Prerequisiti Per creare il flusso, scarica un file .zip e segui le istruzioni per eseguire uno script che configura automaticamente le risorse e il modello. **Importante** Ti verranno addebitate le risorse Amazon che crei fino a quando non le elimini. Verifica i prerequisiti seguenti: 1. Scarica il [cloudformation-mortgage-flow-setupfile.zip.](samples/cloudformation-mortgage-flow-setup.zip) 1. Decomprimere il file. Per ulteriori informazioni sul contenuto, consulta [CloudFormation modelli](getting-started-mortgage-flow-template.md). 1. Per richiedere l’accesso ai modelli di fondazione Amazon Bedrock. esegui queste operazioni: 1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Verifica di trovarti nella Regione **Stati Uniti orientali (Virginia settentrionale)** controllandola nell’angolo in alto a destra. In caso contrario, cambia Regione. 1. Seleziona **Accesso la modello** nella parte inferiore del riquadro di navigazione a sinistra. 1. Scegli **Modifica l’accesso al modello**. 1. Esegui una delle seguenti 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. 1. Ai fini del seguente tutorial, è necessario richiedere almeno l’accesso ai modelli **Titan Embeddings G1 - Text** e **Claude 3 Haiku**. Quindi scegli **Successivo**. 1. Esamina i modelli a cui richiedi l’accesso e consulta i **Termini di servizio**. Al termine, scegli **Invia** per richiedere l’accesso. ## Crea il flusso di elaborazione dei mutui utilizzando CloudFormation Per creare il flusso di elaborazione dei mutui e le risorse associate, creeremo un CloudFormation modello e lo utilizzeremo per creare uno stack contenente risorse Amazon Bedrock. **Importante** Ti verranno addebitate le risorse Amazon che crei fino a quando non le elimini. ### Crea le risorse e il file modello CloudFormation Innanzitutto, utilizza lo script del file.zip per caricare le risorse in un bucket S3 e creare i modelli. CloudFormation 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 {{}} {{}}`, where {{}} e {{}} sono argomenti opzionali. Se non li indichi, vengono utilizzati i valori predefiniti seguenti: {{}}— La AWS regione predefinita specificata nella configurazione AWS delle credenziali. {{}}— Al bucket verrà assegnato un nome{{mortgage-flow-deployment--}}, dove si {{}} trova l'ID AWS dell'account e {{}} corrisponde al valore fornito o alla AWS regione predefinita specificata nella configurazione delle AWS credenziali. 1. Conferma i prompt. Al termine dell’implementazione, dovrebbe essere disponibile un modello `main-stack.yaml` e `main-stack.json` completo per il passaggio successivo. **Nota** Se lo script non riesce, esegui queste operazioni per preparare manualmente le risorse: Carica il *contenuto* (non includere la cartella stessa) della cartella decompressa `cloudformation-mortgage-flow-setup` in un bucket S3 negli Stati Uniti orientali (Virginia settentrionale) nella console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) Trova il file `templates/json/main-stack-tmp.yaml` o `templates/json/main-stack-tmp.json` ed esegui queste operazioni: Cambia il `Default` valore del `Q01pS3BucketName` parametro da {{MortgageFlowBucket}} al nome del bucket S3. Rimuovi `-tmp` dal nome del file, in modo che diventi `templates/json/main-stack.yaml` o `templates/json/main-stack.json`. ### Crea lo stack utilizzando la console CloudFormation Quindi, usa il modello che hai salvato per effettuare il provisioning di uno CloudFormation stack. 1. Apri la CloudFormation console in [https://console.aws.amazon.com/cloudformation.](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. 1. Nella pagina **Stack**, scegli **Con nuove risorse (standard)** nel menu **Crea stack**. 1. Specifica il modello: 1. In **Prerequisito**, seleziona **Scegli un modello esistente**. 1. In **Specifica modello**, seleziona **Carica un file di modello**. 1. Seleziona **Scegli file**, quindi passa al modello `main-stack.yaml` o `main-stack.json` e selezionalo. 1. Scegli **Next (Successivo)**. 1. Specifica i dettagli dello stack: 1. Nel campo **Nome stack**, immetti un nome per lo stack. 1. 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](knowledge-base-setup.md). 1. Scegli **Next (Successivo)**. 1. 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`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html) nella *Guida per l’utente di CloudFormation *. 1. In **Capacità**, seleziona la casella per confermare che CloudFormation potresti creare risorse IAM nel tuo account. 1. Scegli **Next (Successivo)**. 1. Controlla 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. 1. 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 a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Nel riquadro di navigazione a sinistra, scegli **Knowledge base**, quindi seleziona la knowledge base creata, denominata `AWSDocsTutorial-MortgageKB`. 1. Nella sezione **Origine dati**, seleziona la casella di controllo accanto all’origine dati creata, denominata `AWSDocsTutorial-MortgageKB-DS`. 1. Scegli **Sincronizza**. Al termine della sincronizzazione, puoi testare il flusso. ## Testare il flusso di elaborazione dei mutui Dopo aver creato il flusso di elaborazione dei mutui, puoi utilizzare la console Amazon Bedrock per esaminare, testare e modificare il flusso. Puoi anche esaminare, testare e modificare le singole risorse del flusso stesso. **Come testare il flusso** 1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. 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. 1. Nella sezione **Flussi**, seleziona il flusso creato dal modello. CloudFormation Dovrebbe essere `AWSDocsTutorial-MortgageFlow`. 1. Scegli **Modifica nel generatore di flussi**. Puoi trascinare singoli nodi nel flusso per modificarne la rappresentazione visiva. 1. 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. 1. 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 cerca la Knowledge Base allegata e genera una risposta che valuta, in base ai valori di input, se il cliente è idoneo per un prestito. 1. (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 Console di gestione AWS e apri la console DynamoDB all'indirizzo. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/) 1. Nel riquadro di navigazione a sinistra, seleziona **Tabelle**. 1. Seleziona la tabella che dice. **AWSDocsTutorial-PropertyListing** 1. Scegli **Explore table items** (Esplora elementi della tabella). 1. Puoi utilizzare uno qualsiasi dei valori della colonna **mls\_id** nell’input del flusso. Puoi anche accedere alle pagine di **gestione di **Agenti**, **Knowledge Base**, **Guardrails** e Prompt** Console di gestione AWS per esaminare ogni risorsa Amazon Bedrock utilizzata nel flusso, in modo indipendente. Per ulteriori informazioni sul flusso e per comprendere i componenti in modo più dettagliato, consulta [Dettagli sul flusso di elaborazione dei mutui](getting-started-mortgage-flow-details.md). ## Pulizia: eliminazione delle risorse Dopo aver esplorato le risorse e aver compreso meglio le funzionalità delle diverse risorse Amazon Bedrock, eliminiamo lo stack e le risorse che contiene. **Importante** Ti verranno addebitate le risorse Amazon che crei fino a quando non le elimini. 1. [Apri /cloudformation. https://console.aws.amazon.com](https://console.aws.amazon.com/cloudformation/) 1. Nel riquadro di navigazione a sinistra, scegli **Stack**. 1. Scegli lo stack creato a partire dal modello. Scegli **Elimina**, quindi conferma **Elimina**. CloudFormation avvia l'eliminazione dello stack principale, di tutti gli stack annidati e di tutte le risorse incluse negli stack.