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/embed nã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ãoPermite ao usuário
decisions:readVer decisões, versões, a visão geral e a conversa com o agente
decisions:writeCriar (a partir de templates), editar, duplicar e testar no playground
decisions:deployPublicar, desativar e ativar
decisions:deleteApagar decisões
executions:readVer execuções e entregas de destinos
agentCriar 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.

EventoQuando
ready, navigateO embed carregou, ou o usuário foi para outra página (path)
resizeA altura do conteúdo mudou (height)
decision.created · decision.updated · decision.deletedUma decisão foi criada, teve o rascunho salvo ou foi apagada
decision.deployed · decision.enabled · decision.disabledO que roda em produção mudou (version)
session.expiring · session.expiredA 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 com POST /v1/embed/sessions/revoke; revogar ou regenerar a API key que as criou também as encerra.
  • O user que 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.

Nesta página