Основные понятия¶
Процесс (Process Definition)¶
Процесс — это направленный граф из узлов и рёбер. Описывает логику: что происходит, в каком порядке, при каких условиях.
Процесс проходит три статуса:
- Черновик (Draft) — редактируемый, можно менять узлы и связи
- Опубликован (Published) — активный, обрабатывает входящие запросы, нельзя редактировать
- Архив (Archived) — деактивирован, новые запуски невозможны
Чтобы изменить опубликованный процесс — создайте новую версию (кнопка «Новая версия»). Она появится как черновик.
Экземпляр процесса (Process Instance)¶
Каждый запуск процесса создаёт экземпляр. Если 100 клиентов написали боту — создаётся 100 экземпляров одного процесса. Каждый экземпляр хранит свои данные (переменные) и проходит свой путь по графу.
Узлы (Nodes)¶
Узел — элемент процесса, выполняющий конкретное действие:
| Узел | Что делает |
|---|---|
| Start Event | Точка входа: API, Webhook, Telegram, WhatsApp, таймер |
| End Event | Завершает процесс, определяет какие данные вернуть |
| AI Task | Одноразовый вызов LLM: классификация, генерация, извлечение данных |
| AI Chat | Многоходовый диалог с клиентом через AI с базой знаний |
| User Task | Задача для оператора: форма, решение, ручная проверка |
| Service Task | HTTP-вызов внешнего API или ответ клиенту в мессенджер |
| Exclusive Gateway | Ветвление: токен идёт в одну ветку по условию |
| Parallel Gateway | Параллельное выполнение: все ветки одновременно |
| Timer Event | Пауза / задержка |
Рёбра (Edges)¶
Рёбра соединяют узлы и определяют порядок выполнения. На рёбрах после Exclusive Gateway задаются условия: какое поле проверять, какой оператор, какое значение.
Переменные (Variables)¶
Данные, которые накапливаются по мере выполнения процесса. Каждый узел может добавлять новые переменные:
- Start Event →
message_text,external_username(от мессенджера) или пользовательские поля (от API) - AI Task →
category,urgency(что вернул LLM) - Service Task →
status_code,success, пользовательские поля из JSON-ответа - User Task → поля заполненной формы
Следующие узлы видят все переменные предшественников. Это называется data flow.
Организация (Tenant)¶
Ваше изолированное рабочее пространство в Schemix. Процессы, пользователи, данные одной организации не видны другой. У каждой организации — свои каналы, AI-провайдеры, базы знаний и тариф.
Название организации можно изменить в разделе Администрирование → Организация (иконка карандаша рядом с названием).
Тариф¶
Тариф определяет лимиты организации:
- количество опубликованных процессов
- количество пользователей
- количество каналов связи
- количество баз знаний
- объём хранилища для документов
Текущий тариф и использование видны в разделе Администрирование → Организация. Сменить тариф можно через администратора Schemix или промокод партнёра.
Партнёр¶
Партнёр Schemix — агент, который привлекает клиентов и получает процент с их оплат (revenue share). Партнёры выдают клиентам промокоды:
- REFR-код — дисконт или расширенный пробный период для новой организации
- PINV-код — приглашение для регистрации как партнёр (выдаётся администратором Schemix)
Подробнее — в разделе Партнёрская программа.
Токен¶
Внутренний механизм движка. Токен «бежит» по графу процесса от Start к End, активируя узлы по пути. На Gateway токен выбирает направление. На Parallel Gateway — разделяется на несколько.
Пользователю не нужно думать о токенах — это внутренняя механика. Но полезно знать: если процесс «завис» — скорее всего токен ждёт на User Task или AI Chat.