Встраивание редактора
Позвольте клиентам создавать, редактировать, тестировать и публиковать свои решения внутри вашего приложения — сессии встраивания с вашего бэкенда, скрипт @dcision/embed, права и события.
Ваши конечные пользователи получают экраны решений Dcision внутри вашего приложения: список решений, шаблоны, создание с агентом, редактор и визуальный конструктор, Playground, публикацию и выполнения каждого решения. Они работают только в своём подпространстве и никогда не видят API-ключи, оплату или настройки.
1. Откройте сессию (ваш бэкенд)
Когда вошедший пользователь открывает страницу, ваш бэкенд вызывает POST /v1/embed/sessions с вашим API-ключом — никогда из браузера:
// POST /api/dcision/session in your backend — the user and their workspace come from YOUR session, never the request.
const session = await dcision.embed.createSession({
workspace: { external_id: currentWorkspace.id, name: currentWorkspace.name },
user: { id: currentUser.id, name: currentUser.name },
permissions: canEdit ? undefined : ["decisions:read", "executions:read"],
start_path: body.path, // where the user was (sent back by the embed after a session expires)
locale: "pt",
});
return { url: session.url };url — это одноразовая ссылка запуска, действующая 60 секунд. Сама сессия длится ttl_seconds (по умолчанию 1 час, максимум 12).
2. Смонтируйте его (ваша страница)
import { mount } from "@dcision/embed";
const embed = await mount(document.getElementById("decisions")!, {
getSession: ({ path }) => fetch("/api/dcision/session", { method: "POST", body: JSON.stringify({ path }) }).then((r) => r.json()),
onEvent: (event) => {
if (event.type === "decision.deployed") refreshStrategies();
},
});- iframe растёт вместе с содержимым (
height: "auto") и сам открывает новую сессию, когда текущая истекает, — на той странице, где был пользователь. embed.navigate("/decisions/new")открывает страницу;embed.setTheme("dark")переключает тему.- Разрешите фрейм в своей Content-Security-Policy:
frame-src https://app.dcision.io. - Пока
@dcision/embedне опубликован в npm, скопируйте его исходники из репозитория Dcision (packages/embed): у него нет зависимостей.
Права
| Право | Позволяет пользователю |
|---|---|
decisions:read | Видеть решения, версии, обзор и диалог с агентом |
decisions:write | Создавать (из шаблонов), редактировать, дублировать и тестировать в Playground |
decisions:deploy | Публиковать, отключать и включать |
decisions:delete | Удалять решения |
executions:read | Видеть выполнения и доставки назначений |
agent | Создавать и редактировать с агентом |
По умолчанию — все. Сопоставьте их со своими ролями — например, наблюдатели получают decisions:read и executions:read.
События
Встроенный редактор отправляет эти сообщения вашей странице (только на ваши разрешённые источники). Они содержат id, slug, версии и пути — никогда не токены и не входные данные.
| Событие | Когда |
|---|---|
ready, navigate | Встроенный редактор загрузился или пользователь перешёл на другую страницу (path) |
resize | Изменилась высота содержимого (height) |
decision.created · decision.updated · decision.deleted | Решение создано, его черновик сохранён или оно удалено |
decision.deployed · decision.enabled · decision.disabled | Изменилось то, что работает в продакшене (version) |
session.expiring · session.expired | Сессия закончится через 2 минуты / закончилась (скрипт открывает её снова) |
Безопасность
- Встраивать редактор во фрейм могут только источники, разрешённые в «Настройки → Партнёр», и только на время жизни сессии. Открытая вне iframe ссылка ничего не показывает.
- Ваш API-ключ остаётся на вашем сервере. Отзовите сессию через
DELETE /v1/embed/sessions/{id}или все сессии пользователя черезPOST /v1/embed/sessions/revoke; отзыв или перевыпуск API-ключа, который их создал, тоже закрывает их. - Переданный вами
userпоказывается в редакторе и в чате агента и учитывается в персональных лимитах агента. Берите его из собственной сессии.
Подпространства
Одно подпространство на каждого клиента вашего приложения, по вашему собственному id, — создайте его, скопируйте в него свои решения, запускайте их с Dcision-Workspace, ограничивайте и отслеживайте использование.
Dcision в Claude Code
Подключите Claude Code к Dcision через MCP-сервер и навык Dcision — просматривайте, проверяйте и запускайте решения, пишите и валидируйте схемы решений, используйте CLI и SDK из агента.