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à.
# Crea un'app di riepilogo di testo basata sull'intelligenza artificiale con Amazon Bedrock
In questo tutorial, creerai un'applicazione in App Studio che utilizza Amazon Bedrock per fornire riepiloghi concisi degli input di testo da parte degli utenti finali. L'applicazione contiene una semplice interfaccia utente in cui gli utenti possono inserire qualsiasi testo che desiderano riepilogare. Potrebbe trattarsi di appunti di riunioni, contenuti di articoli, risultati di ricerche o qualsiasi altra informazione testuale. Dopo aver inserito il testo, gli utenti possono premere un pulsante per inviarlo ad Amazon Bedrock, che lo elaborerà utilizzando il modello Claude 3 Sonnet e restituirà una versione riepilogativa.
**Contents**
+ [Prerequisiti](#tutorial-conversational-bedrock-prerequisites)
+ [Passaggio 1: creare e configurare un ruolo IAM e un connettore App Studio](#tutorial-conversational-bedrock-steps-create-role-connector)
+ [Fase 2: Creare un'applicazione](#tutorial-conversational-bedrock-steps-create-application)
+ [Passaggio 3: creare e configurare un'automazione](#tutorial-conversational-bedrock-steps-create-automation)
+ [Fase 4: Creare pagine e componenti](#tutorial-conversational-bedrock-steps-user-interface)
+ [Rinomina la pagina predefinita](#tutorial-conversational-bedrock-steps-user-interface-create-page)
+ [Aggiungi componenti alla pagina](#tutorial-conversational-bedrock-steps-user-interface-add-components)
+ [Configura i componenti della pagina](#tutorial-conversational-bedrock-steps-user-interface-configure-components)
+ [Fase 5: Pubblicare l'applicazione nell'ambiente **di test**](#tutorial-conversational-bedrock-steps-publish)
+ [(Facoltativo) Pulizia](#tutorial-conversational-bedrock-steps-cleanup)
## Prerequisiti
Prima di iniziare, esamina e completa i seguenti prerequisiti:
+ Accesso ad AWS App Studio. Tieni presente che devi avere il ruolo di amministratore per creare un connettore in questo tutorial.
+ Facoltativo: [AWS Concetti di App Studio](concepts.md) consulta [Tutorial: inizia a creare da un'app vuota](getting-started-tutorial-empty.md) e acquisisci familiarità con importanti concetti di App Studio.
## Passaggio 1: creare e configurare un ruolo IAM e un connettore App Studio
Per fornire ad App Studio l'accesso ai modelli Amazon Bedrock, devi:
1. Abilita i modelli Amazon Bedrock che desideri utilizzare nella tua app. Per questo tutorial, utilizzerai **Claude 3 Sonnet**, quindi assicurati di abilitare quel modello.
1. Crea un ruolo IAM con autorizzazioni appropriate per Amazon Bedrock.
1. Crea un connettore App Studio con il ruolo IAM che verrà utilizzato nella tua app.
Consulta [Connect ad Amazon Bedrock](connectors-bedrock.md) le istruzioni dettagliate e torna a questo tutorial dopo aver seguito i passaggi e creato il connettore.
## Fase 2: Creare un'applicazione
Utilizza la seguente procedura per creare un'app vuota in App Studio da inserire nell'app di riepilogo del testo.
1. Accedi ad App Studio.
1. Vai al Builder Hub e scegli **\$1 Crea app**.
1. Scegli **Inizia da zero.**
1. Nel campo **Nome app**, fornisci un nome per la tua app, ad esempio**Text Summarizer**.
1. Se ti viene chiesto di selezionare fonti di dati o un connettore, scegli **Ignora** ai fini di questo tutorial.
1. Scegli **Successivo** per continuare.
1. (Facoltativo): guarda il video tutorial per una rapida panoramica sulla creazione di app in App Studio.
1. Scegli **Modifica app**, che ti porterà allo studio dell'applicazione.
## Passaggio 3: creare e configurare un'automazione
Sei tu a definire la logica e il comportamento di un'app App Studio nelle *automazioni*. Le automazioni consistono in singoli passaggi noti come *azioni*, *parametri* utilizzati per trasferire dati all'azione da altre risorse e un *output* che può essere utilizzato da altre automazioni o componenti. In questa fase, creerai un'automazione che gestisce l'interazione con Amazon Bedrock con quanto segue:
+ Input: un parametro per passare il testo immesso dall'utente all'automazione.
+ Azioni: un'azione **GenAI Prompt** che invia l'input di testo ad Amazon Bedrock e restituisce il riepilogo del testo in uscita.
+ Output: un output di automazione costituito dal riepilogo elaborato da Amazon Bedrock, che può essere utilizzato nella tua app.
**Per creare e configurare un'automazione che invii un prompt ad Amazon Bedrock ed elabori e restituisca un riepilogo**
1. Scegli la scheda **Automazioni** nella parte superiore dell'area di disegno.
1. Scegli **\$1 Aggiungi automazione**.
1. Nel pannello di destra, scegli **Proprietà**.
1. Aggiorna il nome dell'automazione scegliendo l'icona a forma di matita. Inserisci **InvokeBedrock** e premi **Invio**.
1. Aggiungi un parametro all'automazione che verrà utilizzato per passare l'input del prompt di testo dall'utente all'automazione da utilizzare nella richiesta ad Amazon Bedrock eseguendo i seguenti passaggi:
1. Nell'area di disegno, nella casella dei parametri, scegli **\$1** Aggiungi.
1. In **Nome**, inserisci **input**.
1. In **Descrizione**, inserisci una descrizione, ad esempio**Text to be sent to Amazon Bedrock**.
1. In **Tipo**, selezionate **Stringa**.
1. **Scegliete Aggiungi** per creare il parametro.
1. Aggiungi un'azione **GenAI Prompt** eseguendo i seguenti passaggi:
1. **Nel pannello di destra, scegli Azioni.**
1. Scegli **GenAI Prompt** per aggiungere un'azione.
1. Configura l'azione eseguendo i seguenti passaggi:
1. Scegli l'azione dall'area di disegno per aprire il menu **Proprietà** a destra.
1. Rinomina l'azione **PromptBedrock** scegliendo l'icona a forma di matita, inserendo il nome e premendo invio.
1. In **Connettore**, seleziona il connettore che è stato creato in[Passaggio 1: creare e configurare un ruolo IAM e un connettore App Studio](#tutorial-conversational-bedrock-steps-create-role-connector).
1. In **Modello**, scegli il modello Amazon Bedrock che desideri utilizzare per elaborare la richiesta. In questo tutorial, sceglierai **Claude** 3.5 Sonnet.
1. Nel **prompt dell'utente**, inserisci. `{{params.input}}` Rappresenta il `input` parametro creato in precedenza e conterrà il testo inserito dagli utenti dell'app.
1. In **Prompt di sistema**, inserisci le istruzioni del prompt di sistema che desideri inviare ad Amazon Bedrock. Per questo tutorial, inserisci quanto segue:
```
You are a highly efficient text summarizer. Provide a concise summary of the prompted text, capturing the key points and main ideas.
```
1. Scegli **Impostazioni di richiesta** per espanderla e aggiorna i seguenti campi:
+ In **Temperatura**, inserisci`0`. La temperatura determina la casualità o la creatività dell'output su una scala da 0 a 10. Più alto è il numero, più creativa è la risposta.
+ In **Max Tokens**, inserisci `4096` per limitare la lunghezza della risposta.
1. L'output di questa automazione sarà il testo riepilogato, tuttavia, per impostazione predefinita le automazioni non creano output. Configura l'automazione per creare un output di automazione eseguendo i seguenti passaggi:
1. Nella barra di navigazione a sinistra, scegli l'**InvokeBedrock**automazione.
1. **Nel menu **Proprietà** a destra, in **Output**, scegli \$1 Aggiungi.**
1. In **Output**, immettete**\$1\$1results.PromptBedrock.text\$1\$1**. Questa espressione restituisce il contenuto dell'`processResults`azione.
## Fase 4: Creare pagine e componenti
In App Studio, ogni pagina rappresenta una schermata dell'interfaccia utente (UI) dell'applicazione con cui gli utenti interagiranno. All'interno di queste pagine, puoi aggiungere vari componenti come tabelle, moduli, pulsanti e altro per creare il layout e la funzionalità desiderati.
### Rinomina la pagina predefinita
L'app di riepilogo del testo in questo tutorial conterrà solo una pagina. Le applicazioni appena create hanno una pagina predefinita, quindi rinominerai quella invece di aggiungerne una.
**Per rinominare la pagina predefinita**
1. Nel menu di navigazione della barra superiore, scegli **Pagine**.
1. Nel pannello a sinistra, scegli **Pagina1** e scegli il pannello **Proprietà** nel pannello a destra.
1. **Scegliete l'icona a forma di matita, immettete e premete Invio**TextSummarizationTool**.**
1. Nell'**etichetta di navigazione** inserisci**TextSummarizationTool**.
### Aggiungi componenti alla pagina
Per questo tutorial, l'app di riepilogo del testo ha una pagina che contiene i seguenti componenti:
+ Un componente **di immissione di testo** che gli utenti finali utilizzano per inserire un prompt da riepilogare.
+ Un componente **Button** utilizzato per inviare il prompt ad Amazon Bedrock.
+ Un componente **dell'area di testo** che visualizza il riepilogo di Amazon Bedrock.
Aggiungi un componente **di immissione di testo** alla pagina che gli utenti utilizzeranno per inserire un prompt di testo da riepilogare.
**Per aggiungere un componente di immissione di testo**
1. Nel pannello **Componenti** a destra, individuate il componente di **immissione del testo** e trascinatelo sull'area di disegno.
1. Scegliete l'input di testo nell'area di disegno per selezionarlo.
1. Nel pannello **Proprietà** a destra, aggiorna le seguenti impostazioni:
1. Scegliete l'icona a forma di matita per rinominare il testo inserito. **inputPrompt**
1. In **Etichetta**, inserisci**Prompt**.
1. In **Placeholder**, immettete. **Enter text to be summarized**
Ora aggiungi un componente **Button** a cui gli utenti sceglieranno di inviare il prompt ad Amazon Bedrock.
**Per aggiungere un componente pulsante**
1. Nel pannello **Componenti** a destra, individuate il componente **Button** e trascinatelo sull'area di disegno.
1. Scegliete il pulsante nell'area di disegno per selezionarlo.
1. Nel pannello **Proprietà** a destra, aggiorna le seguenti impostazioni:
1. Scegliete l'icona a forma di matita per rinominare il pulsante. **sendButton**
1. In **Etichetta del pulsante**, inserisci**Send**.
Ora aggiungi un componente **Text area** che mostrerà il riepilogo restituito da Amazon Bedrock.
**Per aggiungere un componente dell'area di testo**
1. Nel pannello **Componenti** a destra, individuate il componente **Area di testo** e trascinatelo sull'area di disegno.
1. Scegliete l'area di testo nell'area di disegno per selezionarla.
1. Nel pannello **Proprietà** a destra, aggiorna le seguenti impostazioni:
1. Scegliete l'icona a forma di matita per rinominare il pulsante. **textSummary**
1. In **Etichetta**, inserisci**Summary**.
### Configura i componenti della pagina
Ora che l'app contiene una pagina con i componenti, il passaggio successivo consiste nel configurare i componenti per eseguire il comportamento appropriato. Per configurare un componente, ad esempio un pulsante, in modo che agisca quando interagisce con esso, è necessario aggiungervi un *trigger*. Per l'app di questo tutorial, aggiungerai due trigger al `sendButton` pulsante per effettuare le seguenti operazioni:
+ Il primo trigger invia il testo nel `textPrompt` componente ad Amazon Bedrock per essere analizzato.
+ Il secondo trigger mostra il riepilogo restituito da Amazon Bedrock nel `textSummary` componente.
**Per aggiungere un trigger che invii il prompt ad Amazon Bedrock**
1. Scegli il pulsante nell'area di disegno per selezionarlo.
1. Nel pannello **Proprietà** a destra, nella sezione **Trigger**, scegli **\$1** Aggiungi.
1. Scegli **Invoke Automation**.
1. Scegli il **InvokeAutomation1** trigger che è stato creato per configurarlo.
1. In **Nome azione**, inserisci**invokeBedrockAutomation**.
1. In **Invoke Automation**, seleziona l'**InvokeBedrock**automazione creata in precedenza.
1. Nella casella dei parametri, nel parametro **di input** creato in precedenza, immettete**\$1\$1ui.inputPrompt.value\$1\$1**, che passa il contenuto del componente di immissione del `inputPrompt` testo.
1. Fate clic sulla freccia sinistra nella parte superiore del pannello per tornare al menu delle proprietà del componente.
Ora, hai configurato un trigger che richiama l'automazione per inviare una richiesta ad Amazon Bedrock quando si fa clic sul pulsante, il passaggio successivo consiste nel configurare un secondo trigger che mostri i risultati nel componente. `textSummary`
**Per aggiungere un trigger che mostri i risultati di Amazon Bedrock nel componente dell'area di testo**
1. **Nel pannello **Proprietà** a destra del pulsante, nella sezione **Trigger**, scegli \$1 Aggiungi.**
1. Scegli **Esegui azione del componente**.
1. Scegli il trigger **Runcomponentaction1** che è stato creato per configurarlo.
1. In Nome **azione, immettere.** **setTextSummary**
1. In **Componente**, selezionate il componente **TextSummary**.
1. In **Azione**, seleziona **Imposta valore**.
1. In **Imposta valore su**, inserisci**\$1\$1results.invokeBedrockAutomation\$1\$1**.
## Fase 5: Pubblicare l'applicazione nell'ambiente **di test**
In genere, durante la creazione di un'app, è buona norma visualizzarne l'anteprima per vederne l'aspetto ed eseguire i test iniziali sulla sua funzionalità. Tuttavia, poiché le applicazioni non interagiscono con i servizi esterni nell'ambiente di anteprima, pubblicherai l'app nell'ambiente di test per poter testare l'invio di richieste e la ricezione di risposte da Amazon Bedrock.
**Per pubblicare la tua app nell'ambiente di test**
1. **Nell'angolo in alto a destra dell'app builder, scegli Pubblica.**
1. Aggiungi una descrizione della versione per l'ambiente di test.
1. Controlla e seleziona la casella di controllo relativa allo SLA.
1. Scegli **Avvia**. La pubblicazione può richiedere fino a 15 minuti.
1. (Facoltativo) Quando sei pronto, puoi concedere l'accesso ad altri utenti scegliendo **Condividi** e seguendo le istruzioni. Per ulteriori informazioni sulla condivisione delle app App Studio, consulta. [Condivisione di applicazioni pubblicate](application-share.md)
Dopo aver testato l'applicazione, scegli nuovamente **Pubblica** per promuovere l'applicazione nell'ambiente di produzione. Tieni presente che le app nell'ambiente di produzione non sono disponibili per gli utenti finali finché non vengono condivise. Per ulteriori informazioni sui diversi ambienti applicativi, consulta[Ambienti applicativi](applications-publish.md#application-environments).
## (Facoltativo) Pulizia
Ora hai completato con successo il tutorial e creato un'app per il riepilogo del testo in App Studio con Amazon Bedrock. Puoi continuare a utilizzare la tua app oppure puoi ripulire le risorse create in questo tutorial. L'elenco seguente contiene un elenco di risorse da pulire:
+ Il connettore Amazon Bedrock creato in App Studio. Per ulteriori informazioni, consulta [Visualizzazione, modifica ed eliminazione dei connettori](viewing-deleting-connectors.md).
+ L'app di riepilogo del testo in App Studio. Per ulteriori informazioni, consulta [Eliminazione di un’applicazione](applications-delete.md).
+ Il ruolo IAM creato nella console IAM. Per ulteriori informazioni, consulta [Eliminare ruoli o profili di istanza](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) nella *Guida AWS Identity and Access Management per l'utente*.
+ *Se hai richiesto l'accesso al modello per usare Claude 3 Sonnet e desideri ripristinare l'accesso, consulta [Gestire l'accesso ai modelli Amazon Bedrock Foundation nella Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) User Guide.*