Workflows

Flussi di lavoro

Concatenate gli strumenti dei vostri prodotti Etrebil e i vostri servizi esterni: un attivatore, passaggi disegnati, script puri, ogni esecuzione seguita passo dopo passo.

In preparazione Crea un account

Workflows concatena passaggi tra i prodotti Etrebil e servizi esterni. Un workflow parte da un attivatore, a mano, su un evento di un prodotto, a un'ora fissa o tramite una chiamata webhook, poi esegue i suoi passaggi in ordine: strumento di un prodotto Etrebil tramite il suo punto di accesso MCP, chiamata HTTP, script, variabili, condizione a due rami, attesa fino a 30 giorni, arresto in errore. L'editor disegna il diagramma e scrive la stessa definizione JSON della scheda JSON. I dati passano da un passaggio all'altro tramite modelli, una semplice ricerca nelle variabili, mai codice valutato.

Il motore è durevole: ogni esecuzione conserva la versione con cui è partita, scrive la sua posizione dopo ogni passaggio e riprende dopo un riavvio o una lunga attesa. I guasti passeggeri vengono ripetuti con un ritardo crescente, e ogni passaggio eseguito si rilegge con input, output e durata. Non ci sono cicli: un'esecuzione termina sempre, e una catena di chiamate tra prodotti smette di riavviare workflow a partire dal terzo anello.

Una connessione a un prodotto usa un token di agente creato sul portale Etrebil: il prodotto applica i diritti della persona che l'ha creato, Workflows non aggira nulla. I segreti sono cifrati e non si rileggono mai, e ogni chiamata passa da una protezione di rete: https, host autorizzati, nessun indirizzo interno. Gli script sono funzioni pure, senza rete né disco, limitate in durata e memoria, ed eseguite fuori dal server in produzione.

Workflows esiste solo sul web e non è ancora in linea. Solo pochi prodotti emettono già eventi (Field Service, Planning, Manufacturing e il modulo Marketing di CRM), e l'editor grafico non è ancora stato provato in un browser.

Workflows è in preparazione. Entrerà nel catalogo dell'abbonamento Etrebil alla sua uscita.

Tutte le funzionalità di Workflows

64 funzionalità in 10 ambiti

Workflows ed editor grafico

Descrive un workflow come una sequenza ordinata di passaggi, con rami se e altrimenti, salvata in JSON e versionata a ogni modifica della definizione.
Disegna il diagramma dall'alto in basso: l'attivatore in cima, i passaggi collegati, i due rami di una condizione affiancati, il modulo del passaggio scelto a destra.
Inserisce un passaggio con un « + » tra due schede; sposta in alto o in basso, duplica o elimina il passaggio scelto con dei pulsanti.
Verifica la definizione in continuo ed elenca i punti da correggere citando il passaggio; un campo sconosciuto è un errore, non un passaggio ignorato.
Scheda JSON: la stessa definizione in testo, modificabile, per rileggere, copiare o incollare un workflow intero.
Mostra, nel pannello del passaggio, i dati disponibili in quel punto; si inseriscono in un campo con un modello tra doppie parentesi graffe, una semplice ricerca nelle variabili, mai codice valutato.
Crea un workflow vuoto e inattivo; si attiva solo se la sua definizione è valida e le connessioni che cita esistono.
Ogni esecuzione conserva la versione con cui è partita: modificare un workflow non tocca quelle in corso.
Registro di ogni workflow: creazione, modifiche con il numero di versione, attivazione, disattivazione, indirizzo del webhook rinnovato, con il loro autore.

Sette tipi di passaggio

Strumento di un prodotto: chiama uno strumento MCP di un altro prodotto Etrebil tramite la sua connessione, con argomenti in JSON.
Chiamata HTTP: GET, POST, PUT, PATCH o DELETE verso un servizio esterno, con percorso, parametri, corpo e intestazioni; il segreto della connessione viene aggiunto da solo.
Script: JavaScript che riceve un input JSON e restituisce un output JSON, senza rete né disco, al massimo un secondo; ciò che scrive con console.log riempie il registro del passaggio.
Definire variabili a partire dai dati dei passaggi precedenti.
Condizione: due rami, allora e altrimenti, secondo un confronto (uguale, diverso, maggiore, minore, almeno, al massimo) o secondo che un dato contenga un testo, esista, sia vuoto o no.
Attendere da 1 minuto a 30 giorni: l'esecuzione viene messa da parte e riprende da sola, anche dopo un riavvio del server.
Fermarsi in errore, con un messaggio che può riprendere i dati dell'esecuzione.
Per ogni passaggio strumento, HTTP o script: la variabile che conserva il risultato, fermarsi o continuare in caso di errore, e da 1 a 5 tentativi.
Un workflow conta al massimo 60 passaggi, e le sue condizioni si annidano su 4 livelli al massimo.

Attivatori

A mano, dall'elenco o dalla pagina del workflow, con un input JSON facoltativo; anche un workflow inattivo si avvia a mano.
Evento di un prodotto Etrebil: l'applicazione emittente e un nome esatto, o un prefisso che termina con un asterisco; i dati dell'evento arrivano nel workflow.
Riceve gli eventi firmati da ogni prodotto (HMAC-SHA256), verificati in una finestra di 5 minuti; un evento ricevuto due volte avvia una sola esecuzione.
Pianificato: ogni N minuti, da 5 a 10.080, o ogni giorno a un'ora UTC; una sola istanza del server fa scattare la scadenza, e una scadenza mancata non viene recuperata.
Webhook: un indirizzo segreto mostrato una sola volta, conservato solo come impronta, rinnovabile; l'intestazione Idempotency-Key evita un doppio avvio.
Interrompe i cicli tra prodotti: un evento nato da una catena di tre chiamate o più viene registrato ma non avvia più nulla.

