> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gocromo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crea ed esegui un Flusso di lavoro

> Progetta un processo ripetibile nella Chat, esamina il grafico, provalo manualmente, attiva un trigger e analizza le esecuzioni.

Usa questa guida per trasformare un processo manuale collaudato in un Flusso di lavoro, testarlo senza effetti nascosti e analizzare ogni esecuzione. L'esempio prepara un riepilogo settimanale dei rinnovi.

## Prima di automatizzare

Esegui una volta l'attività nella Chat con input rappresentativi:

> Leggi la tabella Renewals. Trova i record in scadenza nei prossimi 90 giorni, raggruppali per Account Owner, segnala quelli ad alto rischio o senza prossima azione e restituisci un riepilogo Markdown. Non aggiornare i record.

Confronta la risposta con la tabella e concorda il risultato con il responsabile. Devi poter indicare input, output, asset utilizzabili, effetti esterni, condizioni di errore e responsabile delle esecuzioni non riuscite.

## Crea il flusso di lavoro

Apri **Flussi di lavoro** nella barra laterale.

<Frame caption="La pagina Flussi di lavoro mostra automazioni attive, trigger, stato, esecuzioni recenti e attivazione.">
  <img src="https://mintcdn.com/cromo/ZXd_ebQgmZrqMtVt/images/product/it-workflows-list.webp?fit=max&auto=format&n=ZXd_ebQgmZrqMtVt&q=85&s=1f39dfc21d18c91da09f60645b562e87" alt="Pagina Flussi di lavoro Cromo con Renewal review summary attivo, trigger manuale ed esecuzioni riuscite" width="1600" height="1000" data-path="images/product/it-workflows-list.webp" />
</Frame>

* Seleziona **Nuovo flusso di lavoro** per avviare una richiesta guidata nella Chat.
* Seleziona **Crea da JSON** se possiedi già una definizione revisionata.

```text theme={null}
Crea un Flusso di lavoro chiamato Renewal review summary.

Input: as_of_date facoltativa, predefinita alla data dell'esecuzione.
Leggi: tabella Renewals e pagina Conoscenza Renewal Policy.
Processo: seleziona rinnovi entro 90 giorni, raggruppa per account_owner,
segnala risk_level = high o next_action vuota.
Output: riepilogo Markdown; non aggiornare la tabella.
In caso di errore includi nome tabella e as-of date.
Trigger: manuale durante i test.
```

Indica tabelle, pagine, campi ed effetti concreti. Evita richieste indefinite come “gestisci automaticamente i rinnovi”.

## Esamina la definizione

Apri il flusso di lavoro. La pagina contiene **Grafo**, **JSON**, **Trigger** e **Esecuzioni recenti**.

<Frame caption="Grafo mostra l'ordine di esecuzione; Esecuzioni recenti registra il risultato di ogni esecuzione.">
  <img src="https://mintcdn.com/cromo/ZXd_ebQgmZrqMtVt/images/product/it-workflow-detail.webp?fit=max&auto=format&n=ZXd_ebQgmZrqMtVt&q=85&s=4fb69ba0e382052450dcd62e037976ba" alt="Dettaglio Flusso di lavoro Cromo con nodi prepare_summary e publish_result, trigger manuale e un'esecuzione riuscita" width="1600" height="1000" data-path="images/product/it-workflow-detail.webp" />
</Frame>

Nel grafico segui ogni collegamento dal trigger all'output finale. Per ogni nodo verifica input, origine dei valori, asset o connettori utilizzabili, output, effetti e comportamento in caso di errore. Usa **JSON** per controllare nomi, valori predefiniti e mappature esatte.

## Richiedi una modifica

Seleziona **Chiedi di modificare** e descrivi un cambiamento con la sua condizione di accettazione:

> Se non ci sono rinnovi, restituisci “No renewals require review” e non creare file. Includi nome tabella e as-of date negli errori. Mantieni il trigger manuale.

Riapri Grafo e JSON e conferma che rami e permessi non interessati siano rimasti invariati.

## Esegui un test manuale sicuro

