Структурированный вывод
Возвращайте JSON-объект, который ваша система использует как есть, или экран, который отображает ваше приложение, — собранный из результата (без модели) или LLM и всегда проверенный перед выходом из Dcision.
Решение отвечает на вопросы: result, confidence и action. Назначение структурированного вывода (json) также возвращает объект, готовый для вашей системы, — тикет, который нужно открыть, заказ, который нужно обновить, лид, который нужно создать, — и проверяет его по заданным вами полям, прежде чем он покинет Dcision.
Он возвращается в поле верхнего уровня output ответа:
{
"result": { "route": "support", "priority": "high" },
"action": "continue",
"output": { "awb": "1Z999AA10123456784", "team": "support", "priority": 3, "summary": "Package is 3 days late" },
"destinations": [
{ "key": "ticket", "type": "json", "mode": "template", "status": "completed", "output": { "awb": "1Z999AA10123456784", "team": "support", "priority": 3, "summary": "Package is 3 days late" } }
]
}Два способа заполнения
mode | Как | Стоимость и задержка |
|---|---|---|
template (по умолчанию) | JSON-шаблон с переменными — state, ответы, взвешенные уровни, composites и параметры. | Бесплатно, мгновенно: без вызова модели. |
extract | LLM читает state и заполняет поля, с вашим ключом OpenRouter или Vercel AI Gateway, — как ответы LLM. | Токены провайдера; вызывающий ждёт (это один из 3 вызовов, которых ждёт вызывающий). |
Используйте template, когда значения уже есть — в state или в ответах. Используйте extract, когда они спрятаны в тексте: номер заказа в письме, имя в сообщении чата.
Поля
schema — это объект JSON Schema, тот же формат, что используют провайдеры LLM для структурированных выводов:
{
"type": "object",
"properties": {
"awb": { "type": "string", "description": "The tracking number" },
"team": { "type": "string", "enum": ["sales", "support", "billing"] },
"priority": { "type": "integer", "minimum": 1, "maximum": 4 },
"items": { "type": "array", "items": { "type": "string" }, "maxItems": 10 },
"note": { "type": ["string", "null"] }
},
"required": ["awb", "team"]
}| Ключевое слово | Назначение |
|---|---|
type | string, number, integer, boolean, object или array — или ["string", "null"], чтобы принимать null. Корень всегда object. |
properties, required | Поля объекта и какие из них обязательны. Каждый объект объявляет свои поля. |
items | Что содержит список (обязательно для array). |
enum | Допустимые значения текстового или числового поля (до 50). |
description | Что означает поле — модель читает это в режиме extract. |
minimum, maximum, minLength, maxLength, minItems, maxItems | Границы чисел, текстов и списков. |
Поля, которых нет в схеме, не принимаются. Лимиты: до 3 уровней вложенных объектов, всего 50 полей и 8 КБ схемы; сам вывод — до 16 КБ. В редакторе Поля вывода строят схему строка за строкой; вкладка JSON Schema показывает её в виде JSON, и туда можно вставить готовую.
Режим template
Шаблон — это JSON с переменными, кодируемый как тело API-запроса: вне кавычек переменная становится значением JSON, внутри кавычек — текстом.
{
"key": "ticket",
"type": "json",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "support" }] },
"params": { "awb": { "from": "state.awb", "required": true } },
"json": {
"mode": "template",
"schema": { "type": "object", "properties": { "awb": { "type": "string" }, "team": { "type": "string" }, "priority": { "type": "number" }, "summary": { "type": "string" } }, "required": ["awb", "team"] },
"template": "{\"awb\": {{params.awb}}, \"team\": {{result.route}}, \"priority\": {{scores.priority}}, \"summary\": \"Customer said: {{state.message}}\"}"
}
}- Текст из state не может сломать JSON: кавычки и переносы строк экранируются, где бы ни стояла переменная.
- Секреты использовать нельзя — вывод возвращается вызывающему.
{{secrets.NAME}}отклоняется при сохранении. - При сохранении шаблон с примерными значениями должен быть корректным JSON и содержать обязательные поля. Заполнить по полям в редакторе пишет начальный шаблон: поле с именем, как у поля state, вопроса, composite или параметра, берёт значение оттуда.
Режим extract
"json": {
"mode": "extract",
"schema": { "type": "object", "properties": { "order_id": { "type": "string" }, "customer": { "type": "string" }, "request": { "type": "string", "enum": ["refund", "exchange", "tracking"] } }, "required": ["order_id", "request"] },
"provider": "openrouter",
"model": "openai/gpt-5-mini",
"instructions": "Extract the order this customer is writing about.",
"input": "{{state.message}}",
"temperature": 0,
"maxTokens": 1024,
"timeoutMs": 20000
}| Поле | По умолчанию | Описание |
|---|---|---|
provider | openrouter | openrouter или vercel — ключ, сохранённый в «Настройки → Движок». |
model | — | ID модели у провайдера. Выберите модель, поддерживающую структурированные выводы (JSON Schema). |
instructions | — | Что извлечь (системное сообщение): до 8 000 символов. Переменные разрешены, секреты — нет. |
input | всё state | Сообщение пользователя: до 8 000 символов. |
temperature | 0 | От 0 до 2. |
maxTokens | 1024 | От 16 до 4 096. |
timeoutMs | 20000 | От 1 000 до 25 000, включая повторы. |
Dcision отправляет схему в строгом режиме структурированного вывода провайдера (response_format: json_schema). Строгому режиму нужны все поля, поэтому необязательные поля передаются как допускающие null, а null, которые модель для них пишет, удаляются перед проверкой. Если ответ всё равно не подходит — некорректный JSON, значение вне enum, отсутствующее поле, — Dcision один раз отправляет его обратно с описанием проблем, в пределах того же timeoutMs.
При ошибке
Структурированный вывод никогда не ломает решение. Запись возвращается с "status": "failed", error и, если объект не подошёл, issues:
{
"key": "ticket",
"type": "json",
"mode": "template",
"status": "failed",
"error": "The output doesn't match the schema.",
"issues": [{ "path": "/awb", "message": "Must not be null." }]
}issues[].path — это JSON Pointer на значение (/items/2). output верхнего уровня:
| Случай | output |
|---|---|
Назначение json завершилось успешно | Его объект — первый в порядке схемы, если сработало несколько. |
Назначения json сработали, ни одно не завершилось успешно | null |
Ни одно назначение json не сработало | отсутствует |
Экраны (json-render)
С "format": "ui" вывод — это экран, а не данные: spec json-render — карточки, текст, бейджи, таблицы, кнопки, — который ваше приложение отображает нативно. Он отвечает вызывающему интерфейсом, а не просто значением: статус заказа с кнопкой Talk to support, сводка по лиду со ссылкой Book a demo.
"json": {
"format": "ui",
"mode": "template",
"template": "{\"root\": \"card\", \"elements\": {\"card\": {\"type\": \"Card\", \"props\": {\"title\": \"Order {{state.awb}}\"}, \"children\": [\"status\", \"talk\"]}, \"status\": {\"type\": \"Badge\", \"props\": {\"text\": {{result.route}}}, \"children\": []}, \"talk\": {\"type\": \"Button\", \"props\": {\"label\": \"Talk to support\"}, \"children\": [], \"on\": {\"press\": {\"action\": \"reply\", \"params\": {\"text\": \"support\"}}}}}}"
}Экран — это { "root", "elements" }: плоская карта элементов, у каждого type, props, children (ключи элементов) и необязательный on (событие → действие). Вывод возвращается полным — каждый prop каждого компонента, null, если не используется.
Каталог
Экраны используют каталог Dcision — точное подмножество компонентов shadcn json-render, с теми же props:
| Компоненты | Назначение |
|---|---|
Card, Stack, Grid, Separator | Компоновка. |
Heading, Text, Badge, Alert | Текст и статус. |
Table, Image, Avatar, Progress | Данные и медиа. |
Button, Link | Действия (on.press). |
| Действие | Параметры | Значение |
|---|---|---|
reply | { "text": "…" } | Отправить текст обратно как следующее сообщение пользователя — быстрый ответ. |
open_url | { "url": "https://…" } | Открыть URL. |
Как Dcision проверяет экран
Каждый экран — из шаблона или от LLM — проходит собственные проверки json-render и усиленные проверки Dcision:
autoFixSpecиз json-render исправляет частые ошибки моделей (visibleвнутриprops, несуществующий дочерний элемент).- Структура должна быть целостной: существующий корень, существующие дочерние элементы, известные типы компонентов.
- Props проверяются для каждого компонента по его схеме — неизвестные props отклоняются.
- Действия: только
replyиopen_url, на событии, которое есть у компонента (press), с корректными параметрами. - URL —
Link.href,Image.src,Avatar.src,open_url— должны бытьhttps://(никаких ссылокjavascript:, никакого отслеживания по обычному http). - Только итоговые значения: никаких
repeat, условий видимости или выражений$state;classNameвсегдаnull. Не более 60 элементов и 32 КБ.
В режиме extract модель получает промпт каталога json-render плюс ваши инструкции; если её экран не проходит проверку, Dcision один раз отправляет проблемы обратно. Шаблоны проверяются при сохранении, с примерными значениями.
Отображение
npm install @json-render/core @json-render/react @json-render/shadcn zodimport { defineCatalog } from "@json-render/core";
import { JSONUIProvider, Renderer, defineRegistry } from "@json-render/react";
import { schema } from "@json-render/react/schema";
import { shadcnComponents } from "@json-render/shadcn";
import { shadcnComponentDefinitions as d } from "@json-render/shadcn/catalog";
import { z } from "zod";
const names = ["Card", "Stack", "Grid", "Separator", "Heading", "Text", "Badge", "Alert", "Table", "Image", "Avatar", "Progress", "Button", "Link"] as const;
const catalog = defineCatalog(schema, {
components: Object.fromEntries(names.map((name) => [name, d[name]])),
actions: {
reply: { params: z.object({ text: z.string() }), description: "Quick reply" },
open_url: { params: z.object({ url: z.string() }), description: "Open a URL" },
},
});
const { registry } = defineRegistry(catalog, {
components: Object.fromEntries(names.map((name) => [name, shadcnComponents[name]])),
actions: { reply: async () => {}, open_url: async () => {} },
});
export function DecisionScreen({ decision, send }) {
return (
<JSONUIProvider
registry={registry}
handlers={{
reply: async ({ text }) => send(text),
open_url: async ({ url }) => window.open(url, "_blank", "noopener"),
}}
>
<Renderer spec={decision.output} registry={registry} />
</JSONUIProvider>
);
}json-render также отображает тот же spec в React Native, React Email, React PDF и других средах — сопоставьте там те же имена компонентов.
В Playground и в журналах
- В Playground назначения
templateвсегда выполняются (они бесплатны); назначенияextractпоказывают промпт и строгую схему, которые были бы отправлены ("status": "preview"), если только вы не выполняете назначения по-настоящему. Экраны отображаются, а нажатие кнопки показывает действие, которое она отправила бы. - Журнал выполнений сохраняет
output, когда решение хранит результаты (storeOutput); сstoreOutput: falseон хранит только то, был ли вывод собран. - SDK предоставляют его как
decision.output— в TypeScript с типизацией черезdcision.decide<Result, Output>(…).
Готовые ответы
Возвращайте готовое сообщение — текст и необязательные кнопки, с переменными — в ответе API для заданного результата, мгновенно и без вызова какой-либо модели.
Ответы LLM
Пусть за маршрут отвечает модель — Dcision вызывает OpenRouter или Vercel AI Gateway с собственным ключом вашего рабочего пространства, промптом маршрута как system-сообщением и состоянием как входом.