Connessioni a prodotti e servizi

Prodotto Etrebil: il punto di accesso MCP del prodotto e un token di agente creato sul portale Etrebil; il prodotto applica i diritti della persona che ha creato il token, Workflows non aggira nulla.
Servizio HTTP: un indirizzo di base, gli host autorizzati, l'intestazione e il prefisso del segreto.
Cifra i segreti con una chiave conservata fuori dal database; un segreto non si rilegge mai, né a schermo, né tramite uno strumento MCP, né nel registro dei passaggi.
Pulsante Testa: elenca gli strumenti del prodotto, oppure invia un GET al servizio e ne restituisce lo stato.
Protezione di rete a ogni chiamata: https sulla porta 443, host elencati, nessun indirizzo privato o interno, ogni indirizzo controllato al momento della connessione, nessun reindirizzamento seguito.
Limita ogni risposta a 1 MB e ogni chiamata a 15 secondi, 30 per uno strumento.
Rifiuta di rinominare o eliminare una connessione che un workflow cita ancora.

Esecuzioni e consumi

Elenco delle esecuzioni filtrabile per stato: in attesa, in corso, riuscita, in errore, annullata.
Pagina di un'esecuzione: il diagramma della versione avviata, ogni scheda segnata con il suo risultato, poi ogni passaggio eseguito con input, output, durata e numero di tentativo.
Si aggiorna da sola finché l'esecuzione è in corso o in attesa.
Ripete i guasti passeggeri (rete, errori 5xx, 429) dopo 5 s, 20 s, 1 min, 3 min e poi 10 min; gli altri errori fermano l'esecuzione, o vengono conservati in una variabile se il passaggio lo chiede.
Annulla un'esecuzione in attesa o in corso; rilancia un'esecuzione terminata con la stessa definizione e lo stesso input.
Riprende un'esecuzione dove si era fermata se l'istanza del server che la eseguiva si arresta; due istanze non eseguono mai la stessa esecuzione contemporaneamente.
Conta per mese le esecuzioni, i passaggi eseguiti, le chiamate agli strumenti, le chiamate HTTP, il tempo di script e gli avvii rifiutati.
Quota mensile di esecuzioni, 10.000 per impostazione predefinita, 0 per nessun limite; oltre, gli avvii vengono rifiutati fino al mese successivo.
Conserva le esecuzioni terminate per 30 giorni per impostazione predefinita, regolabili da 1 a 365, poi le cancella con il loro registro dei passaggi.

Ruoli e accesso

Accesso unico con il vostro account Etrebil; ogni organizzazione vede solo i propri dati.
Membro: vede i workflow, ne avvia uno a mano e vede solo le proprie esecuzioni.
Autore: scrive, modifica e attiva i workflow, vede tutte le esecuzioni, le annulla e le rilancia.
Amministratore: connessioni e segreti, limiti, ruoli, ed eliminazione di un workflow con la sua cronologia.
I membri dell'organizzazione Etrebil compaiono alla loro prima visita; i suoi proprietari e amministratori sono amministratori di diritto; un amministratore sospende o ripristina un collaboratore, e ne resta sempre uno attivo.
Senza licenza, sola consultazione; i diritti sono verificati dal server, non solo nascosti a schermo.

Agenti IA tramite MCP

Punto di accesso MCP con un token di agente Etrebil: elencare i workflow, leggere un workflow e la sua definizione, elencare e leggere le esecuzioni, leggere i consumi del mese.
Avviare un workflow e annullare un'esecuzione sono strumenti di scrittura, riservati ai token in lettura e scrittura.
L'agente vede ciò che vede la persona del token; le connessioni e i loro segreti non sono esposti.

Tutorial

Creare un workflow: nome, creazione, primo passaggio, diagramma, salvataggio.
Collegare un altro prodotto: una connessione con un token di agente, poi il pulsante Testa.

Sui vostri dispositivi

Web: l'applicazione completa, con accesso unico, licenza e dati sul server.
Le esecuzioni girano sul server, anche a browser chiuso.
Per il momento nessuna applicazione desktop né applicazione Android.

Da sapere

Nessun ciclo, nessun « per ciascuno » né unione di rami: un elenco si tratta con uno script o con uno strumento che accetta lotti.
Una scrittura presso un altro prodotto la cui risposta tarda può essere rifatta da un nuovo tentativo: per una scrittura che non va ripetuta, impostate il passaggio su un solo tentativo.
In produzione, gli script girano in un esecutore separato, senza rete; senza questo esecutore, i passaggi script falliscono.
Solo pochi prodotti emettono già eventi: Field Service, Planning, Manufacturing e il modulo Marketing di CRM. Gli altri non attivano workflow; quelli che pubblicano strumenti MCP si pilotano comunque con un passaggio strumento.
Ogni prodotto da pilotare richiede un token di agente in lettura e scrittura, creato sul portale Etrebil, poi una connessione: un passaggio manuale per prodotto.
In un passaggio strumento, il nome dello strumento si digita a mano; il pulsante Testa della pagina Connessioni ne fornisce l'elenco.
Un workflow modello per DataVirt, rileggere e poi spingere uno staging con salvaguardie, è scritto ma non ancora proposto a schermo.
La chiave di cifratura dei segreti va salvata a parte: perderla obbliga a reinserire i segreti, e non si può ancora cambiare.
Nessuna esportazione né importazione dell'organizzazione: una definizione si copia dalla scheda JSON.
L'editor non è ancora stato provato in un browser, né il servizio distribuito; i token di agente reali e il carico non sono stati messi alla prova.