Безкоштовний урок

Вхідні дані й контракт 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

Перейти до навчання

Програма курсу

  1. Вхідні дані й контракт workflow
  2. Локальний HTTP-виклик і structured output
  3. Валідатор між AI й дією
  4. Людське рішення перед записом
  5. Повтори й idempotency
  6. Saved runs і фінальна матриця