Готовые ответы
Возвращайте готовое сообщение — текст и необязательные кнопки, с переменными — в ответе API для заданного результата, мгновенно и без вызова какой-либо модели.
Готовый ответ — самое простое назначение: сообщение, которое вы пишете один раз и которое возвращается в ответе всякий раз, когда срабатывает его триггер. Dcision подставляет переменные и возвращает его — без вызова модели, без дополнительной задержки и без оплаты.
Используйте его для подтверждений, ссылок и следующих шагов, которые не нужно генерировать: «Спасибо! Сегодня с вами свяжется наш отдел продаж.» — с кнопками быстрого ответа для чат-виджета, WhatsApp или шаблона e-mail.
Настройте его
{
"key": "sales_reply",
"type": "reply",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
"params": { "seats": { "from": "state.company_size" } },
"reply": {
"text": "Thanks! Our sales team will contact you today about {{params.seats}} seats.",
"buttons": ["Book a demo", "See pricing"]
}
}| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
reply.text | string | — | Сообщение, от 1 до 4 000 символов. Переменные разрешены; переносы строк сохраняются. |
reply.buttons | массив строк | [] | До 10 подписей длиной до 80 символов каждая — быстрые ответы или пункты списка для вашего интерфейса. Переменные разрешены. |
Тексты используют текстовое кодирование: значения вставляются как текст, а отсутствующее значение становится пустой строкой. Секреты нельзя использовать в ответе — он возвращается тому, кто вызвал API.
В ответе API
{
"key": "sales_reply",
"type": "reply",
"text": "Thanks! Our sales team will contact you today about 500 seats.",
"buttons": ["Book a demo", "See pricing"]
}У записи ответа нет status: она всегда формируется. Покажите пользователю text, а buttons — как быстрые ответы; когда кнопку нажимают, отправьте её подпись обратно как следующее state вашего диалога.
Полезно знать
- Ответы учитываются в лимите из 10 назначений, которые могут сработать за одно выполнение, но не в лимите из 3, которых ждёт вызывающий.
- Решение может вернуть несколько ответов — например, по одному на вопрос — в порядке схемы.
- В Playground ответ отображается как пузырь чата с кнопками, в том числе в предпросмотрах.
- Нужен разный ответ на каждое сообщение? Используйте на этом маршруте ответ LLM или собственного агента.
Параметры и шаблоны
Передача значений в назначение — параметры из поля или фиксированного значения, обязательные параметры, переменные {{…}} в URL, заголовках, телах и текстах и то, как каждое место их кодирует.
Структурированный вывод
Возвращайте JSON-объект, который ваша система использует как есть, или экран, который отображает ваше приложение, — собранный из результата (без модели) или LLM и всегда проверенный перед выходом из Dcision.