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à. # Automazioni degli edifici Amazon Quick Automate offre diversi metodi per creare automazioni per soddisfare esigenze e livelli di abilità diversi. Questa sezione descrive i metodi e gli strumenti di creazione disponibili. ## Prerequisiti Prima di creare un'automazione, è necessario creare un progetto all'interno di un gruppo di automazione specifico. Il gruppo di automazione controllerà quali integrazioni e credenziali sono disponibili per l'utente durante la creazione di tale automazione. Assicurati che le integrazioni e le credenziali richieste siano configurate per tutti i sistemi esterni con cui prevedi di interagire nell'ambito dell'automazione. Dopo aver creato un progetto, fai clic sul pulsante **Inizia a creare** per iniziare. **Nota** È necessario disporre delle autorizzazioni di proprietario per gestire le integrazioni e le credenziali per un gruppo di automazione. ## Metodi di creazione Scegli tra tre approcci per creare la tua automazione. Se non conosci Amazon Quick Automate, ti consigliamo di: + Inizia esplorando esempi di automazioni + Prova a creare un'automazione semplice utilizzando il linguaggio naturale + Sperimenta con la modifica manuale una volta acquisite le nozioni di base ### Utilizzo di automazioni di esempio Inizia rapidamente esplorando esempi predefiniti che dimostrano modelli di automazione comuni. Questi esempi forniscono esempi pratici di diverse funzionalità di automazione e servono come risorse di apprendimento per aiutarti a familiarizzare con le funzionalità di Amazon Quick Automate. Per utilizzare un esempio di automazione: + Cerca per esplorare diversi campioni per settore. + Fai clic sull'esempio per visualizzare una panoramica dell'automazione. + Se sono necessarie integrazioni, queste verranno elencate come prerequisiti. + Fai clic su **Inizia con un esempio** per aprire l'automazione nell'area di disegno. + Ora sarai in grado di visualizzare l'automazione, modificarla e testarla. ### Creazione con linguaggio naturale L'Automation Assistant fornisce un AI-powered approccio alla creazione di automazioni attraverso: + Interfaccia di chat: descrivi il processo in modo colloquiale in linguaggio naturale + Caricamento del documento: importa qualsiasi documentazione che descriva le fasi e i requisiti del processo Quando fornisci un input tramite uno dei due metodi, Automation Assistant genererà l'automazione attraverso un'esperienza guidata in due fasi: + **High-level piano** + Innanzitutto, l'Assistente analizza i requisiti e genera un piano di automazione di alto livello. Il piano è costituito da **fasi di processo** che raggruppano logicamente le azioni correlate come parte dell'automazione. Ogni fase del processo contiene inizialmente istruzioni in linguaggio naturale. + Rivedi e modifica le istruzioni per ogni fase del processo, quindi fai clic su **Genera** per creare le azioni di basso livello per quella fase. + **Low-level azioni** + Successivamente, l'Assistente creerà le azioni di basso livello e la logica di processo in base alle istruzioni dei passaggi. + Rivedi e modifica le azioni generate. Fate clic su **Esegui** o **Debug** per iniziare il test. Le migliori pratiche per fornire input in linguaggio naturale: + Specificate la procedura passo dopo passo come se steste formando un nuovo assunto + Includi i dettagli esatti necessari per eseguire ogni passaggio: + Indirizzo e-mail in caso di invio di un messaggio + Nome e posizione del file uploading/downloading di un documento + URL se si naviga verso un sito Web ### Creazione da zero (automazione vuota) Crea automazioni manualmente utilizzando l'interfaccia di visual designer: + Vai al riepilogo del tuo progetto + Fai clic su **Inizia a costruire** + Seleziona **Salta** per accedere alla tela L'interfaccia di progettazione fornisce diversi componenti chiave: + **Canvas**: visualizza l'automazione. È possibile ingrandire e rimpicciolire, espandere e comprimere le fasi del processo e riordinare le azioni sull'area di disegno. + **Pannello Azioni**: il pannello delle azioni contiene un elenco completo di tutte le azioni di automazione rese disponibili all'interno del gruppo di automazione. È possibile cercare e filtrare per trovare azioni organizzate per categoria (agenti, flusso di processo, browser Web, ecc.). Drag-and-drop azioni sulla tela per creare la tua automazione. Puoi anche fare clic sul segno più che si trova quando passi con il mouse tra le azioni per aggiungere una nuova azione direttamente nell'area di disegno. + **Pannello delle proprietà**: dopo aver aggiunto un'azione o fatto clic su un'azione esistente nel processo, il pannello delle proprietà consente di configurare i parametri di input e output che controllano il comportamento di tale azione. + **Pannello Impostazioni**: consente di creare e modificare configurazioni di runtime ed esplorare le credenziali disponibili per l'automazione. + **Pannello Variabili**: mostra tutte le variabili utilizzate nell'automazione. La creazione di una variabile è semplice: basta aggiungere un nuovo riferimento direttamente nell'automazione. ## Configurazioni e variabili di runtime Le configurazioni di runtime consentono di creare impostazioni facilmente modificabili che vengono utilizzate dall'automazione. Alcuni esempi di configurazioni di runtime includono: + URL dei siti Web + Nomi e posizioni dei file + Configurazioni di posta elettronica come oggetti ed elenchi di mittenti Le variabili vengono utilizzate per archiviare e passare informazioni tra le azioni dell'automazione quando viene eseguita. Aggiungi una nuova variabile all'automazione semplicemente fornendo un nuovo nome di riferimento in una proprietà di output. I tipi di variabili più comuni includono: + String: testo semplice (ad es. nome, descrizione) + Numero: valore numerico (ad es. quantità, punteggio) + Booleano - valore True/False + Array: raccolta o elenco di elementi + Oggetto: Key-value coppie + File: documenti e contenuti multimediali (ad es. PDF, immagini) + Tabella dati: Spreadsheet-like dati con righe e colonne ## Modifica delle automazioni Dopo aver creato l'automazione, puoi modificarla utilizzando l'Automation Assistant o modificandola direttamente sull'area di disegno. ### Usare Automation Assistant L'Automation Assistant consente di apportare modifiche tramite il linguaggio naturale. Puoi: + Richiedi aggiornamenti sull'intera automazione, passaggi specifici o azioni specifiche + Concentra la chat su passaggi specifici selezionandoli prima + Poni domande e ottieni assistenza e suggerimenti integrati nel prodotto in base alla tua effettiva automazione + Chiedi aiuto per scrivere espressioni e codice in base alle tue esigenze Per modificare con l'Assistente: + Fai clic su **Crea con Assistant** nella barra degli strumenti + Descrivi le modifiche che desideri apportare + Rivedi e conferma le modifiche suggerite + La chat include un riepilogo delle modifiche. Fai clic su **Rifiuta le modifiche** per tornare alla versione precedente. + Prova l'automazione aggiornata ### Modifica su tela Apporta le modifiche direttamente nel visual designer: + Seleziona il passaggio o l'azione da modificare + Utilizzate il pannello delle proprietà per regolare le impostazioni + Riorganizza i passaggi usando il drag-and-drop **Nota** Ogni azione ha un menu di opzioni con azioni comuni come duplicare l'azione o eliminarla. **Procedure consigliate per la modifica:** + Apportare modifiche incrementali + Esegui il test dopo ogni modifica significativa **Nota** Le modifiche vengono salvate automaticamente nella versione live. Se desideri implementare tali modifiche, esegui il commit e distribuisci la versione aggiornata. **Suggerimento** Se riscontri problemi durante la creazione: Usa l'Automation Assistant per ricevere assistenza Consulta la documentazione relativa alle azioni per conoscere i requisiti specifici ## Ingressi e uscite di automazione Definisci schemi di input e output per creare automazioni riutilizzabili e parametrizzate in Amazon Quick Automate. Definendo schemi di input e output utilizzando i nodi Start e End, puoi trasformare le automazioni statiche in flussi di lavoro riutilizzabili che accettano dati diversi ogni volta che vengono eseguiti. Invece di codificare i valori, si definiscono parametri di input digitati forniti in fase di esecuzione e valori di output strutturati che vengono acquisiti al termine dell'automazione. Gli input e gli output funzionano con tutti i metodi di invocazione: esecuzioni manuali, chiamate API e trigger pianificati. Principali vantaggi dell'utilizzo di input e output: + **Riusabilità**: esegui la stessa automazione con dati diversi senza modificare l'automazione stessa. + **Sicurezza dei tipi**: Amazon Quick Automate convalida i dati di input rispetto allo schema prima dell'inizio dell'esecuzione, impedendo l'esecuzione di dati non validi. + **Integrazione delle API**: Auto-generated gli schemi consentono il rilevamento programmatico e l'integrazione con sistemi esterni. + **Osservabilità**: gli output strutturati vengono acquisiti come artefatti di esecuzione per l'audit e la revisione. ### Tipi di dati supportati I seguenti tipi di dati sono supportati per i campi di input e output: + **Testo**: valori di testo semplice (ad esempio, text1, text2) + **Numero**: valori numerici inclusi i decimali (ad esempio 3,14, 100) + **Boolean: valori veri o falsi** + **File**: oggetti di file con una dimensione massima di 5 MB ### Nodi di inizio e fine Ogni automazione include un nodo iniziale e un nodo finale, che per impostazione predefinita sono vuoti. È possibile modificare questi nodi per creare uno schema, utilizzare gli input dell'automazione e aggiornare i dati di output in modo che ritornino dall'automazione. Il nodo Start riceve i dati di input in fase di esecuzione, mentre i nodi End Process (inclusi i nodi End Process) raccolgono i dati di output durante l'esecuzione e li restituiscono come artefatti strutturati al termine dell'automazione. #### Start (Avvio) Il nodo Start è il punto di ingresso che accetta i parametri di input quando viene attivata l'automazione. Per impostazione predefinita, è vuoto. Proprietà: + **Formato di input**: definisce lo schema per i parametri di input accettati dall'automazione. Modifica utilizzando l'editor dello schema di input descritto in Definizione degli schemi di input e output. + **Variabile di input**: variabile che memorizza i valori di input per l'automazione come definito nel formato di input e fornito dall'utente. #### End Il nodo End è il punto di terminazione che raccoglie e restituisce i valori di output quando l'automazione viene completata correttamente. È possibile impostare i valori di output delle variabili nell'automazione utilizzando le proprietà del nodo Fine. L'automazione può avere più nodi finali (processo finale) in base alla struttura dell'automazione. Proprietà: + **Formato di output**: definisce lo schema per i parametri di output restituiti dall'automazione. Scegliete **Modifica** e aggiungete o modificate lo schema utilizzando l'editor dello schema di output descritto in Definizione degli schemi di input e output. + **Dati di output**: mappa i valori delle variabili dell'automazione ai campi di output che hai definito. Per ogni variabile di output creata nel nodo Fine (schema di output), specifica quale variabile di automazione contiene i dati che desideri restituire. Utilizzate l'editor **Modifica dati di output** per configurare queste mappature nel campo **Valore di output**. ### Definizione degli schemi di input e output Gli schemi definiscono la struttura dei dati che l'automazione accetta come input e produce come output. Lo studio di creazione fornisce un generatore di moduli visivi per definire schemi di input e output direttamente nell'area di automazione. Per definire uno schema di input: + Apri la tua automazione in Amazon Quick Automate. + Scegli il nodo **Start** nell'area di disegno per aprire l'editor dello schema. È inoltre possibile aprire l'editor dello schema dal pannello delle proprietà. A tale scopo, scegliete il nodo **Start**, quindi scegliete **Modifica** in **formato di input** nel riquadro delle proprietà. + **Scegliete \+Aggiungi campo** per aggiungere un campo di input. + Per ogni campo di input, configura le seguenti proprietà: + **Nome**: un identificatore univoco per il campo. + **Tipo**: il tipo di dati che il campo accetta. Per ulteriori informazioni, consulta Tipi di dati supportati. + **Obbligatorio**: indica se il campo deve essere fornito durante l'esecuzione dell'automazione. + **Valore predefinito** (opzionale): questa opzione è attiva solo se il campo **Obbligatorio** è deselezionato. I valori predefiniti vengono visualizzati precompilati nel modulo di input quando si esegue un test o si attiva l'automazione. + **Descrizione**: una descrizione di ciò che rappresenta il campo. + Scegli **Salva** per memorizzare lo schema con la tua automazione. Per definire uno schema di output: + Scegliete un nodo **finale** sull'area di disegno per aprire l'editor dello schema di output. È inoltre possibile aprire l'editor dello schema dal pannello delle proprietà. A tale scopo, scegliete il nodo **Fine**, quindi scegliete **Modifica** in **formato di output** nel riquadro delle proprietà. + Scegli **\+Aggiungi campo** per aggiungere un campo di output. + Per ogni campo di output, configura le seguenti proprietà: + **Nome**: un identificatore univoco per il campo. + **Tipo**: il tipo di dati per l'output. + **Descrizione**: una descrizione di ciò che rappresenta l'output. + Scegli **Save** (Salva). **Nota** È possibile definire gli input dal nodo Start e gli output da qualsiasi nodo End. Se l'automazione ha più nodi finali, l'aggiunta o la modifica dello schema di un nodo finale modifica tutti gli schemi dei nodi finali. ### Utilizzo dei valori di input dal nodo iniziale Quando l'automazione ha uno schema di input definito nel nodo Start, è possibile accedere a tali valori di input durante tutto il flusso di lavoro utilizzando il `inputs` dizionario. Il runtime convalida e compila automaticamente questo dizionario con i valori forniti durante l'esecuzione dell'automazione. ``` # Access required input fields value = inputs["field_name"] # Example usage customer_id = inputs["customer_id"] # Retrieves a required string input ``` ### Impostazione dei valori di output nel nodo End Il nodo Fine definisce quali valori dell'automazione vengono restituiti come output. Puoi configurarlo utilizzando la proprietà **Output Data**, che fornisce due modalità di interazione per impostare i valori di output nell'editor. Passa da una modalità all'altra scegliendo l'icona del codice (``) accanto al campo del **valore di output**. Due modalità per impostare le uscite: + **Modalità di selezione variabile (menu a discesa)**: l'interfaccia predefinita mostra un elenco a discesa di tutte le variabili disponibili nell'automazione. Seleziona la variabile che desideri assegnare a ciascun campo di output. + **Modalità espressione (codice)**: scegli l'icona del codice (``) accanto a qualsiasi campo del valore di output per passare alla modalità espressione. Questa modalità consente di inserire espressioni personalizzate, eseguire calcoli, accedere a dati annidati o impostare valori letterali. ### Definizione degli schemi con Build with Assistant Build with Assistant può creare o modificare direttamente gli schemi di input e output. Descrivi i tuoi requisiti di input e output in linguaggio naturale e l'assistente genererà la definizione dello schema per te. Qualsiasi modifica apportata dall'assistente si sincronizza automaticamente con il generatore di moduli visivi di Studio. ### Considerazioni Tieni presente quanto segue quando utilizzi input e output di automazione: + Gli schemi di input e output sono opzionali. Le automazioni esistenti senza schemi continuano a funzionare invariate. + Gli input dei file hanno una dimensione massima di 5 MB. Per file di grandi dimensioni, inserisci invece la posizione del file (ad esempio un percorso Amazon S3) come input di testo. + I valori di input e output vengono memorizzati a ogni esecuzione per scopi di osservabilità e controllo. + Quando si aggiorna uno schema, è necessario ridistribuire l'automazione affinché le modifiche abbiano effetto sulle esecuzioni distribuite. Le esecuzioni di test utilizzano sempre la bozza dello schema più recente. È possibile utilizzare i valori di input e output nei seguenti modi: + Testare ed eseguire l'automazione dalla tela. Per ulteriori informazioni, consulta [Testare le automazioni.](https://docs.aws.amazon.com/quicksuite/latest/userguide/testing-automations.html#running-and-debugging) + Attivazione manuale delle automazioni distribuite. [Per ulteriori informazioni, consulta Distribuzione delle automazioni.](https://docs.aws.amazon.com/quicksuite/latest/userguide/deploying-automations.html#deploy-run-inputs-outputs) + Trigger pianificati per le automazioni distribuite. [Per ulteriori informazioni, consulta Distribuzione delle automazioni.](https://docs.aws.amazon.com/quicksuite/latest/userguide/deploying-automations.html#deploy-run-inputs-outputs) ## Gestione delle versioni di automazione Amazon Quick Automate offre funzionalità di controllo delle versioni per aiutarti a tenere traccia e mantenere la cronologia degli aggiornamenti delle tue automazioni e ripristinare facilmente le versioni precedenti. ### Concetti chiave + **Versione live**: l'attuale copia di lavoro dell'automazione che puoi modificare nell'area di lavoro. Le modifiche vengono salvate automaticamente nella versione live durante la modifica. + **Versioni impegnate**: Read-only istantanee dell'automazione che possono essere implementate. Implementa una nuova versione dell'automazione per tenere traccia degli aggiornamenti significativi ed essere in grado di ripristinarla se necessario. + **Versioni distribuite: le** versioni impegnate possono essere distribuite e attivate per essere eseguite secondo una pianificazione. **Nota** Ogni versione mantiene i propri valori di configurazione di runtime. Le modifiche alle impostazioni di runtime della versione Live non influiscono sulle versioni salvate o distribuite in precedenza. ### Versioni di commit Per eseguire il commit di una versione: + Fai clic su **Conferma** nella barra degli strumenti del canvas + Aggiungi una nota descrittiva che spieghi le modifiche + Scegli come incrementare il numero di versione: + Versione secondaria (ad esempio, 1.05 → 1.06) per aggiornamenti più piccoli (impostazione predefinita) + Versione principale (ad esempio, 1.0 → 2.0) per modifiche significative + Fai clic su **Conferma** **Importante** Non puoi eseguire il commit di una versione se l'automazione presenta errori di convalida. Risolvi tutti gli errori prima di tentare di eseguire il commit. Quando esegui il commit di una versione: + La versione confermata diventa un'istantanea di sola lettura + La configurazione di runtime corrente viene salvata con la versione confermata + Viene creata una nuova versione Live basata su quell'istantanea per continuare la modifica **Importante** È possibile distribuire solo versioni impegnate. La versione Live deve essere salvata prima di poter essere distribuita. ### Visualizzazione delle versioni Visualizza le versioni in due posizioni: + Menu **a discesa delle versioni in canvas**: l'impostazione predefinita è la versione Live. Scegli una versione precedente dal menu a discesa per visualizzarla in modalità di sola lettura sull'area di disegno. + **Scheda Versioni**: disponibile nei dettagli del progetto. Mostra una cronologia completa delle versioni, incluso il numero di versione, la data in cui è stato eseguito il commit della versione, l'utente che ha eseguito il commit della versione e tutte le note sulla versione. Fai clic sul menu delle azioni per visualizzare i dettagli della versione o distribuire la versione. ### Ripristino di versioni precedenti Per ripristinare una versione precedente e continuare a modificarla come versione Live: + Seleziona la versione dal menu a discesa della versione sopra l'area di disegno + Scegli **Ripristina la versione live** + La versione selezionata sostituisce la versione Live attuale + Continua a modificare la versione Live per apportare le modifiche necessarie + Crea una nuova versione per scattare un'istantanea o distribuire gli aggiornamenti **Nota** Il ripristino di una versione crea una nuova copia di lavoro ma non elimina la cronologia delle versioni. ### Best practice + Aggiungi note chiare sulla versione per tenere traccia dello scopo delle modifiche + Conferma le versioni dopo aggiornamenti significativi + Verifica le modifiche prima di eseguire il commit + Controlla la configurazione del runtime prima di eseguire il commit