Структурированный вывод

Возвращайте 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 и параметры.Бесплатно, мгновенно: без вызова модели.
extractLLM читает 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"]
}
Ключевое словоНазначение
typestring, 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
}
ПолеПо умолчаниюОписание
provideropenrouteropenrouter или vercel — ключ, сохранённый в «Настройки → Движок».
model—ID модели у провайдера. Выберите модель, поддерживающую структурированные выводы (JSON Schema).
instructions—Что извлечь (системное сообщение): до 8 000 символов. Переменные разрешены, секреты — нет.
inputвсё stateСообщение пользователя: до 8 000 символов.
temperature0От 0 до 2.
maxTokens1024От 16 до 4 096.
timeoutMs20000От 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:

  1. autoFixSpec из json-render исправляет частые ошибки моделей (visible внутри props, несуществующий дочерний элемент).
  2. Структура должна быть целостной: существующий корень, существующие дочерние элементы, известные типы компонентов.
  3. Props проверяются для каждого компонента по его схеме — неизвестные props отклоняются.
  4. Действия: только reply и open_url, на событии, которое есть у компонента (press), с корректными параметрами.
  5. URL — Link.href, Image.src, Avatar.src, open_url — должны быть https:// (никаких ссылок javascript:, никакого отслеживания по обычному http).
  6. Только итоговые значения: никаких repeat, условий видимости или выражений $state; className всегда null. Не более 60 элементов и 32 КБ.

В режиме extract модель получает промпт каталога json-render плюс ваши инструкции; если её экран не проходит проверку, Dcision один раз отправляет проблемы обратно. Шаблоны проверяются при сохранении, с примерными значениями.

Отображение

npm install @json-render/core @json-render/react @json-render/shadcn zod
import { 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>(…).

На этой странице