Seleziona **Esegui ora**. Cromo genera il modulo di input dalla definizione.

* usa valori rappresentativi;
* scegli il file o riferimento del Progetto corretto;
* ogni input file può raggiungere 10 MB;
* per le scritture usa copie o record eliminabili;
* mantieni disattivate le scritture esterne finché lettura e mappature non sono corrette.

## Esamina un'esecuzione

Seleziona la riga in **Esecuzioni recenti**. Controlla stato generale, argomenti risolti, input e output dei nodi, rami ignorati, nuovi tentativi, file, risposte dei connettori, output finale e modifiche effettuate.

Non ripetere alla cieca un'esecuzione parzialmente non riuscita: verifica prima se un nodo precedente ha già creato un file, inviato un messaggio o modificato un record.

## Configura il trigger

Mantieni il flusso di lavoro manuale finché un'esecuzione rappresentativa non riesce.

| Trigger         | Utilizzo                          | Verifica                                            |
| --------------- | --------------------------------- | --------------------------------------------------- |
| **Manuale**     | Lavoro su richiesta e test        | Input e istruzioni per l'operatore                  |
| **Pianificato** | Revisioni e report ricorrenti     | Fuso orario, giorno, frequenza e esecuzioni mancate |
| **Webhook**     | Chiamate da un'altra applicazione | Segreto, payload e nuovi tentativi                  |
| **Evento**      | Evento Cromo supportato           | Ambito e protezione da cicli o duplicati            |

Per una pianificazione indica il fuso orario nella descrizione. Per un webhook conserva il segreto in sicurezza e ruotalo se esposto. Usa **Metti in pausa** quando responsabile, input, credenziale o destinazione non sono più affidabili.

## Test di accettazione

| Caso                          | Risultato atteso                                      |
| ----------------------------- | ----------------------------------------------------- |
| Due rinnovi ad alto rischio   | Entrambi sotto i responsabili corretti                |
| Nessun rinnovo nella finestra | Riepilogo vuoto chiaro; nessun file inutile           |
| `next_action` mancante        | Record segnalato, non omesso                          |
| Tabella non disponibile       | Errore con nome tabella e as-of date                  |
| Timeout di un connettore      | Nuovi tentativi conformi; nessuna scrittura duplicata |
| Webhook consegnato due volte  | Nessun record esterno duplicato                       |

## Risoluzione dei problemi

### Esegui ora non mostra un input previsto

Controlla in JSON che sia dichiarato nel contratto con tipo e valore predefinito.

### Un nodo riceve un valore errato

Confronta il nome dell'output prodotto con la mappatura dell'input consumato, inclusi maiuscole, valori facoltativi e rami ignorati.

### Il flusso di lavoro non legge tabella, file o pagina

Conferma che l'asset esista nello stesso Progetto e aggiorna il riferimento con **Chiedi di modificare** se è stato rinominato o sostituito.

### Un'operazione del connettore è negata

Controlla connessione, credenziale e accesso del Progetto. L'accesso Sola lettura non consente scritture. Consulta [Collega un'app o un server MCP](/it/guides/connect-an-app-or-mcp-server).

### La esecuzione riesce ma il risultato è sbagliato

Consideralo un test non riuscito: confronta gli output con i record originali, migliora istruzione o mappatura e ripeti il test prima di lasciare il flusso di lavoro attivo.

## Checklist di rilascio

* [ ] Il processo manuale ha prodotto il risultato approvato.
* [ ] Input e output sono tipizzati e nominati chiaramente.
* [ ] Grafo e JSON descrivono lo stesso flusso.
* [ ] Dati, Conoscenza, file e connettori sono circoscritti al Progetto.
* [ ] Gli effetti sono limitati e testati con dati reversibili.
* [ ] Sono stati provati casi vuoti, mancanti, duplicati e di errore.
* [ ] Un'esecuzione manuale rappresentativa è riuscita.
* [ ] Trigger e fuso orario sono corretti.
* [ ] Il responsabile appartiene ancora al Progetto.
* [ ] Qualcuno revisiona gli errori e sospende i flussi di lavoro non sicuri.
