Versões e deploy
Rascunhos, versões imutáveis, deploys, slugs, desativar, duplicar e excluir decisões — e o que os seus clientes da API veem em cada etapa.
Toda decisão tem um rascunho editável e um histórico de versões imutáveis. A API sempre roda a versão ativa; o rascunho só chega à produção quando você o publica.
Anatomia de uma decisão
| Propriedade | Regras |
|---|---|
| Nome | De 1 a 80 caracteres. |
| Slug | O endpoint: POST /v1/decisions/{slug}. Letras minúsculas, dígitos e hifens simples, até 64 caracteres. Único no workspace. |
| Descrição | Opcional, até 500 caracteres. |
| Rascunho | O schema que você está editando. |
| Versões | Snapshots imutáveis criados a cada deploy: v1, v2, … |
| Status | Draft, Live ou Disabled. |
Ciclo de vida
Draft ──deploy──▶ Live (v1) ──deploy──▶ Live (v2) ──deploy──▶ …
│ ▲
disable│ │enable
▼ │
Disabled| Status | O que POST /v1/decisions/{slug} devolve |
|---|---|
| Rascunho — nunca publicada | 409 DECISION_NOT_DEPLOYED |
| No ar | 200 com a resposta da versão ativa; version diz qual |
| Desativada | 409 DECISION_DISABLED |
| Excluída (ou slug desconhecido) | 404 DECISION_NOT_FOUND |
Rascunhos e salvamento automático
O editor e o construtor visual editam o mesmo rascunho. As mudanças são salvas automaticamente cerca de 1,5 segundo depois da sua última edição — só quando o rascunho é válido; caso contrário, a barra de salvamento lista os problemas com um link Ir para o erro.
Se um colega (ou outra aba) salvou a decisão depois que você a abriu, o seu salvamento é recusado em vez de sobrescrever o dele: a barra de salvamento mostra Outra pessoa salvou esta decisão e oferece Carregar a versão atual.
Salvar um rascunho nunca muda a produção.
Deploy
Publicar (na aba Publicar da decisão) congela o rascunho atual como a versão n + 1 e a torna ativa imediatamente — os clientes em andamento passam a usá-la na próxima chamada. As edições não salvas são salvas primeiro; um rascunho com problemas de schema não pode ser publicado.
- As versões são imutáveis: não podem ser editadas nem excluídas.
- O campo
versionda resposta e cada execução registram a versão que respondeu. - O Histórico de versões lista todas as versões (No ar ou Arquivada) com o schema completo.
- Uma versão continua rodando como foi publicada. Quando a Dcision endurece uma regra de validação — a v0.3 confere os valores das regras contra as opções, os níveis e os intervalos com que eles são comparados —, a nova regra vale a partir da próxima vez que você salvar ou publicar o rascunho, nunca para uma versão no ar.
- Publicar, como qualquer mudança numa decisão, exige o papel de Membro ou superior — veja Time, papéis e conta.
Voltando atrás
Ainda não existe rollback com um clique. Para voltar a um comportamento anterior, abra o schema da versão no Histórico de versões, leve o rascunho de volta a ele e publique — isso cria um novo número de versão com a lógica antiga.
Slugs
- Quando você cria uma decisão, o slug é gerado a partir do nome: acentos removidos, tudo em minúsculas e o resto convertido em hifens — "Lead Qualification!" vira
lead-qualification. Se o slug já estiver em uso, um sufixo é adicionado:lead-qualification-2. - Você pode mudar o slug até o primeiro deploy. Depois disso ele fica travado: os clientes o chamam, e renomeá-lo os quebraria (
409 CONFLICT— "The slug can't change after the first deploy."). - Os slugs são únicos por workspace. Dois workspaces podem ter uma decisão
lead-qualificationcada: a API key decide qual workspace — e, portanto, qual decisão — roda.
Desativar e ativar
Desativar endpoint para uma decisão no ar sem perder nada: as chamadas recebem 409 DECISION_DISABLED até você clicar em Ativar endpoint, que volta a servir a mesma versão ativa. Só uma decisão que já foi publicada pode ser ativada.
Duplicar
Duplicar copia o rascunho (não as versões) para uma nova decisão chamada "nome (copy)", com o próprio slug e sem versões. Ela conta para o limite de decisões do seu plano.
Excluir
Excluir remove a decisão junto com as versões e o histórico de execuções. As chamadas ao slug dela falham imediatamente com 404 DECISION_NOT_FOUND, e o slug fica livre para uma nova decisão. Não dá para desfazer.
Limites do plano
O número de decisões por workspace depende do plano — 2 no Genesis, 10 no Developer, ilimitadas no Growth e no Enterprise. Criar ou duplicar além disso falha com 402 PLAN_LIMIT_REACHED; exclua uma decisão ou faça upgrade. Decisões desativadas e em rascunho também contam.
Confiança e probabilidades
O que a confiança significa para cada tipo de pergunta numa escala única de 0 a 1, como ela afeta minConfidence, níveis ponderados, as distribuições completas e os quase empates.
Configurações da decisão
engine, storeInput, storeOutput, timeoutMs, fallbackAction, onEngineError e shadow — o que cada configuração de runtime de uma decisão faz, seu padrão e seus limites — mais as configurações do workspace.