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à.
# Implementazione di automazioni
Dopo aver creato e testato le automazioni in Amazon Quick Automate, il passaggio successivo consiste nel **distribuirle** in modo che possano essere eseguite regolarmente su un trigger. L'implementazione rende l'automazione operativa e pronta per l'esecuzione. È possibile aggiungere un trigger a un'automazione distribuita per eseguirla secondo una pianificazione predefinita. L'implementazione prevede la configurazione delle impostazioni di runtime, l'assegnazione degli utenti per le attività di tipo human-in-the-loop, la verifica delle credenziali e delle integrazioni.
Questa sezione spiega ogni fase del processo di distribuzione e come configurare l'automazione per garantire affidabilità, sicurezza e prestazioni ottimali.
## Prerequisiti
Prima di implementare l'automazione, assicurati che i seguenti passaggi siano stati completati:
+ **L'automazione viene testata a fondo**: convalida l'automazione tramite test end-to-end per confermare che tutta la logica, le azioni e le interazioni con gli agenti funzionino come previsto.
+ **Versione confermata per la distribuzione**: è possibile implementare solo versioni di automazione impegnate. Rivedi le modifiche, finalizza la versione e confermala prima di procedere.
+ **Integrazioni configurate**: se l'automazione interagisce con applicazioni esterne come Salesforce o Jira tramite API, assicurati che tutte le integrazioni necessarie siano configurate.
+ Vai a **Connessioni → Integrazioni nel pannello di sinistra per creare nuove integrazioni**.
+ Attualmente, solo le integrazioni disponibili nella scheda **Azioni** sono supportate in Amazon Quick Automate.
+ Una volta creata un'azione di integrazione, associala all'**Automation Group** dove verrà utilizzata.
+ Le azioni associate verranno quindi visualizzate nell'area di disegno. Durante la distribuzione, è possibile selezionare la connessione appropriata da utilizzare dall'automazione distribuita.
+ **Credenziali configurate**: verifica che tutte le credenziali richieste dall'automazione siano impostate correttamente.
## Implementazione di un'automazione
Puoi implementare un'automazione direttamente da Canvas facendo clic su Deploy o accedendo alla scheda Deployment nella pagina di destinazione dell'automazione. Una volta avviata la distribuzione, il sistema guida l'utente attraverso una serie di passaggi per completare il processo di configurazione e rilascio.
### Dettagli sulla versione
Nella pagina **Dettagli sulla versione**, seleziona la versione dell'automazione che desideri distribuire. Solo **le versioni impegnate** sono disponibili per la distribuzione e verranno visualizzate nell'elenco a discesa.
### Impostazioni aggiuntive
Le impostazioni aggiuntive includono:
+ **Configurazione di runtime**
+ **Attività (per assegnazioni HITL)**
+ **Accesso**
#### Configurazione di runtime
Le configurazioni di runtime sono parametri che possono differire tra ambienti come sviluppo, test e produzione.
Ad esempio, una fase di automazione che invia un'e-mail può utilizzare il tuo indirizzo e-mail personale durante il test, ma dovrebbe passare a un indirizzo condiviso del team in produzione. Tali valori dipendenti dall'ambiente possono essere definiti come **configurazioni di runtime** durante la creazione dell'automazione.
Al momento dell'implementazione, è possibile rivedere e sovrascrivere queste configurazioni per garantire che l'automazione funzioni correttamente nell'ambiente previsto. I parametri di runtime possono includere:
+ Indirizzi e-mail o destinatari delle notifiche
+ Percorsi di file o URL specifici dell'ambiente
Questa flessibilità aiuta a mantenere un'unica definizione di automazione tra gli ambienti, adattando al contempo i parametri chiave in base alle esigenze.
#### Processi
Seleziona gli utenti o i gruppi di utenti del resolver per ciascuna delle attività che richiedono l'approccio human-in-the-loop.
#### Accesso (credenziali e connessioni)
Le automazioni spesso devono connettersi a sistemi, database o servizi esterni. Amazon Quick Automate offre metodi sicuri per la gestione di credenziali e connessioni senza incorporare informazioni sensibili nella logica di automazione.
I dati di connessione e le credenziali vengono archiviati e crittografati in modo sicuro e resi disponibili ai flussi di lavoro in fase di esecuzione senza esporli agli autori o agli utenti finali. Questo design garantisce una forte separazione dei segreti dalle definizioni di automazione, migliorando sia la sicurezza che la manutenibilità.
È possibile archiviare e utilizzare due tipi principali di credenziali:
+ **Credenziali del sito Web**: utilizzate per le fasi di automazione dell'interfaccia utente che richiedono l'accesso al sito Web (nome utente e password).
+ **Credenziali di azione (integrazioni)**: utilizzate per connettere AWS servizi (ad esempio S3) o sistemi esterni tramite integrazioni configurate (ad esempio Salesforce, Jira).
Al momento dell'implementazione, assicurati che siano selezionate le credenziali e le connessioni corrette in modo che l'automazione possa accedere a tutti i sistemi richiesti in modo sicuro e corretto.
## Configurazione dei trigger
I trigger determinano quando e come vengono eseguite le automazioni. Puoi configurare le automazioni per avviarle in base a una pianificazione predefinita o richiamarle a livello di codice tramite l'API Amazon. QuickSight
### Piani
Puoi configurare le automazioni in modo che vengano avviate in base a una pianificazione predefinita. Per configurare un trigger:
+ Nella pagina Distribuzione, fai clic su «Crea trigger» e configura le regole.
+ Seleziona la frequenza
+ Seleziona la data e l'ora di inizio (tieni presente che l'esecuzione effettiva inizierà entro 15 minuti dall'ora di inizio selezionata)
+ Seleziona la data e l'ora di fine
+ Seleziona il fuso orario
+ Amazon Quick Automate ha fornito scalabilità integrata. Seleziona il numero di esecuzioni parallele dell'automazione (puoi selezionare un massimo di 10 esecuzioni parallele per trigger e 50 per tutte le automazioni all'interno di un account. Si prega di contattare) AWS
+ Per esigenze di pianificazione complesse, puoi utilizzare le espressioni cron per definire schemi di esecuzione precisi. Ad esempio, per eseguire un'automazione alle 2:30 del mattino ogni lunedì, mercoledì e venerdì, dovresti usare l'espressione cron:. `30 2 * * 1,3,5`
### Trigger API
Le API Automation Job consentono di avviare e monitorare in modo programmatico i lavori di automazione da applicazioni esterne. Puoi utilizzare queste API per richiamare automazioni distribuite con payload di input personalizzati e recuperare i risultati di esecuzione tramite SDK e. AWS AWS CLI
Le API Automation Job includono due operazioni:
+ **StartAutomationJob**— Avvia un nuovo processo per un'automazione distribuita con un payload di input opzionale.
+ **DescribeAutomationJob**— Recupera lo stato, i timestamp e i payload di input e output opzionali per un lavoro specifico.
Queste API fanno parte del namespace del QuickSight servizio Amazon. Puoi accedervi tramite lo spazio dei `quicksight` nomi nell'SDK e. AWS AWS CLI
[Per ulteriori informazioni su AWS SDK e toolkit, consulta il Getting Started Resource Center.AWS](https://aws.amazon.com/getting-started/tools-sdks/)
#### Prerequisiti
Prima di chiamare le API di Automation Job, completa i seguenti passaggi di configurazione.
##### Trova i tuoi identificatori di automazione
Per chiamare le API di Automation Job, sono necessari i seguenti identificatori:
+ **AWS account ID: l'ID** dell'account a 12 cifre AWS .
+ **ID del gruppo di automazione**: l'ID univoco del gruppo di automazione che contiene l'automazione.
+ **ID di automazione**: l'ID univoco dell'automazione che desideri richiamare.
Puoi trovare l'ID del gruppo di automazione e l'ID di automazione nella sezione Distribuzioni quando apri un'automazione e disponi di una versione distribuita.
**Per trovare i tuoi identificatori**
+ Accedi ad Amazon Quick Automate.
+ Nel riquadro di navigazione a sinistra, scegli **Automazioni**.
+ Scegli il gruppo di automazione che contiene l'automazione.
+ Scegli il nome dell'automazione per aprire l'editor di automazione.
+ Seleziona la scheda **Distribuzioni**.
+ Scegli **Azioni (⋮)** e **Visualizza i dettagli della distribuzione per visualizzare** l'ID di **automazione e l'ID** di **gruppo** nella parte superiore, appena sotto l'intestazione Dettagli sulla distribuzione.
##### Configurazione delle autorizzazioni IAM
Le API Automation Job richiedono autorizzazioni IAM associate alla tua identità IAM (utente, ruolo o gruppo). Ogni operazione richiede un'autorizzazione separata.
**Autorizzazione per StartAutomationJob**
Allega una politica che autorizzi l'`quicksight:StartAutomationJob`azione. Inquadra l'ARN della risorsa in base all'automazione specifica che desideri consentire.
```
{
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "AllowStartAutomationJob",
"Effect": "Allow",
"Action": [
"quicksight:StartAutomationJob"
],
"Resource": [
"arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
]
}
]
}
```
**Autorizzazione per DescribeAutomationJob**
Allega una politica che autorizzi l'`quicksight:DescribeAutomationJob`azione. L'ARN della risorsa per questa operazione include il segmento Job ID. Per consentire la descrizione di qualsiasi lavoro nell'ambito di un'automazione, utilizza un carattere jolly (\*) per il segmento di lavoro.
```
{
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "AllowDescribeAutomationJob",
"Effect": "Allow",
"Action": [
"quicksight:DescribeAutomationJob"
],
"Resource": [
"arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
]
}
]
}
```
AWS consiglia di assegnare ogni autorizzazione alla risorsa ARN più specifica possibile per seguire il principio del privilegio minimo. Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Esempi di policy IAM per Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)
+ [Azioni, risorse e chiavi di condizione](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)
+ [Elementi della policy IAM JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)
##### Implementa la tua automazione
L' StartAutomationJob API si rivolge solo alle automazioni implementate. È necessario eseguire il commit e distribuire l'automazione nella console Amazon Quick Automate prima di poterla richiamare tramite l'API.
#### StartAutomationJob
Inizia un nuovo lavoro per un'automazione distribuita. L'operazione è asincrona: Amazon Quick Automate accetta la richiesta, mette in coda il lavoro e ne restituisce immediatamente uno. **JobId** L'automazione viene eseguita in background. Se l'automazione ha uno schema di input definito, Amazon Quick Automate lo convalida **InputPayload**rispetto allo schema prima di accettare il lavoro. Un payload non valido genera un. **InvalidParameterValueException**
##### Sintassi della richiesta
```
POST /accounts/{{AwsAccountId}}/automation-groups/{{AutomationGroupId}}/automations/{{AutomationId}}/jobs HTTP/1.1
Content-type: application/json
{
"InputPayload": "string"
}
```
##### Parametri della richiesta
+ **AwsAccountId**(Stringa, obbligatoria): l'ID AWS del tuo account (12 cifre).
+ **AutomationGroupId**(String, required) — L'ID del gruppo di automazione (UUID).
+ **AutomationId**(String, required) — L'ID dell'automazione da eseguire (UUID).
+ **InputPayload**(Stringa, opzionale): input per il processo come stringa JSON.
##### Elementi di risposta
+ **Arn** (String) — ARN del processo di automazione.
+ **JobId**(String) — ID del processo avviato. Usalo con `DescribeAutomationJob` per tenere traccia dello stato.
+ **Status** (numero intero): codice di stato HTTP della risposta.
+ **RequestId**(String) — ID della AWS richiesta.
##### Errori
+ **AccessDeniedException**— Autorizzazioni insufficienti o credenziali non valide.
+ **InvalidParameterValueException**— Uno o più parametri hanno un valore non valido.
+ **ResourceNotFoundException**— Gruppo di automazione o automazione non trovato.
+ **LimitExceededException**— È stato superato un limite.
+ **ThrottlingException**— La richiesta è stata limitata.
+ **InternalFailureException**— Errore interno del servizio.
Per maggiori dettagli, consulta la [guida di riferimento dell'API per StartAutomationJob](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_StartAutomationJob.html).
#### DescribeAutomationJob
Recupera lo stato e i dettagli di un processo di automazione specifico, inclusi i timestamp di esecuzione e i payload di input e output opzionali. Utilizzate questa operazione per verificare il completamento del lavoro dopo la chiamata. **StartAutomationJob**
Per impostazione predefinita, la risposta non include i payload di input e output. Imposta i parametri **IncludeInputPayload**e **IncludeOutputPayload**interroga su `true` per richiederli. Amazon Quick Automate restituisce il payload di output solo quando sono soddisfatte tutte le seguenti condizioni:
+ **IncludeOutputPayload** è `true`.
+ **JobStatus** è `SUCCEEDED`.
+ L'automazione ha prodotto valori di output.
##### Sintassi della richiesta
```
GET /accounts/{{AwsAccountId}}/automation-groups/{{AutomationGroupId}}/automations/{{AutomationId}}/jobs/{{JobId}}?IncludeInputPayload={{boolean}}&IncludeOutputPayload={{boolean}} HTTP/1.1
```
##### Parametri della richiesta
+ **AwsAccountId**(Stringa, obbligatoria): l'ID AWS del tuo account (12 cifre).
+ **AutomationGroupId**(String, required) — L'ID del gruppo di automazione (UUID).
+ **AutomationId**(String, required) — L'ID dell'automazione (UUID).
+ **JobId**(String, required) — L'ID del processo restituito da `StartAutomationJob` (UUID).
+ **IncludeInputPayload**(Booleano, opzionale): include il payload di input nella risposta. Default: `false`.
+ **IncludeOutputPayload**(Booleano, opzionale): include il payload di output nella risposta. Default: `false`.
##### Campi di risposta
+ **Arn** (String) — ARN del processo di automazione.
+ **CreatedAt**(Timestamp) — Quando il lavoro è stato creato (epoca in secondi).
+ **StartedAt**(Timestamp) — Quando il processo ha iniziato a funzionare (epoca in secondi).
+ **EndedAt**(Timestamp) — Quando il lavoro è terminato (epoca in secondi).
+ **JobStatus**(Stringa) —`QUEUED`,, `RUNNING``SUCCEEDED`, `FAILED` o. `STOPPED`
+ **InputPayload**(String) — Il payload di input. Omesso dalla risposta a meno che non `IncludeInputPayload` lo sia. `true`
+ **OutputPayload**(String) — Il payload di output. Omesso dalla risposta a meno che non `IncludeOutputPayload` lo sia. `true`
+ **RequestId**(String) — ID della AWS richiesta.
##### Errori
+ **AccessDeniedException**— Autorizzazioni insufficienti o credenziali non valide.
+ **InvalidParameterValueException**— Uno o più parametri hanno un valore non valido.
+ **ResourceNotFoundException**— Job, automazione o gruppo di automazione non trovato.
+ **ThrottlingException**— La richiesta è stata limitata.
+ **InternalFailureException**— Errore interno del servizio.
Per maggiori dettagli, consulta la [guida di riferimento dell'API per DescribeAutomationJob](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeAutomationJob.html).
## Esegui automazioni con trigger API utilizzando input e output
Puoi includere valori di input come payload JSON quando avvii un processo di automazione tramite l'API. Amazon Quick Automate convalida il payload rispetto allo schema di input dell'automazione prima dell'inizio dell'esecuzione e restituisce valori di output strutturati al termine del processo.
### Prerequisiti
Prima di eseguire un'automazione con trigger API, assicurati che siano presenti le seguenti condizioni:
+ L'automazione è stata implementata.
+ L'automazione ha uno schema di input definito nel nodo Start.
+ Hai l'ID del gruppo di automazione e l'ID di automazione.
### Invio di valori di input tramite l'API
Per includere i valori di input, passate un payload JSON nella **StartAutomationJob**richiesta utilizzando il **InputPayload**parametro.
```
Sample Request
POST /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs
{
"InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}"
}
Sample Response
{
"Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"JobId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"Status": 200,
"RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}
```
**Nota**
Il `InputPayload` valore deve essere una JSON-serialized stringa che contiene i valori dei campi di input che corrispondono allo schema di input dell'automazione.
### Recupero dei valori di output tramite l'API
È possibile recuperare i valori di output chiamando l'API. **DescribeAutomationJob** Per includere i payload di input e output nella risposta, imposta i parametri di OutputPayload query di **inclusione InputPayload** e **inclusione** su. `true`
La risposta include il **OutputPayload**campo solo quando l'automazione viene completata correttamente.
```
Sample Request
GET /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?includeInputPayload=true&includeOutputPayload=true
Sample Response
{
"Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"JobStatus": "SUCCEEDED",
"CreatedAt": "2026-03-11T09:59:50Z",
"StartedAt": "2026-03-11T10:00:00Z",
"EndedAt": "2026-03-11T10:05:00Z",
"InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}",
"OutputPayload": "{\"result\":\"success\",\"records_processed\":42,\"summary\":{\"passed\":40,\"failed\":2}}",
"RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}
```
**Nota**
Il **OutputPayload**campo è disponibile solo dopo che l'automazione è stata completata correttamente (quando **JobStatus**è`SUCCEEDED`). Se l'automazione fallisce o è ancora in esecuzione, la risposta non include il **OutputPayload**campo.
## Implementa ed esegui automazioni con input e output
Questa sezione descrive come distribuire automazioni che utilizzano schemi di input e output, eseguirle manualmente o secondo una pianificazione e visualizzare i risultati di esecuzione.
### Visualizza le informazioni sullo schema prima della distribuzione
Prima di distribuire un'automazione, è necessario confermarla per creare una versione. Per ulteriori informazioni, consulta [Manutenzione delle versioni di automazione](https://docs.aws.amazon.com/quicksuite/latest/userguide/building-automations.html#managing-automation-versions).
Dopo aver eseguito un'automazione con schemi di input o output, puoi visualizzare i dettagli dello schema nella sezione **Modello di dati** della pagina dei dettagli della versione. Questa sezione mostra le definizioni complete dei campi sia per gli input che per gli output.
### Implementa automazioni con schemi di input e output
Quando si distribuisce un'automazione con schemi di input o output definiti, la finestra di dialogo di distribuzione visualizza le informazioni sullo schema nella sezione Modello di **dati**, tra cui:
+ Definizioni dei campi di input e output (nome, tipo di dati, descrizione, stato obbligatorio o facoltativo e valori predefiniti).
+ Schemi JSON copiabili per input e output che i chiamanti API possono utilizzare per l'integrazione.
**Importante**
Lo schema viene bloccato al momento della distribuzione insieme al codice di automazione. Se si aggiorna lo schema dopo la distribuzione, è necessario ridistribuire l'automazione affinché le modifiche abbiano effetto.
**Per completare la distribuzione, esamina le informazioni sullo schema e scegli Distribuisci.**
### Esegui le automazioni distribuite manualmente
Per avviare un'automazione distribuita con input, completa i seguenti passaggi:
+ Nella pagina di distribuzione, scegli il menu **Azioni** (⋮).
+ Scegli **Esegui ora**.
+ Nella finestra di dialogo **Fornisci valori di input**, inserisci i valori per ogni campo di input.
+ Scegliete **Avvia** per avviare l'esecuzione dell'automazione.
Il modulo di input è identico a quello che usi quando esegui il test in Studio.
### Esegui automazioni con trigger pianificati
Per i trigger pianificati, fornisci i valori di input quando crei o modifichi il trigger. I valori memorizzati vengono passati all'automazione ogni volta che si attiva il trigger.
È possibile effettuare le seguenti operazioni:
+ Crea più trigger con valori di input diversi per la stessa automazione
+ Modifica i valori di input per un trigger senza ridistribuire l'automazione
Per configurare gli input per un trigger pianificato, completa i seguenti passaggi:
+ Vai alla pagina di distribuzione per l'automazione.
+ Scegli **Create Trigger**.
+ Nel **passaggio 1: Imposta Trigger**, configura la pianificazione.
+ Nel **Passaggio 2: Definisci Esegui**, inserisci i valori per ogni campo di input nel modulo generato automaticamente.
+ Scegli **Avanti**, rivedi la configurazione e scegli **Create Trigger**.
**Nota**
Se crei un trigger con una versione dello schema specifica e successivamente distribuisci l'automazione con uno schema aggiornato, devi modificare il trigger. Il trigger diventa incompatibile quando la versione dello schema cambia e le esecuzioni di automazione falliranno.
### Visualizzazione degli input e degli output per le esecuzioni distribuite
**Al termine di un'esecuzione di automazione (avviata manualmente o da un trigger pianificato), i valori di input e output sono disponibili come artefatti strutturati nel pannello dei log della pagina Esecuzioni.**
Gli artefatti appaiono come schede dedicate:
+ **Artefatto di input**: viene visualizzato nella parte superiore del pannello dei registri
+ **Artefatto di output**: viene visualizzato nella parte inferiore del pannello dei registri (disponibile solo se l'automazione viene completata correttamente)
Per impostazione predefinita, entrambe le carte sono compresse. Quando le espandi, puoi:
+ Visualizza lo schema completo e i valori effettivi
+ Scarica tutti gli oggetti di file inclusi negli input o negli output
+ Copia i dati strutturati come JSON
+ Scarica il payload completo come file JSON