CLI
A linha de comando dcision — salve uma API key, rode decisões, liste templates, crie e valide decision schemas offline — com códigos de saída para scripts e CI.
O @dcision/cli instala o comando dcision. Use-o para chamar decisões publicadas a partir de um terminal ou de um script, e para manter decision schemas no controle de versão com validação offline.
Instalação
Ainda não está no npm
O @dcision/cli não está publicado no npm. Compile-o a partir de um checkout do repositório da Dcision; até esta página dizer que ele foi publicado, um pacote com este nome no npm não vem da Dcision — não o instale, muito menos em CI.
# In a checkout of the Dcision repository — Node.js 22 and pnpm 10
pnpm install
pnpm --filter "@dcision/cli..." build # builds @dcision/core, then the CLI
npm install -g ./packages/cli # puts `dcision` on your PATH, linked to this checkout
dcision --versionO ... depois do nome do pacote compila primeiro os pacotes dos quais o CLI depende. Sem instalá-lo globalmente, rode node packages/cli/dist/bin.js em vez de dcision. Ele precisa do Node.js 20 ou mais recente.
Início rápido
# Save an API key (prompted, so it stays out of your shell history)
dcision login
# Run a deployed decision
dcision decide lead-qualification \
--state '{"message":"We need pricing for 500 users and want to start next month.","company_size":500}'
# Print the raw API response, with the full distributions
dcision decide lead-qualification --state-file lead.json --probabilities --jsonComandos
| Comando | Descrição |
|---|---|
dcision login [--api-key <key>] [--api-url <url>] | Salva uma API key — pedida no prompt quando omitida, lida do stdin quando vem por pipe. |
dcision logout | Remove a key guardada. |
dcision config list | Mostra a configuração. |
dcision config get <key> | Imprime uma configuração. |
dcision config set <key> <value> | Altera uma configuração: api-url ou output. |
dcision decide <slug> [options] | Roda uma decisão publicada. |
dcision templates | Lista os templates embutidos. |
dcision init [file] [--template <id>] [--force] | Escreve um decision schema em JSON (padrão ./decision.json). |
dcision validate <file> | Valida um decision schema offline. |
dcision check-state <schema-file> (--state <json> | --state-file <path>) | Valida um estado contra um schema offline. |
dcision --version, dcision --help | Versão e ajuda. |
login
dcision login # prompts for the key
dcision login --api-key "$DCISION_API_KEY" # non-interactive
echo "$DCISION_API_KEY" | dcision login # reads stdin when piped
dcision login --api-url https://api.dcision.io # also saves the API URLA key é guardada em ~/.config/dcision/config.json com modo de arquivo 600 (legível só por você). dcision logout a remove. Prefira --api-key a partir de uma variável de ambiente ou o stdin a digitar uma key numa linha de comando que acaba no histórico do seu shell.
config
| Chave | Valores | Padrão |
|---|---|---|
api-url | A URL base da API | https://api.dcision.io |
output | pretty ou json | pretty |
dcision config set output json
dcision config get api-url
dcision config listdecide
dcision decide <slug> [--state <json> | --state-file <path> | --stdin] [--file <field>=<path>…] [--probabilities] [--idempotency-key <key>] [--json]| Opção | Descrição |
|---|---|
--state <json> | O estado em JSON: um objeto, um array para decisões de lista ou uma string entre aspas para decisões de texto — --state '"Hello"'. Texto simples é enviado como estado de texto. |
--state-file <path> | Lê o estado de um arquivo JSON. |
--stdin | Lê o estado da entrada padrão. |
--file <field>=<path> | Envia um arquivo num campo image, audio ou file — um caminho local (enviado em base64 com o seu nome, até 20 MB) ou uma URL https:// que a Dcision baixa. Pode ser repetido; junta-se ao objeto de --state ou forma o estado inteiro. Veja Entradas. |
--probabilities | Acrescenta a distribuição completa de cada pergunta (?include=probabilities). |
--idempotency-key <key> | Usa este Idempotency-Key. |
--json | Imprime a resposta bruta da API em vez da saída legível — incluindo scores, composites e as contagens de tokens em metrics. |
Passe o estado com um entre --state, --state-file ou --stdin, e/ou com flags --file.
O CLI lê um estado como JSON quando ele é um objeto, um array ou uma string JSON, então ele chama e checa decisões com um estado de objeto, de lista ou de texto: --state '["Hi!", "Can I get a quote for 50 seats?"]'. Qualquer outra coisa — texto simples, um número — é enviada como texto; um valor que começa com { mas não é JSON válido também é enviado como texto, com um aviso.
decide pode ser repetido com segurança: ele gera um Idempotency-Key quando você não passa um e tenta de novo uma vez em erros de rede com a mesma key, então uma resposta perdida é reproduzida em vez de rodar — e ser cobrada — duas vezes.
A saída legível mostra a decisão e a versão, a ação e o seu motivo, uma linha por pergunta com o resultado e a confiança, as distribuições com --probabilities, e a latência, o modelo, o custo estimado e o ID da execução. Use --json para níveis ponderados, composites e os destinos da resposta.
# Pipe states from another tool
jq -c '.lead' event.json | dcision decide lead-qualification --stdin --json
# Text decision
dcision decide spam-detection --state '"Congratulations! You won a gift card, click here."'
# Your own idempotency key, e.g. the record ID
dcision decide support-routing --state-file ticket.json --idempotency-key ticket-55120templates e init
dcision templates # lists the nineteen templates: id, name, description
dcision init # writes ./decision.json
dcision init lead.json --template lead-qualification # starts from a template
dcision init triage.json --template ticket-triage # a pattern template: speculative fan-out
dcision init lead.json --template lead-qualification --force # overwrites an existing fileOs ids dos templates são lead-qualification, support-routing, spam-detection, agent-routing, rag-relevance, ticket-triage, voice-banking, resume-screening, customer-service-router, input-guardrail, model-routing, document-reranking, tool-call-gating, reply-confidence-gate, response-grading, invoice-triage, voice-message-routing, image-moderation e llm-output-guardrail — veja Templates.
init escreve um decision schema — o mesmo JSON que o editor do app mostra em Schema da decisão. Sem --force, ele não sobrescreve um arquivo existente.
validate e check-state
dcision validate decision.json
dcision check-state decision.json --state '{"message":"Hi, can I get a demo?"}'
dcision check-state decision.json --state-file samples/lead-1.jsonOs dois rodam offline, com as mesmas regras do app e da API: validate relata cada problema do schema com o seu caminho — perguntas, entradas estruturadas, composites, políticas e as suas condições and, destinos — e resume um schema válido: o seu estado, as perguntas, o número de políticas e de destinos. check-state relata por que um estado seria rejeitado com 422 INVALID_STATE — estados de objeto, de texto e de lista igualmente. Use-os em CI para manter schemas e payloads de exemplo em sincronia com o seu código. O orçamento de tokens do engine, que também conta as perguntas, é checado pela API quando a decisão roda.
O CLI não cria nem publica decisões. Construa e publique-as no app; use init, validate e check-state para revisar e testar schemas no seu repositório.
Variáveis de ambiente
| Variável | Descrição |
|---|---|
DCISION_API_KEY | API key a usar — útil em CI, onde você não roda login. |
DCISION_API_URL | URL base da API. Padrão https://api.dcision.io. |
DCISION_WORKSPACE | Modo parceiro: roda dcision decide num sub-workspace (ext:<external_id>); --workspace tem precedência sobre ela. |
NO_COLOR | Desativa a saída colorida. |
Códigos de saída
| Código | Significado |
|---|---|
0 | Sucesso. |
1 | A validação falhou — um schema ou estado inválido. |
2 | Erro de uso — um comando desconhecido, um argumento faltando ou opções conflitantes. |
3 | Erro de API — a API respondeu com um erro. |
4 | Erro de rede — não foi possível alcançar a API. |
if ! dcision validate decision.json; then
echo "decision.json is invalid" >&2
exit 1
fiTime, papéis e conta
Organizações e workspaces, os papéis Proprietário, Admin, Membro e Leitor, convites, sair e transferir, excluir um workspace, senhas, sair de todos os dispositivos e idioma dos e-mails.
Segurança e dados
O que a Dcision guarda e por quanto tempo, para onde vai o seu estado — destinos incluídos —, como chaves, segredos e senhas são protegidos, papéis e isolamento de workspace, e como manter dados sensíveis de fora.