Contratto di ingresso del workflow
Contratto di ingresso del workflow — Workflow AI n8n: dalla richiesta alla bozza verificata. Classificare senza inviare; Creare un item riproducibile; Validare prima dell'inferenza. Esercitazione pratica: Pratica: Contratto di ingresso del workflow.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Classificare senza inviare
- Creare un item riproducibile
- Validare prima dell'inferenza
Classificare senza inviare
Il workflow didattico classifica una richiesta breve come support, billing o other, la riassume e prepara una bozza per revisione umana. Non modifica CRM e non invia email. Inizia con Manual Trigger, fixture JavaScript e facoltativamente Ollama locale. Non servono chiavi a pagamento, OAuth o webhook pubblico. Definisci il confine: modello propone, codice valida la struttura, persona decide. JSON valido non dimostra classificazione corretta né autorizzazione a rispondere al cliente.
Creare un item riproducibile
In un workflow nuovo non pubblicato aggiungi Manual Trigger e poi Code chiamato Input, in modalità Run Once for All Items. Il codice restituisce un item completamente fittizio. RequestId identifica stabilmente la richiesta, non l'esecuzione. Ripetendo la prova conserva quell'ID per verificare i duplicati. Gli identificativi reali devono provenire da una fonte fidata, non essere inventati dal modello. Non usare email personali come fixture comode in una cronologia condivisa.
// Code node: Input; Run Once for All Items.
return [{ json: {
requestId: 'lab-001',
text: 'Fictional request: please explain the duplicate invoice line.',
fixtureMode: true
}}];
Validare prima dell'inferenza
Aggiungi Code InputCheck. ID assente, testo vuoto o eccessivo devono fermarsi prima della richiesta HTTP, riducendo incertezza, risorse e uso del campo sbagliato. Non usare Continue On Fail per mandare input non valido al ramo azioni. Il laboratorio gestisce un item: verifica esplicitamente l'ipotesi evitando mescolamenti con futuri batch. Restituisci soltanto i campi consentiti. Non propagare approved, recipient o command esterni come se fossero metadati fidati.
// Code node: InputCheck; Run Once for All Items.
const items = $input.all();
if (items.length !== 1) throw new Error('one_item_required');
const x = items[0].json;
if (typeof x.requestId !== 'string' || !/^lab-[0-9]{3}$/.test(x.requestId)) throw new Error('invalid_id');
if (typeof x.text !== 'string' || !x.text.trim() || x.text.length > 1000) throw new Error('invalid_text');
return [{ json: { requestId: x.requestId, text: x.text.trim(), fixtureMode: x.fixtureMode === true } }];
Esercitazione pratica
Pratica: Contratto di ingresso del workflow
Vai alla lezione