Вхідні дані й контракт workflow
Вхідні дані й контракт workflow — AI-workflow у n8n: від заявки до перевіреної чернетки. Класифікуємо, не надсилаємо; Створіть відтворюваний item; Валідатор до inference. Практичне завдання: Практика: Вхідні дані й контракт workflow.
Демо-версія. Матеріали проходять редакторську перевірку.
Що розглянемо
- Класифікуємо, не надсилаємо
- Створіть відтворюваний item
- Валідатор до inference
Класифікуємо, не надсилаємо
Навчальний workflow класифікує коротку заявку як support, billing або other, стисло підсумовує її та створює чернетку для людини. Він не змінює CRM і не надсилає листів. Спочатку використаємо Manual Trigger, JavaScript fixtures та локальну Ollama за потреби. Платні provider keys, OAuth і публічний webhook не потрібні. Запишіть межу: модель пропонує категорію, код перевіряє структуру, людина вирішує подальшу дію. Навіть правильний JSON не доводить, що заявка справді стосується рахунку або що можна відповідати клієнту.
Створіть відтворюваний item
У новому непублікованому workflow додайте Manual Trigger, потім Code із назвою Input і режимом Run Once for All Items. Код нижче повертає один item; усе в ньому вигадане для навчання. RequestId є стабільним бізнес-ідентифікатором заявки, а не execution ID. Повторний тест тієї самої заявки повинен зберігати requestId, щоб перевіряти дублікати. Для реального потоку ID має надходити з довіреного джерела; модель не вигадує його. Не використовуйте особисті листи як зручні тестові дані в загальній execution history.
// Code node: Input; Run Once for All Items.
return [{ json: {
requestId: 'lab-001',
text: 'Fictional request: please explain the duplicate invoice line.',
fixtureMode: true
}}];
Валідатор до inference
Додайте Code InputCheck. Відсутній ID, порожній текст чи надто довга заявка повинні зупинятися до HTTP-запиту. Це зменшує невизначеність, витрати ресурсів і ризик обробки не того поля. Не використовуйте Continue On Fail для пропуску невірного вводу до action branch. У лабораторії один item: перевіряйте це явно, щоб пізніше випадковий batch не став сумішшю заявок. Output зберігає лише дозволені поля. Поля approved, recipient або command із зовнішнього вводу не переносяться до наступних вузлів.
// 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 } }];
Практичне завдання
Практика: Вхідні дані й контракт workflow
Перейти до навчання