Встраивание редактора

Позвольте клиентам создавать, редактировать, тестировать и публиковать свои решения внутри вашего приложения — сессии встраивания с вашего бэкенда, скрипт @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 показывается в редакторе и в чате агента и учитывается в персональных лимитах агента. Берите его из собственной сессии.

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