Версии и публикация
Черновики, неизменяемые версии, публикации, slug, отключение, дублирование и удаление решений — и что видят ваши API-клиенты на каждом шаге.
У каждого решения есть редактируемый черновик и история неизменяемых версий. API всегда выполняет активную версию; черновик попадает в продакшен, только когда вы его публикуете.
Устройство решения
| Свойство | Правила |
|---|---|
| Название | От 1 до 80 символов. |
| Slug | Эндпоинт: POST /v1/decisions/{slug}. Строчные буквы, цифры и одиночные дефисы, до 64 символов. Уникален в рабочем пространстве. |
| Описание | Необязательно, до 500 символов. |
| Черновик | Схема, которую вы редактируете. |
| Версии | Неизменяемые снимки, создаваемые каждой публикацией: v1, v2, … |
| Статус | Draft, Live или Disabled. |
Жизненный цикл
Draft ──deploy──▶ Live (v1) ──deploy──▶ Live (v2) ──deploy──▶ …
│ ▲
disable│ │enable
▼ │
Disabled| Статус | Что возвращает POST /v1/decisions/{slug} |
|---|---|
| Черновик — ни разу не опубликован | 409 DECISION_NOT_DEPLOYED |
| В работе | 200 с ответом активной версии; version указывает, какой именно |
| Отключено | 409 DECISION_DISABLED |
| Удалено (или неизвестный slug) | 404 DECISION_NOT_FOUND |
Черновики и автосохранение
Редактор и визуальный конструктор редактируют один и тот же черновик. Изменения сохраняются автоматически примерно через 1,5 секунды после последней правки — только если черновик корректен; иначе панель сохранения перечисляет проблемы со ссылкой К ошибке.
Если коллега (или другая вкладка) сохранил решение после того, как вы его открыли, ваше сохранение отклоняется, а не перезаписывает чужое: панель сохранения показывает Кто-то другой сохранил это решение и предлагает Загрузить текущую версию.
Сохранение черновика никогда не меняет продакшен.
Публикация
Опубликовать (на вкладке Публикация решения) делает снимок текущего черновика как версию n + 1 и делает её активной немедленно — работающие клиенты переключаются на неё при следующем вызове. Несохранённые правки сначала сохраняются; черновик с проблемами схемы опубликовать нельзя.
- Версии неизменяемы: их нельзя редактировать или удалять.
- Поле
versionв ответе и каждое выполнение фиксируют версию, которая ответила. - История версий перечисляет все версии (В работе или В архиве) с их полной схемой.
- Версия продолжает работать так, как была опубликована. Когда Dcision ужесточает правило валидации — v0.3 проверяет значения правил на соответствие вариантам, уровням и диапазонам, с которыми они сравниваются, — новое правило применяется при следующем сохранении или публикации черновика, но никогда к работающей версии.
- Для публикации, как и для любого изменения решения, нужна роль «Участник» или выше — см. Команда, роли и аккаунт.
Откат
Отката в один клик пока нет. Чтобы вернуться к прежнему поведению, откройте схему версии в Истории версий, приведите черновик к ней и опубликуйте — это создаст новый номер версии со старой логикой.
Slug
- Когда вы создаёте решение, slug генерируется из его названия: диакритика удаляется, буквы становятся строчными, всё остальное превращается в дефисы — "Lead Qualification!" становится
lead-qualification. Если slug занят, добавляется суффикс:lead-qualification-2. - Slug можно менять до первой публикации. После этого он заблокирован: клиенты его вызывают, и переименование их сломало бы (
409 CONFLICT— "The slug can't change after the first deploy."). - Slug уникален в пределах рабочего пространства. В двух рабочих пространствах может быть решение
lead-qualification: API-ключ определяет, какое рабочее пространство — а значит, и какое решение — выполняется.
Отключение и включение
Отключить endpoint останавливает работающее решение, ничего не теряя: вызовы получают 409 DECISION_DISABLED, пока вы не нажмёте Включить endpoint, который снова обслуживает ту же активную версию. Включить можно только решение, которое уже публиковалось.
Дублирование
Дублировать копирует черновик (не версии) в новое решение с названием "name (copy)", со своим slug и без версий. Оно учитывается в лимите решений вашего тарифа.
Удаление
Удалить удаляет решение вместе с его версиями и историей выполнений. Вызовы его slug сразу завершаются ошибкой 404 DECISION_NOT_FOUND, а slug освобождается для нового решения. Это нельзя отменить.
Лимиты тарифа
Количество решений в рабочем пространстве зависит от тарифа — 2 на Genesis, 10 на Developer, без ограничений на Growth и Enterprise. Создание или дублирование сверх лимита завершается ошибкой 402 PLAN_LIMIT_REACHED; удалите решение или повысьте тариф. Отключённые решения и черновики тоже учитываются.
Уверенность и вероятности
Что означает уверенность для каждого типа вопроса на единой шкале 0–1, как она влияет на minConfidence, взвешенные уровни, полные распределения вероятностей и почти ничьи.
Настройки решения
engine, storeInput, storeOutput, timeoutMs, fallbackAction, onEngineError и shadow — что делает каждая настройка выполнения решения, её значение по умолчанию и лимиты, — а также настройки рабочего пространства.