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 --version

O ... 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 --json

Comandos

ComandoDescriçã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 logoutRemove a key guardada.
dcision config listMostra 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 templatesLista 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 --helpVersã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 URL

A 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

ChaveValoresPadrão
api-urlA URL base da APIhttps://api.dcision.io
outputpretty ou jsonpretty
dcision config set output json
dcision config get api-url
dcision config list

decide

dcision decide <slug> [--state <json> | --state-file <path> | --stdin] [--file <field>=<path>…] [--probabilities] [--idempotency-key <key>] [--json]
OpçãoDescriçã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.
--stdinLê 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.
--probabilitiesAcrescenta a distribuição completa de cada pergunta (?include=probabilities).
--idempotency-key <key>Usa este Idempotency-Key.
--jsonImprime 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-55120

templates 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 file

Os 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.json

Os 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ávelDescrição
DCISION_API_KEYAPI key a usar — útil em CI, onde você não roda login.
DCISION_API_URLURL base da API. Padrão https://api.dcision.io.
DCISION_WORKSPACEModo parceiro: roda dcision decide num sub-workspace (ext:<external_id>); --workspace tem precedência sobre ela.
NO_COLORDesativa a saída colorida.

Códigos de saída

CódigoSignificado
0Sucesso.
1A validação falhou — um schema ou estado inválido.
2Erro de uso — um comando desconhecido, um argumento faltando ou opções conflitantes.
3Erro de API — a API respondeu com um erro.
4Erro 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
fi

Nesta página