Подпространства
Одно подпространство на каждого клиента вашего приложения, по вашему собственному id, — создайте его, скопируйте в него свои решения, запускайте их с Dcision-Workspace, ограничивайте и отслеживайте использование.
Подпространство содержит решения одного клиента. Вы обращаетесь к нему по вашему id клиента (external_id, например id вашего рабочего пространства или аккаунта), поэтому вам никогда не нужно хранить id Dcision.
Создание
POST /v1/workspaces создаёт подпространство для external_id или обновляет его, если оно уже существует, — вызывайте его каждый раз, когда клиент включает функцию.
curl https://api.dcision.io/v1/workspaces \
-H "Authorization: Bearer $DCISION_API_KEY" -H "Content-Type: application/json" \
-d '{
"external_id": "acme",
"name": "Acme Inc",
"seed": { "decisions": ["lead-qualification"], "deploy": true }
}'seed копирует опубликованную версию ваших собственных решений в новое подпространство, с теми же slug, — так каждый клиент начинает с вашего рабочего решения и затем может его изменить. Это выполняется только при создании подпространства; ответ перечисляет, что было скопировано и что пропущено.
Запуск решения клиента
Отправьте свой API-ключ с заголовком Dcision-Workspace: ext:<external_id> (или с id подпространства):
curl https://api.dcision.io/v1/decisions/lead-qualification \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Dcision-Workspace: ext:acme" \
-H "Content-Type: application/json" \
-d '{ "state": { "message": "Can you send pricing for 500 seats?" } }'Тот же заголовок работает для GET /v1/decisions, GET /v1/me, GET /v1/executions и MCP-сервера. Чужое подпространство отвечает 404 WORKSPACE_NOT_FOUND. SDK принимают его как опцию:
const acme = dcision.withWorkspace("ext:acme");
await acme.decide("lead-qualification", { message: "Pricing?" });Идемпотентность действует в пределах подпространства: один и тот же Idempotency-Key, отправленный для двух клиентов, — это конфликт (409), а не сохранённый ответ другого клиента.
Оплата и лимиты
- Каждый тарифицируемый запуск подпространства учитывается в использовании, тарифе и кошельке вашего рабочего пространства; rate limits тоже берутся от вашего рабочего пространства.
- Лимиты на клиента (в Настройки → Партнёр или в
limitsподпространства):max_decisions(402 PLAN_LIMIT_REACHEDсscope: "workspace") иmonthly_decisionsна платёжный цикл (402 QUOTA_EXCEEDEDсscope: "workspace"). GET /v1/meс этим заголовком добавляетworkspace_usage— запуски клиента за цикл и его лимит.- Подпространства работают на ваших настройках и ключах движка. Их назначения LLM и JSON используют ваши LLM-ключи, только если вы это разрешите; секреты рабочего пространства никогда не передаются.
Перенос вашего решения в подпространство
Решение, которое вы собрали в своём рабочем пространстве, можно перенести в подпространство клиента вместе с историей (версии, выполнения, доставки, чат с агентом) — через POST /v1/decisions/{slug}/move с { "to": "ext:acme" } или через ⋯ → Перенести в подпространство в приложении (владельцы и администраторы). Если в подпространстве есть нетронутая копия с тем же slug (из seed), replace_empty: true заменяет её. После этого вызывайте решение с Dcision-Workspace.
Просмотр решений клиента в приложении
Настройки → Партнёр → Открыть показывает решения подпространства внутри приложения Dcision — те же экраны, которые ваши клиенты видят в вашем. Участники вашего рабочего пространства их редактируют; наблюдатели только просматривают.
Удаление
DELETE /v1/workspaces/ext:acme удаляет подпространство со всеми его решениями и выполнениями. Уже оплаченное использование остаётся в вашем рабочем пространстве.
Партнёры
Предложите Dcision внутри своего приложения — отдельное подпространство на каждого клиента, встраиваемый редактор для ваших пользователей и оплата использования из вашего рабочего пространства.
Встраивание редактора
Позвольте клиентам создавать, редактировать, тестировать и публиковать свои решения внутри вашего приложения — сессии встраивания с вашего бэкенда, скрипт @dcision/embed, права и события.