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 рабочего пространства. См. Куда попадает ваше состояние.

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

Общие вопросыDcision — это LLM?Какая модель отвечает на мои решения?Какие языки и SDK поддерживаются?Может ли решение вызывать мои системы или отвечать моим пользователям?Можно ли вызывать API из браузера или мобильного приложения?Насколько быстро принимается решение?Может ли решение что-то ответить, если движок недоступен?Оплата и квотыЧто считается тарифицируемым решением?Как проверить использование из кода?Что происходит сверх включённых решений — в том числе на Genesis?Как получить кредиты?Могут ли кредиты пополняться сами — и можно ли ограничить расходы?Делает ли собственный ключ провайдера решения бесплатными?Что означает metrics.estimated_cost_usd?РешенияЧто за вариант other, который я не добавлял?Почему мой вызов вернул escalate, хотя ни одна политика этого не задаёт?Почему уверенность моего вопроса probability ниже самой вероятности?Что такое scores и composites в ответе?Сколько вопросов должно задавать одно решение?Отклоняет ли block мой запрос?Я изменил решение, но API по-прежнему отвечает по-старому. Почему?Можно ли изменить slug?Как откатиться?Почему моё состояние отклоняется с 422 INVALID_STATE?Боевой или тестовый ключ — какой использовать?Команда и аккаунтМожет ли моя команда работать в одном рабочем пространстве?Можно ли входить по паролю?ДанныеХранит ли Dcision отправленные мной состояния?Кто обрабатывает мои данные?