Подпространства

Одно подпространство на каждого клиента вашего приложения, по вашему собственному 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 удаляет подпространство со всеми его решениями и выполнениями. Уже оплаченное использование остаётся в вашем рабочем пространстве.

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