CLI

La línea de comandos dcision — guarda una clave de API, ejecuta decisiones, lista plantillas, crea y valida schemas de decisión sin conexión — con códigos de salida para scripts y CI.

@dcision/cli instala el comando dcision. Úsalo para llamar decisiones publicadas desde una terminal o un script, y para mantener los schemas de decisión en control de versiones con validación sin conexión.

Instalación

Aún no está en npm

@dcision/cli no está publicado en npm. Compílalo desde un checkout del repositorio de Dcision; hasta que esta página diga que está publicado, un paquete con este nombre en npm no proviene de Dcision — no lo instales, y menos aún en 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

Los ... después del nombre del paquete compilan primero los paquetes de los que depende el CLI. Sin instalarlo globalmente, ejecuta node packages/cli/dist/bin.js en lugar de dcision. Requiere Node.js 20 o superior.

Inicio 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

ComandoDescripción
dcision login [--api-key <key>] [--api-url <url>]Guarda una clave de API — la pide cuando se omite y la lee de stdin cuando llega por pipe.
dcision logoutElimina la clave guardada.
dcision config listMuestra la configuración.
dcision config get <key>Imprime un ajuste.
dcision config set <key> <value>Cambia un ajuste: api-url u output.
dcision decide <slug> [options]Ejecuta una decisión publicada.
dcision templatesLista las plantillas incluidas.
dcision init [file] [--template <id>] [--force]Escribe un JSON de schema de decisión (por defecto ./decision.json).
dcision validate <file>Valida un schema de decisión sin conexión.
dcision check-state <schema-file> (--state <json> | --state-file <path>)Valida un state contra un schema sin conexión.
dcision --version, dcision --helpVersión y ayuda.

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

La clave se guarda en ~/.config/dcision/config.json con modo de archivo 600 (solo tú puedes leerlo). dcision logout la elimina. Prefiere --api-key desde una variable de entorno o stdin antes que escribir una clave en una línea de comandos que termine en el historial de tu shell.

config

ClaveValoresPor defecto
api-urlLa URL base de la APIhttps://api.dcision.io
outputpretty o 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]
OpciónDescripción
--state <json>El state como JSON: un objeto, un array para decisiones de lista o un string entre comillas para decisiones de texto — --state '"Hello"'. El texto plano se envía como un state de texto.
--state-file <path>Lee el state de un archivo JSON.
--stdinLee el state de la entrada estándar.
--file <field>=<path>Envía un archivo en un campo image, audio o file — una ruta local (enviada en base64 con su nombre, hasta 20 MB) o una URL https:// que Dcision descarga. Repetible; se une al objeto de --state o forma el state completo. Consulta Entradas.
--probabilitiesAgrega la distribución completa de cada pregunta (?include=probabilities).
--idempotency-key <key>Usa esta Idempotency-Key.
--jsonImprime la respuesta cruda de la API en lugar de la salida legible — incluidos scores, composites y los conteos de tokens en metrics.

Pasa el state con una de --state, --state-file o --stdin, y/o con flags --file.

El CLI lee un state como JSON cuando es un objeto, un array o un string JSON, así que llama y verifica decisiones con un state de objeto, de lista o de texto: --state '["Hi!", "Can I get a quote for 50 seats?"]'. Cualquier otra cosa — texto plano, un número — se envía como texto; un valor que empieza con { pero no se puede parsear también se envía como texto, con una advertencia.

decide es seguro de reintentar: genera una Idempotency-Key cuando no pasas una y reintenta una vez ante errores de red con la misma clave, así que una respuesta perdida se reproduce en lugar de ejecutarse — y facturarse — dos veces.

La salida legible muestra la decisión y la versión, la acción y su motivo, una fila por pregunta con su resultado y confianza, las distribuciones con --probabilities, y la latencia, el modelo, el costo estimado y el ID de ejecución. Usa --json para los niveles ponderados, los compuestos y los destinos de la respuesta.

# 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

Los ids de las plantillas son 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 y llm-output-guardrail — consulta Plantillas.

init escribe un schema de decisión — el mismo JSON que el editor de la app muestra en Schema de la decisión. Sin --force, no sobrescribe un archivo existente.

validate y 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

Ambos se ejecutan sin conexión, con las mismas reglas que la app y la API: validate informa cada problema del schema con su ruta — preguntas, entradas estructuradas, compuestos, políticas y sus condiciones and, destinos — y resume un schema válido: su state, sus preguntas, el número de políticas y de destinos. check-state informa por qué un state sería rechazado con 422 INVALID_STATE — tanto states de objeto como de texto y de lista. Úsalos en CI para mantener los schemas y los payloads de ejemplo sincronizados con tu código. El presupuesto de tokens del motor, que también cuenta las preguntas, lo verifica la API cuando se ejecuta la decisión.

El CLI no crea ni publica decisiones. Créalas y publícalas en la app; usa init, validate y check-state para revisar y probar schemas en tu repositorio.

Variables de entorno

VariableDescripción
DCISION_API_KEYClave de API a usar — útil en CI, donde no ejecutas login.
DCISION_API_URLURL base de la API. Por defecto https://api.dcision.io.
DCISION_WORKSPACEModo Socio: ejecuta dcision decide en un subespacio (ext:<external_id>); --workspace lo sobrescribe.
NO_COLORDesactiva la salida con colores.

Códigos de salida

CódigoSignificado
0Éxito.
1Falló la validación — un schema o un state inválido.
2Error de uso — un comando desconocido, un argumento faltante u opciones en conflicto.
3Error de la API — la API respondió con un error.
4Error de red — no se pudo contactar con la API.
if ! dcision validate decision.json; then
  echo "decision.json is invalid" >&2
  exit 1
fi

En esta página