Incorporar o editor
Deixe os seus clientes criarem, editarem, testarem e publicarem as decisões deles dentro do seu app — sessões de embed pelo seu backend, o script @dcision/embed, permissões e eventos.
Os seus usuários finais recebem as telas de decisão da Dcision dentro do seu app: a lista de decisões, os templates, Criar com o agente, o editor e o construtor visual, o playground, o deploy e as execuções de cada decisão. Eles atuam só no sub-workspace deles e nunca veem API keys, cobrança ou configurações.
1. Abra uma sessão (o seu backend)
Quando um usuário logado abre a página, o seu backend chama POST /v1/embed/sessions com a sua API key — nunca pelo 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 é um link de abertura de uso único, válido por 60 segundos. A sessão em si dura ttl_seconds (padrão 1 hora, até 12).
2. Monte-o (a sua 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();
},
});- O iframe cresce com o conteúdo (
height: "auto") e reabre uma sessão sozinho quando ela expira, na página em que o usuário estava. embed.navigate("/decisions/new")abre uma página;embed.setTheme("dark")troca o tema.- Permita o frame na sua Content-Security-Policy:
frame-src https://app.dcision.io. - Enquanto o
@dcision/embednão estiver no npm, copie o código-fonte dele do repositório da Dcision (packages/embed): ele não tem dependências.
Permissões
| Permissão | Permite ao usuário |
|---|---|
decisions:read | Ver decisões, versões, a visão geral e a conversa com o agente |
decisions:write | Criar (a partir de templates), editar, duplicar e testar no playground |
decisions:deploy | Publicar, desativar e ativar |
decisions:delete | Apagar decisões |
executions:read | Ver execuções e entregas de destinos |
agent | Criar e editar com o agente |
Padrão: todas elas. Mapeie-as a partir dos seus próprios papéis — por exemplo, leitores recebem decisions:read e executions:read.
Eventos
O embed envia estas mensagens para a sua página (só para as suas origens permitidas). Elas levam ids, slugs, versões e paths — nunca tokens ou entradas.
| Evento | Quando |
|---|---|
ready, navigate | O embed carregou, ou o usuário foi para outra página (path) |
resize | A altura do conteúdo mudou (height) |
decision.created · decision.updated · decision.deleted | Uma decisão foi criada, teve o rascunho salvo ou foi apagada |
decision.deployed · decision.enabled · decision.disabled | O que roda em produção mudou (version) |
session.expiring · session.expired | A sessão termina em 2 minutos / terminou (o script a reabre) |
Segurança
- Só as origens permitidas em Configurações → Parceiro podem enquadrar o editor, e só durante a vida da sessão. Aberto fora de um iframe, o link não mostra nada.
- A sua API key fica no seu servidor. Revogue uma sessão com
DELETE /v1/embed/sessions/{id}, ou todas as de um usuário comPOST /v1/embed/sessions/revoke; revogar ou regenerar a API key que as criou também as encerra. - O
userque você envia aparece no editor e no chat do agente e conta para os limites por pessoa do agente. Pegue-o da sua própria sessão.
Sub-workspaces
Um sub-workspace por cliente do seu app, pelo seu próprio id — crie, copie suas decisões para ele, rode-as com Dcision-Workspace, limite e acompanhe o uso.
Use a Dcision no Claude Code
Conecte o Claude Code à Dcision com o servidor MCP e a skill da Dcision — liste, cheque e rode decisões, escreva e valide decision schemas, e use a CLI e os SDKs a partir do seu agente.