Wiki/Workflows

Workflows — Обзор системы

Workflows (рабочие процессы) — это визуальные автоматизации в n8n, которые выполняют реальные задачи. PostgreSQL хранит контракты, n8n исполняет логику.

Архитектура

📨
Пользователь
Telegram / API
↓

Python Bridge

🤖
FastAPI
🤖
Queue
🤖
Auth/RBAC
1. Найти process по code
2. Получить n8n_webhook_path из БД
3. Отправить payload на webhook
↓

n8n Workflow

Webhook
Trigger
→
Code
Node
→
LLM
Node
→
Response
Node
• Визуальный редактор
• 400+ интеграций
• Реальная работа
↓

PostgreSQL

clowbot.processes
• code (ключ процесса)
• n8n_workflow_id
• n8n_webhook_path
• input_schema / output_schema
clowbot.process_runs
• id, process_id
• status
• result_json
• error_details
clowbot.workflow_source
• repo_url (GitHub)
• trust_level
• last_synced_at
clowbot.workflow_document
• name, description
• raw_json (шаблон)
• node_types, trigger_type

PostgreSQL

Единый центр истины. Хранит контракты процессов, реестр workflow-шаблонов, историю запусков.

Python Bridge

Тонкий мост. Находит процесс в БД, отправляет запрос на webhook n8n, возвращает результат.

n8n

Плоскость исполнения. Визуально создаёт автоматизации, выполняет шаги, интегрируется с сервисами.

Жизненный цикл workflow

1. Создание

  • • Создать визуально в n8n
  • • Сохранить JSON в n8n/workflows/
  • • Зарегистрировать в workflow_document
  • • Привязать к process через n8n_workflow_id

2. Активация

  • • Проверить slot availability (max 5 active)
  • • Импортировать через n8n_sync_workflows.sh
  • • Активировать webhook
  • • Обновить active_workflow_slots.txt

3. Исполнение

  • • User trigger → Python Bridge
  • • Bridge находит webhook_path в БД
  • • POST payload на n8n webhook
  • • n8n выполняет workflow → возвращает результат

4. Мониторинг

  • • process_runs — история запусков
  • • process_run_steps — шаги
  • • llm_calls — LLM вызовы
  • • n8n UI — визуальный debug

Slot Policy (5 активных)

⚠️ Ограничение: 5 активных workflows

n8n community edition ограничен 5 активными workflows. Это критическое ограничение.

Текущие активные:
  • • web_search
  • • reminder_trigger
  • • group_summary
Правила:
  • • НЕ активировать все импортированные
  • • Использовать active_workflow_slots.txt
  • • Deactivate перед activate

Связанные страницы

Slot Policy
5 активных workflows
Sync
Синхронизация
Processes
Обзор процессов

Навыки для понимания

n8nWebhooksWorkflow patternsSlot managementDB integration