# Crea un workflow

> Dichiara gli input, collega i passaggi e scegli le identità usate dal workflow.

## Prima di iniziare

Devi essere owner o editor della dashboard. Collega gli [strumenti e le credenziali dell’account](/it/docs/tools/credentials) necessari al processo. Consulta le [regole per l’esecuzione senza supervisione](/it/docs/workflows/guardrails).

## Crea la pipeline

1. Apri **Workflow** e scegli **Nuovo workflow**.
2. Inserisci nome e descrizione.
3. Aggiungi il primo passaggio con il controllo più sul canvas.
4. Scegli **Aggiungi input** per ogni valore necessario al processo.
5. Imposta etichetta, tipo, descrizione e **Obbligatorio**, poi scegli **Salva input**.
6. Configura ogni passaggio, poi scegli **Salva passaggio**.
7. Seleziona **Variabile** per inserire input o risultati precedenti nei campi dei passaggi.
8. Scegli **Salva** per memorizzare input e pipeline.

I tipi di input sono **Testo breve**, **Testo lungo**, **Numero** e **Sì-no**. La chiave in **Avanzate** resta fissa dopo la creazione. Se rimuovi un input, aggiorna i passaggi che lo usano prima di salvare. Gli input sono disponibili in ogni passaggio e ricevono i valori a ogni esecuzione. Scegli un input per vedere da dove ogni trigger prende il suo valore e quali passaggi lo usano.

Scegli il passaggio in base al lavoro da svolgere:

| Passaggio | Configurazione |
| --- | --- |
| **Tool** | Strumento collegato, argomenti e connessione dell’account o profilo credenziali; senza AI. Include Workspace, Esecutore di codice e Generazione immagini. |
| **Prompt** | Istruzione e campi di output con nome e tipo per risultati strutturati. |
| **Agente** | Specialista, compito e briefing; usa le proprie istruzioni, strumenti e accessi ai file, più la cartella di questo workflow. |
| **Condizione** | Regole sui valori precedenti, combinate con AND/OR; senza AI. |
| Funzione di un’app | Un passaggio Strumento che chiama una funzione pubblicata; i passaggi successivi possono usarne l’output. |

## Aggiungi rami o ripeti un passaggio

1. Aggiungi una **Condizione** dove il processo deve scegliere un ramo.
2. Configura le regole e scegli **Salva passaggio**.
3. Aggiungi le azioni corrispondenti al ramo vero e quelle alternative al ramo falso.

Una condizione termina la propria lista; viene eseguito solo il ramo scelto, poi l’esecuzione si conclude. Inserisci le azioni comuni in entrambi i rami. Aggiungendo una condizione, i passaggi successivi passano al ramo vero. Le condizioni possono annidarsi fino a otto livelli.

Una condizione sceglie un ramo. Un passaggio ripetuto elabora ogni elemento di una lista precedente, entro il limite impostato.

1. Apri un passaggio Strumento, Prompt o Agente da ripetere.
2. Imposta **Ripeti per ciascuno** su una singola variabile che contiene una lista.
3. Imposta **Elementi max** su un valore da 1 a 20.
4. Usa le variabili dell’elemento corrente e del suo indice negli argomenti del passaggio.
5. Scegli **Salva passaggio**, poi **Salva**.

Gli elementi di letture e prompt procedono in parallelo; quelli di scritture e agenti in sequenza. Per impostazione predefinita, gli errori dei singoli elementi vengono raccolti senza fermare gli altri.

> **Attenzione** — Una lista oltre il limite fa fallire l’esecuzione, senza troncarla. Ogni elemento ripetuto di un agente costa un’esecuzione completa dell’agente.

## Imposta variabili e identità

1. Scegli la connessione dell’account o il profilo credenziali di ogni passaggio Strumento.
2. Inserisci i valori temporali attraverso **Variabile**.
3. Usa **Cartella del workflow** per file duraturi e **File temporanei (questa esecuzione)** per quelli intermedi.
4. Risolvi gli avvisi del workflow salvato prima di attivare i trigger.

I passaggi Strumento non usano mai connessioni personali dei membri. Passaggi diversi possono usare identità diverse; quelli MCP usano le credenziali dell’account memorizzate sul server. I valori temporali sono fissati all’avvio, nel fuso del trigger o nel tuo per esecuzioni manuali. Gli output dei rami non eseguiti possono essere vuoti. Per il JSON stampato dal codice, usa sotto-campi come `stdout.ids`.

Per nuovi passaggi che scrivono file, seleziona lo strumento Workspace chiamato Create, write, update, copy, move or delete a Workspace file. I passaggi workspaceWriteFile esistenti continuano a funzionare. Controlla i percorsi restituiti: creare o copiare su un nome occupato aggiunge un suffisso. Aggiorna i file esistenti quando le esecuzioni successive devono riusarli.

## Usa le funzioni delle app in sicurezza

1. Seleziona una funzione pubblicata in un passaggio Strumento.
2. Fai salvare il workflow da un editor che gestisce le app quando usa una nuova app per la prima volta.
3. Verifica argomenti e output successivi dopo una modifica alla funzione, poi salva di nuovo.

Il salvataggio concede accesso a tutte le funzioni pubblicate delle app usate, anche con ruoli propri. Rimuovere l’ultimo passaggio di un’app revoca l’accesso al salvataggio. La duplicazione copia l’accesso alle app solo se puoi gestirle. Le chiamate avviate da un partner richiedono che il suo accesso resti attivo.

Modifiche a input, output, rischio o versione della funzione bloccano il passaggio finché non salvi di nuovo. Una pubblicazione in corso o fallita blocca le chiamate; **Da ripubblicare** richiede di ripubblicare l’app. Se il risultato di una scrittura è incerto, controlla l’app prima di riprovare.

## Parti da una descrizione

1. Descrivi il processo all’Assistente della dashboard.
2. Rivedi la proposta del programma completo, inclusi i rami, in un’unica approvazione.
3. Approva separatamente le credenziali necessarie.
4. Rivedi attivazione e test reali nelle rispettive approvazioni.

I trigger automatici restano assenti durante configurazione o verifica. Una copia conserva passaggi, input, credenziali e preset; non include trigger, cronologia o file della cartella originale.

## Correlati

- [Esegui, pianifica e attiva](/it/docs/workflows/triggers)
- [Percorsi del Workspace](/it/docs/workspace/paths)
- [Accesso alle app](/it/docs/apps/access)