Skip to main content
Consigliamo vivamente di utilizzare Esegui script per creare le Automazioni, perché può coprire il comportamento di tutte le azioni, incluse quelle che altrimenti dovrebbero essere create manualmente. Descrivi i requisiti all’IA nella chat.Nota: se aggiungi le azioni manualmente, l’IA non sarà in grado di riconoscerle o modificarle in seguito.
L’azione Esegui script consente di scrivere JavaScript personalizzato per gestire la logica non coperta dalle azioni integrate. Puoi trasformare dati, chiamare API esterne, eseguire calcoli, implementare ramificazioni condizionali e altro ancora, il tutto in un ambiente sandbox sicuro. Gli script ricevono i dati dai passaggi precedenti tramite l’oggetto input e passano i risultati ai passaggi successivi tramite la funzione output.set().

Quando usare Esegui script anziché le azioni integrate

In generale, usa le azioni integrate quando soddisfano le tue esigenze. Usa Esegui script quando ti servono logica personalizzata, trasformazione dei dati o interazioni API complesse.

Ambiente

Come configurarlo

  1. Aggiungi un’azione Esegui script al workflow.
  2. L’editor di script si apre con un’area vuota. Scrivi qui il codice JavaScript.
  3. Lo script può leggere i dati dei passaggi precedenti usando l’oggetto input (vedi sotto).
  4. Usa output.set(key, value) per passare i risultati ai passaggi successivi.
  5. (Facoltativo) Aggiungi le dipendenze npm nel pannello di configurazione se lo script richiede librerie esterne.
  6. Fai clic su Test per eseguire lo script con dati reali provenienti dall’esecuzione più recente del trigger.
  7. Controlla l’output del test e i log della console per verificare che lo script funzioni correttamente.
  8. Salva l’azione.

Leggere i dati di input

L’oggetto input contiene i dati di tutti i passaggi precedenti del workflow. Ogni passaggio è identificato dal proprio ID azione.

Struttura dell’input

Ottenere i dati del trigger (Campi del Record)

Ottenere i dati da un passaggio Ottieni Record

Ottenere i dati dagli output di altre azioni

Durante i test, usa console.log(JSON.stringify(input, null, 2)) per vedere la struttura esatta dei dati di input. È il modo più rapido per capire cosa è disponibile.

Scrivere l’output

Usa output.set(key, value) per rendere disponibili i dati ai passaggi successivi. Puoi impostare più chiavi.
Ogni chiave impostata diventa una variabile distinta a cui i passaggi successivi possono fare riferimento tramite il selettore di variabili +. Ad esempio, se chiami output.set("status", "success"), il passaggio successivo può fare riferimento a status nell’output di questo script.

Debug con console.log

Durante lo sviluppo, usa console.log() per esaminare i dati e tenere traccia del flusso di esecuzione. L’output dei log viene visualizzato nel pannello di test quando fai clic su Test.
I log della console sono visibili soltanto durante i test e non compaiono nella cronologia delle esecuzioni di produzione. Usali liberamente mentre crei lo script.

Gestione dei pacchetti npm

Puoi utilizzare pacchetti npm negli script. Dichiara le dipendenze nel pannello di configurazione:
Quindi usali nello script tramite require():
Quando possibile, preferisci le funzionalità JavaScript integrate ai pacchetti npm. JavaScript moderno include molte utilità, come Array.map(), Array.filter(), Object.entries(), template literal e destrutturazione. Aggiungi pacchetti npm soltanto quando offrono un vantaggio significativo.

Variabili integrate

Sicurezza: ambito di AUTOMATION_TOKEN

AUTOMATION_TOKEN viene generato automaticamente per ogni esecuzione dell’Automazione. Ha le stesse autorizzazioni dell’autore dell’Automazione e il suo ambito è limitato all’esecuzione corrente. Punti chiave:
  • Può accedere a qualsiasi Tabella a cui ha accesso l’autore dell’Automazione.
  • È valido soltanto per la durata dell’esecuzione dello script (timeout di 60 secondi).
  • Non esporre questo token a sistemi esterni: è destinato a chiamare l’API di Teable dall’interno dello script.

Chiamare l’API di Teable

Chiamare l’IA da uno script

POST /api/automation/runtime/ai invia un prompt al modello IA della Base. La Base deriva dal contesto dell’Automazione, quindi non è necessario alcun ID Base. Il corpo accetta prompt e, facoltativamente, attachments, modelKey, temperature e outputType; la risposta è { "message": ... }. Gli allegati sono elementi { url, mimetype, name }, fino a 10 per chiamata, ciascuno di dimensioni inferiori a 20 MB e con un timeout di download di 30 secondi; sono supportati immagini, PDF e documenti Office. Il modello di chat predefinito potrebbe non leggere immagini e allegati simili, quindi specifica modelKey quando invii file. Ogni chiamata consuma Crediti.

Gestione degli errori

Racchiudi sempre le operazioni rischiose in blocchi try/catch, in modo che il workflow possa gestire correttamente gli errori:
Senza la gestione degli errori, una richiesta fetch non riuscita o un formato di dati imprevisto interromperà lo script e i passaggi successivi non riceveranno alcun output.

Esempio completo: elaborare e instradare i ticket di assistenza

Suggerimenti

  • Inizia da console.log. Quando crei un nuovo script, registra innanzitutto l’intero oggetto input per comprenderne la struttura.
  • Mantieni gli script mirati. Svolgi bene una singola attività anziché concentrare più attività in un unico script. Se necessario, concatena più azioni Esegui script.
  • Tieni presente il timeout di 60 secondi. Le operazioni lunghe (elaborazione di grandi quantità di dati, molte chiamate API sequenziali) possono raggiungere il timeout. Suddividi le attività grandi in blocchi più piccoli.
  • Esegui i test con dati reali. Il pannello di test usa i dati effettivi dell’esecuzione più recente del trigger, offrendo risultati realistici.
  • Gestisci i dati mancanti. Usa valori predefiniti (operatore ||) per i Campi che potrebbero essere vuoti o non definiti.

Contenuti correlati

  • Genera con l’IA — per attività IA basate su prompt che non richiedono codice personalizzato
  • Richiesta HTTP — per semplici chiamate API che non richiedono scripting
Ultima modifica il 4 settembre 2026