Обзор паттернов
Четыре архитектурных паттерна TypeSafe — спекулятивный fan-out, маршрутизация с порогом уверенности, композитная оценка и маршрутизация по намерению — и как каждый соотносится с функциями и шаблонами Dcision.
Jev быстро отвечает на небольшие буквальные вопросы. Хорошие системы составляются из многих таких вопросов. TypeSafe описывает четыре архитектурных паттерна, позволяющих делать это хорошо, и Dcision превращает каждый из них в полноценные возможности схемы решения — с шаблоном, который реализует паттерн от начала до конца.
| Паттерн | Что делает | Преимущества | В Dcision | Шаблон |
|---|---|---|---|---|
| Спекулятивный fan-out | Задаёт за один вызов все вопросы, которые могут понадобиться процессу, и даёт правилам решить, какие ответы важны. | Стоимость, скорость | Все вопросы в одном решении; условия and ограничивают спекулятивные ответы. | ticket-triage |
| Маршрутизация с порогом уверенности | Использует уверенность как вторую ось: ответ говорит что, а уверенность — стоит ли действовать. | Надёжность, безопасность | minConfidence для каждого вопроса и правила on: "confidence", по порогу на каждое действие. | voice-banking |
| Композитная оценка | Разбивает суждение на атомарные оценки и объединяет их с весами, которые вы контролируете. | Стоимость, надёжность, скорость | Один вопрос на измерение и композиты, которые можно использовать в правилах. | resume-screening |
| Маршрутизация по намерению | Классифицирует каждый запрос одним быстрым вызовом и отправляет его самому дешёвому подходящему обработчику. | Стоимость, скорость | Один вопрос choice для намерения (с зарезервированным other), правила для того, что должен увидеть человек. | customer-service-router |
Зачем паттерны
Каждое решение — это один вызов движка: Jev читает состояние один раз и отвечает на все вопросы параллельно, поэтому добавление вопросов почти не меняет задержку, а Dcision тарифицирует одно решение за вызов, сколько бы в нём ни было вопросов. Паттерны используют это, а также то, что каждый ответ приходит с откалиброванной вероятностью:
- Спрашивайте больше, а не чаще — fan-out отвечает на целое дерево решений за один круг запроса.
- Действуйте, только когда достаточно уверены — маршрутизация с порогом уверенности соотносит требуемую уверенность с ценой ошибки каждого действия.
- Держите математику вне модели — композитная оценка объединяет атомарные ответы с весами, хранящимися в решении.
- Тратьте дорогие ресурсы в последнюю очередь — маршрутизация по намерению отправляет справочные запросы в код, сложные случаи — специализированным LLM, а остальное — людям.
Строительные блоки
| Возможность | Полезна для |
|---|---|
| До 64 вопросов на решение, ответ на которые даёт один вызов | fan-out, композитная оценка, маршрутизация по намерению |
Правила политик с условиями and (до 5), побеждает первое совпадение | fan-out, маршрутизация с порогом уверенности, маршрутизация по намерению |
minConfidence для каждого вопроса и правила по confidence | маршрутизация с порогом уверенности |
Взвешенные уровни вопросов score (scores, правила on: "score") | fan-out, маршрутизация по намерению |
Композиты, возвращаемые в composites и доступные в правилах | композитная оценка |
Зарезервированный вариант other и действие fallback | маршрутизация по намерению, маршрутизация с порогом уверенности |
onEngineError: "fallback" — безопасное действие при сбое движка | любой паттерн на пути, который должен отвечать всегда |
См. Схема решения, Политики и действия и Настройки решения.
Паттерны в приложении
- Шаблоны открываются разделом Паттерны: по карточке на паттерн — что это, когда его использовать, как собрать в Dcision, его преимущества, ссылки на шаблоны, которые его реализуют, и на руководство TypeSafe. Ниже раздел Все шаблоны показывает паттерны каждого шаблона в виде бейджей.
- Новое решение показывает паттерны каждого шаблона рядом с числом его вопросов.
- Панель Паттерны в редакторе, под схемой решения на вкладке Редактор, сообщает, сколько из четырёх паттернов использует решение. Каждый пункт раскрывается, чтобы объяснить паттерн и показать либо как это решение его использует (Здесь), либо как его применить (Попробуйте).
Панель определяет паттерн по схеме:
| Паттерн | Определяется, когда у решения есть… |
|---|---|
| Спекулятивный fan-out | 4 вопроса или больше, либо 3 или больше и правило, условия которого используют разные поля |
| Маршрутизация с порогом уверенности | вопрос с минимальной уверенностью или правило по confidence |
| Композитная оценка | хотя бы один композит |
| Маршрутизация по намерению | вопрос choice как минимум с 3 вариантами помимо other или правило по ответу choice |
Паттерны сочетаются
Большинство решений в продакшене используют больше одного паттерна. Шаблон Квалификация лидов направляет лид в команду (маршрутизация по намерению), эскалирует, когда purchase_intent недостаточно уверен (маршрутизация с порогом уверенности), и ранжирует лиды по lead_score (композитная оценка) — за один вызов. Шаблоны перечисляют паттерны каждого шаблона.
Пишите вопросы, на которые движок может ответить
Паттерны комбинируют ответы; каждый ответ всё равно должен быть хорошим. Делайте вопросы атомарными и буквальными, держите математику и даты в коде и отправляйте только то состояние, которое нужно вопросам, — см. Как писать хорошие вопросы.
Выполнения и использование
Каждый запуск записывается с версией, причиной действия, уверенностью и — если вы разрешите — входными и выходными данными. Находите выполнения, смотрите использование и сроки хранения журналов.
Спекулятивный fan-out
Задайте за один вызов все вопросы, которые могут понадобиться процессу, — Jev отвечает на них параллельно, — а правила AND и ваш код решат, какие ответы важны. На основе шаблона Support Ticket Triage.