FAQ
Ответы на частые вопросы о Dcision — оплата, квоты и кредиты, ключи, модели и задержка, хранение данных, публикации и интеграция.
Общие вопросы
Dcision — это LLM?
Нет. Dcision — это слой решений: вы задаёте структурированные вопросы и политики, и каждый вызов возвращает типизированные ответы, уверенность и действие. Ответы даёт движок решений — Jev (System One от TypeSafe, по умолчанию), OpenAI Decisions или Laya, — модель, которая возвращает распределения вероятностей вместо сгенерированного текста. Используйте Dcision, чтобы решать, нужно ли и куда отправить работу; саму работу пусть делают ваша LLM, агент или команда.
Какая модель отвечает на мои решения?
Движок решения или движок рабочего пространства по умолчанию — Jev, если администратор его не менял. На ключе движка Dcision Jev работает в TypeSafe с моделью, выбранной в Настройки → Движок, — jev-1.13.0 (закреплённая, по умолчанию), jev-latest или jev-preview. OpenAI Decisions выполняет gpt-6-luna на вашем ключе OpenAI, а Laya работает на вашем сервере. С собственным ключом — выбранные вами провайдер и модель. metrics.model всегда сообщает точную версию, которая ответила. См. Движки и BYOK.
Какие языки и SDK поддерживаются?
Любой язык, который умеет отправлять HTTPS-запрос с JSON, — API состоит из одного POST; см. примеры на cURL, JavaScript и Python в разделе Запуск решения. Официальные SDK для TypeScript и Python добавляют повторные попытки, которые никогда не запускают решение дважды, назначения-функции и проверку вебхуков; их пока нет в npm и PyPI, поэтому собирайте их из исходников. CLI покрывает терминал и CI.
Может ли решение вызывать мои системы или отвечать моим пользователям?
Да, с помощью назначений: для каждого варианта, уровня, порога или итогового действия можно вернуть готовый ответ или ответ LLM, передать работу вашему агенту, запустить workflow, отправить подписанный вебхук, вызвать любой API с вашими секретами или сообщить вашему коду, какую функцию запустить. Доставки повторяются около 7 часов, а из Playground ничего не отправляется, пока вы не включите Выполнять назначения по-настоящему.
Можно ли вызывать API из браузера или мобильного приложения?
Нет. API-ключи — это секреты: вызывайте Dcision из своего бэкенда, воркера или среды выполнения агента и передавайте результат клиенту, если он ему нужен.
Насколько быстро принимается решение?
Каждый ответ сообщает metrics.latency_ms, а раздел Использование показывает среднюю задержку и задержку p95 ваших решений. На все вопросы решения отвечает один вызов движка, параллельно, поэтому дополнительные вопросы почти не добавляют задержки. У вызова движка по умолчанию есть предельное время 5 секунд с учётом повторов — задайте его для решения через timeoutMs; вызов, который его превышает, завершается ошибкой 504 ENGINE_TIMEOUT.
Может ли решение что-то ответить, если движок недоступен?
Да, если вы это включите: с onEngineError: "fallback" при сбое движка решение отвечает 200 со своим действием fallback и action_reason.type = "engine_error". Такие ответы не тарифицируются. См. Настройки решения.
Оплата и квоты
Что считается тарифицируемым решением?
Успешный (200) вызов POST /v1/decisions/{slug} — один раз за вызов, сколько бы в нём ни было вопросов. Запуски в Playground, ошибки, идемпотентные повторы, fallback из-за ошибок движка и чтения (GET /v1/me, GET /v1/executions) бесплатны. Вызовы с тестовыми ключами и с вашим собственным ключом провайдера учитываются как любые другие. См. Что тарифицируется.
Как проверить использование из кода?
GET /v1/me возвращает тарифицируемые решения, использованные в текущем периоде, включённый объём и даты периода — с любым API-ключом рабочего пространства. См. Аккаунт и использование.
Что происходит сверх включённых решений — в том числе на Genesis?
Любой тариф продолжает работать на предоплаченных кредитах по цене тарифа за 1 млн решений: 12 US$ на Genesis и Developer, 9 US$ на Growth (60 R$ и 45 R$ в Бразилии). Для этого Genesis не требует подписки. Без кредитов вызовы API возвращают 402 CREDITS_EXHAUSTED, пока вы не добавите кредиты, не начнётся новый период или вы не повысите тариф. Playground продолжает работать. См. Кредиты.
Как получить кредиты?
Их добавляет владелец на странице Оплата: добавление карты даёт 20 US$ (100 R$) промокредитов на 90 дней — один раз на рабочее пространство и один раз на карту, — а купить кредиты картой можно на сумму от 10 до 1 000 US$ (от 50 до 5 000 R$). Оплаченные кредиты не сгорают. Ваучеры тоже добавляют промокредиты.
Могут ли кредиты пополняться сами — и можно ли ограничить расходы?
Да, и то и другое необязательно. Автопополнение списывает с сохранённой карты выбранную сумму каждый раз, когда доступный кредит опускается ниже порога, после того как владелец это разрешит; его можно выключить в любой момент. Лимит расходов на платёжный цикл останавливает вызовы сверх включённого объёма ошибкой 402 SPEND_CAP_REACHED, как только расходы кредитов за цикл его достигают.
Делает ли собственный ключ провайдера решения бесплатными?
Нет. С собственным ключом вызов движка тарифицирует провайдер, а успешный вызов API по-прежнему засчитывается в ваш тариф Dcision.
Что означает metrics.estimated_cost_usd?
Оценка стоимости движка для вызова — metrics.input_tokens, умноженное на цену модели (Jev: 0.042 US$ за 1 млн входных токенов; OpenAI Decisions: 0.10 US$; Laya: 0 — выходные токены бесплатны), — чтобы сравнивать решения. Это не то, что с вас берёт Dcision.
Решения
Что за вариант other, который я не добавлял?
Каждый вопрос choice получает зарезервированный вариант other, чтобы движок мог сказать «ничего из этого», а не выбирать неверный ответ. Когда он выбран, решение применяет своё действие fallback. См. Вопросы.
Почему мой вызов вернул escalate, хотя ни одна политика этого не задаёт?
Посмотрите на action_reason: other_option означает, что вопрос choice ответил other; low_confidence — что ответ оказался ниже своего minConfidence; engine_error — что движок дал сбой в решении с onEngineError: "fallback". Во всех трёх случаях применяется действие fallback решения, по умолчанию escalate. См. Политики и действия.
Почему уверенность моего вопроса probability ниже самой вероятности?
Потому что уверенность измеряет определённость в любую сторону, по той же шкале, что и у вопросов choice и score: для вероятности p она равна |2p − 1|. У вероятности 0.9 — или 0.1 — уверенность 0.8; у 0.5 — уверенность 0. Учитывайте это при выборе minConfidence: 0.6 отмечает любое p между 0.2 и 0.8. См. Уверенность и вероятности.
Что такое scores и composites в ответе?
scores содержит взвешенный уровень каждого вопроса score — среднее его уровней, взвешенное по вероятностям и отсчитываемое от 1, так что 2.4 находится между вторым и третьим уровнем. composites содержит взвешенные комбинации ответов решения, например оценку лида. И то и другое может управлять политиками. См. Вопросы и Композиты.
Сколько вопросов должно задавать одно решение?
Столько, сколько нужно процессу, до 64: на них отвечает один вызов, и тарифицируется он один раз. Задавайте и спекулятивные вопросы — ненужные ответы просто игнорируются. Делайте каждый вопрос атомарным и держите состояние в пределах бюджета токенов. См. Спекулятивный fan-out и Как писать хорошие вопросы.
Отклоняет ли block мой запрос?
Нет. Действия — это метки для вашего кода. Ответ — 200 OK с "action": "block", а что означает блокировка, решает ваше приложение.
Я изменил решение, но API по-прежнему отвечает по-старому. Почему?
API выполняет активную версию. Правки меняют черновик; опубликуйте их, чтобы создать новую версию. См. Версии и публикация.
Можно ли изменить slug?
До первой публикации. После этого slug блокируется, потому что его вызывают клиенты.
Как откатиться?
Версии неизменяемы и перечислены в Истории версий. Верните черновик к прежней схеме и опубликуйте его — это создаст новую версию со старой логикой.
Почему моё состояние отклоняется с 422 INVALID_STATE?
Сообщение называет проблему: отсутствует обязательное поле, неверный тип ("500" — это не number), текстовое решение получило объект, решение-список получило не массив или состояние превышает лимиты — само по себе или вместе с вопросами для бюджета токенов движка. Поля, которые схема не объявляет, допустимы.
Боевой или тестовый ключ — какой использовать?
Они запускают одни и те же опубликованные версии и тарифицируются одинаково; единственное отличие — доставки назначений для тестовых ключей содержат livemode: false. Используйте тестовые ключи для staging, CI и локальной разработки, чтобы отзывать их, не затрагивая продакшен.
Команда и аккаунт
Может ли моя команда работать в одном рабочем пространстве?
Да. Приглашайте людей по e-mail в Настройки → Участники как администраторов, участников или наблюдателей — приглашение действует 7 дней и принимается при входе. Каждый человек может состоять в нескольких рабочих пространствах и владеть максимум 10. См. Команда, роли и аккаунт.
Можно ли входить по паролю?
Да, если вы зададите его в Аккаунт → Пароль, — вход через Google и коды по e-mail продолжат работать. Смена пароля завершает ваши другие сессии, а Выйти на всех устройствах завершает их все.
Данные
Хранит ли Dcision отправленные мной состояния?
По умолчанию выполнения хранят состояние (storeInput) и ответы (storeOutput) в течение срока хранения журнала вашего тарифа — 7 дней на Genesis. Отключите любое из них для конкретного решения. Сохранённые состояния показываются только в приложении: GET /v1/executions никогда их не возвращает. См. Безопасность и данные.
Кто обрабатывает мои данные?
Dcision проверяет состояние и отправляет его вместе с контекстом и вопросами решения провайдеру движка: по умолчанию это TypeSafe под аккаунтом Dcision, либо провайдер вашего собственного ключа (OpenAI для OpenAI Decisions; ваш собственный сервер для Laya). Файлы, для чтения которых нужен OpenAI, — аудио, изображения для Jev или Laya, сканированные документы — отправляются в OpenAI с ключом OpenAI рабочего пространства. См. Куда попадает ваше состояние.