Integra el editor
Permite que tus clientes creen, editen, prueben y publiquen sus decisiones dentro de tu app con sesiones de embed desde tu backend, el script @dcision/embed, permisos y eventos.
Tus usuarios finales obtienen las pantallas de decisiones de Dcision dentro de tu app: la lista de decisiones, las plantillas, Crear con el agente, el editor y el constructor visual, el playground, la publicación y las ejecuciones de cada decisión. Actúan solo en su subespacio y nunca ven claves de API, facturación ni configuración.
1. Abre una sesión (tu backend)
Cuando un usuario con sesión iniciada abre la página, tu backend llama a POST /v1/embed/sessions con tu clave de API, nunca desde el navegador:
// 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 es un enlace de apertura de un solo uso, válido por 60 segundos. La sesión en sí dura ttl_seconds (por defecto 1 hora, hasta 12).
2. Móntalo (tu página)
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();
},
});- El iframe crece con su contenido (
height: "auto") y vuelve a abrir una sesión por sí solo cuando expira, en la página donde estaba el usuario. embed.navigate("/decisions/new")abre una página;embed.setTheme("dark")cambia el tema.- Permite el frame en tu Content-Security-Policy:
frame-src https://app.dcision.io. - Hasta que
@dcision/embedesté en npm, copia su código fuente del repositorio de Dcision (packages/embed): no tiene dependencias.
Permisos
| Permiso | Permite al usuario |
|---|---|
decisions:read | Ver decisiones, versiones, el resumen y la conversación con el agente |
decisions:write | Crear (desde plantillas), editar, duplicar y probar en el playground |
decisions:deploy | Publicar, desactivar y activar |
decisions:delete | Eliminar decisiones |
executions:read | Ver ejecuciones y entregas de destinos |
agent | Crear y editar con el agente |
Por defecto: todos. Asígnalos a partir de tus propios roles; p. ej., los lectores reciben decisions:read y executions:read.
Eventos
El embed envía estos mensajes a tu página (solo a tus orígenes permitidos). Llevan IDs, slugs, versiones y rutas, nunca tokens ni entradas.
| Evento | Cuándo |
|---|---|
ready, navigate | El embed cargó, o el usuario pasó a otra página (path) |
resize | Cambió la altura del contenido (height) |
decision.created · decision.updated · decision.deleted | Se creó una decisión, se guardó su borrador o se eliminó |
decision.deployed · decision.enabled · decision.disabled | Cambió lo que se ejecuta en producción (version) |
session.expiring · session.expired | La sesión termina en 2 minutos / terminó (el script la vuelve a abrir) |
Seguridad
- Solo los orígenes permitidos en Configuración → Socio pueden mostrar el editor en un frame, y solo durante la vida de la sesión. Abierto fuera de un iframe, el enlace no muestra nada.
- Tu clave de API se queda en tu servidor. Revoca una sesión con
DELETE /v1/embed/sessions/{id}, o todas las de un usuario conPOST /v1/embed/sessions/revoke; revocar o regenerar la clave de API que las creó también las cierra. - El
userque envías se muestra en el editor y en el chat del agente, y cuenta para los límites por persona del agente. Tómalo de tu propia sesión.
Subespacios
Un subespacio por cliente de tu app, con tu propio id — créalo, copia tus decisiones en él, ejecútalas con Dcision-Workspace, limita y vigila su uso.
Usar Dcision en Claude Code
Conecta Claude Code a Dcision con el servidor MCP y la skill de Dcision — lista, comprueba y ejecuta decisiones, escribe y valida esquemas de decisión, y usa la CLI y los SDKs desde tu agente.