CLI

Командная строка dcision — сохраните API-ключ, запускайте решения, смотрите шаблоны, создавайте и проверяйте схемы решений офлайн — с кодами выхода для скриптов и CI.

@dcision/cli устанавливает команду dcision. Используйте её, чтобы вызывать опубликованные решения из терминала или скрипта и хранить схемы решений в системе контроля версий с офлайн-проверкой.

Установка

Пока нет в npm

@dcision/cli не опубликован в npm. Соберите его из клона репозитория Dcision; пока на этой странице не сказано, что он опубликован, пакет с таким именем в npm не исходит от Dcision — не устанавливайте его, а уж тем более в 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

... после имени пакета сначала собирает пакеты, от которых зависит CLI. Без глобальной установки запускайте node packages/cli/dist/bin.js вместо dcision. Нужен Node.js 20 или новее.

Быстрый старт

# 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

Команды

КомандаОписание
dcision login [--api-key <key>] [--api-url <url>]Сохранить API-ключ — запрашивается, если не указан, читается из stdin при передаче через пайп.
dcision logoutУдалить сохранённый ключ.
dcision config listПоказать конфигурацию.
dcision config get <key>Вывести одну настройку.
dcision config set <key> <value>Изменить настройку: api-url или output.
dcision decide <slug> [options]Запустить опубликованное решение.
dcision templatesПоказать встроенные шаблоны.
dcision init [file] [--template <id>] [--force]Записать JSON схемы решения (по умолчанию ./decision.json).
dcision validate <file>Проверить схему решения офлайн.
dcision check-state <schema-file> (--state <json> | --state-file <path>)Проверить state по схеме офлайн.
dcision --version, dcision --helpВерсия и справка.

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

Ключ хранится в ~/.config/dcision/config.json с правами файла 600 (доступен для чтения только вам). dcision logout удаляет его. Передавайте --api-key из переменной окружения или через stdin, а не вводите ключ в командной строке, которая попадёт в историю оболочки.

config

КлючЗначенияПо умолчанию
api-urlБазовый URL APIhttps://api.dcision.io
outputpretty или 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]
ОпцияОписание
--state <json>State в виде JSON: объект, массив для решений со списком или строка в кавычках для текстовых решений — --state '"Hello"'. Обычный текст отправляется как текстовое state.
--state-file <path>Прочитать state из JSON-файла.
--stdinПрочитать state из стандартного ввода.
--file <field>=<path>Отправить файл в поле image, audio или file — локальный путь (отправляется в base64 с именем, до 20 МБ) или URL https://, который скачивает Dcision. Можно повторять; добавляется к объекту --state или составляет всё state. См. Входные данные.
--probabilitiesДобавить полное распределение каждого вопроса (?include=probabilities).
--idempotency-key <key>Использовать этот Idempotency-Key.
--jsonВывести сырой ответ API вместо удобочитаемого вывода — включая scores, composites и счётчики токенов в metrics.

Передайте state одной из опций --state, --state-file или --stdin и/или флагами --file.

CLI читает state как JSON, когда это JSON-объект, массив или строка, поэтому он вызывает и проверяет решения с объектом, списком или текстовым state: --state '["Hi!", "Can I get a quote for 50 seats?"]'. Всё остальное — обычный текст, число — отправляется как текст; значение, которое начинается с {, но не разбирается, тоже отправляется как текст, с предупреждением.

decide безопасно повторять: он генерирует Idempotency-Key, если вы его не передали, и один раз повторяет запрос при сетевых ошибках с тем же ключом, так что потерянный ответ воспроизводится, а не выполняется — и не оплачивается — дважды.

Удобочитаемый вывод показывает решение и версию, действие и его причину, по строке на вопрос с результатом и уверенностью, распределения с --probabilities, а также задержку, модель, оценку стоимости и ID выполнения. Используйте --json для взвешенных уровней, composites и назначений ответа.

# 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 и 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

ID шаблонов: 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 и llm-output-guardrail — см. Шаблоны.

init записывает схему решения — тот же JSON, который редактор приложения показывает в разделе Схема решения. Без --force он не перезаписывает существующий файл.

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

Обе команды работают офлайн, по тем же правилам, что приложение и API: validate сообщает о каждой проблеме схемы с её путём — вопросы, структурированные записи, composites, политики и их условия and, назначения — и кратко описывает корректную схему: её state, вопросы, число политик и назначений. check-state сообщает, почему state было бы отклонено с 422 INVALID_STATE, — для object, text и list state одинаково. Используйте их в CI, чтобы схемы и примеры данных оставались синхронизированы с вашим кодом. Бюджет токенов движка, в котором учитываются и вопросы, проверяется API при запуске решения.

CLI не создаёт и не публикует решения. Создавайте и публикуйте их в приложении; используйте init, validate и check-state, чтобы просматривать и тестировать схемы в своём репозитории.

Переменные окружения

ПеременнаяОписание
DCISION_API_KEYAPI-ключ для использования — удобно в CI, где вы не запускаете login.
DCISION_API_URLБазовый URL API. По умолчанию https://api.dcision.io.
DCISION_WORKSPACEРежим партнёра: запускать dcision decide в подпространстве (ext:<external_id>); --workspace переопределяет его.
NO_COLORОтключить цветной вывод.

Коды выхода

КодЗначение
0Успех.
1Проверка не пройдена — некорректная схема или state.
2Ошибка использования — неизвестная команда, отсутствующий аргумент или конфликтующие опции.
3Ошибка API — API ответил ошибкой.
4Сетевая ошибка — не удалось связаться с API.
if ! dcision validate decision.json; then
  echo "decision.json is invalid" >&2
  exit 1
fi

На этой странице