Входные данные и контракт 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 — стабильный бизнес-ID заявки, не 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
Перейти к обучению