Platform Overview

4-слойная архитектура clowbot

За 30 секунд

clowbot — DB-centered agent platform для Telegram.

PostgreSQL — единственный центр истины. Вся политика, процессы, агенты, workflow-ы хранятся в БД.

Python/FastAPI — тонкий мост между Telegram и БД. Не держит бизнес-логику.

n8n — плоскость исполнения. Workflow-ы читают и пишут в БД через internal API.

Agents — DB-сущности, не Python классы. Конфигурируются через agent_profile + agent_methods.

4-слойная архитектура

LAYER 4

AGENTS

Интеллектуальная обработка. Агенты выбираются через DB-политику, получают инструменты через allowed_tools.

Таблицы
agent_profile
Методы
agent_methods
Делегирование
agent_sub_agents
Выбор
agent_selection_policy
9 профилей25 методов13 sub-agent связей
LAYER 3

n8n PLANE

Плоскость исполнения. Workflow-ы оркестрируют multi-step процессы, вызывают LLM, возвращают результаты в БД.

Workflows
7 активных
Слоты
5 max
Registry
workflow_registry
Sync
n8n_sync_workflows.sh
web_searchcontent_factoryreminderstravel_research
LAYER 2

PYTHON BRIDGE

Тонкий мост. Routing, auth, queue, provider clients, message split. НЕ держит бизнес-логику.

API роутеры
14
Handlers
33 файла
Services
21 модуль
Metrics
Prometheus
FastAPIAsyncPGTelegram PollingQueue/Backpressure
LAYER 1

POSTGRESQL

Центр истины. Вся политика, процессы, агенты, workflow-ы, аудит хранятся здесь.

Таблицы
67
Миграции
400+
Views
66
Схемы
clowbot, mart
users, chats, messagesprocesses, process_runsruntime_policypgvector для RAG

5 принципов архитектуры

1

Single Source of Truth

PostgreSQL — единственный источник истины. Никакого состояния в коде.

2

Thin Bridge

Python не держит бизнес-логику. Только routing, auth, queue, providers.

3

Execution Plane

n8n не источник истины. Он читает и пишет в БД через internal API.

4

Agent-as-Data

Агенты — DB entities, не Python классы. Конфигурируются через SQL.

5

Policy-Driven

Поведение управляется политиками в runtime_policy, не хардкодом.

Поток данных

User Message → Telegram API → Python Bridge → DB Lookup
     │
     ├──→ Agent Selection (agent_selection_policy)
     │
     ├──→ Process Run (process_runs)
     │         │
     │         ├──→ Steps (process_run_steps)
     │         ├──→ n8n Workflow
     │         └──→ LLM Call (llm_calls)
     │
     └──→ Response Assembly → Telegram API → User
Database SchemaPython BridgeAgent Platform