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 API | https://api.dcision.io |
output | pretty или 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]| Опция | Описание |
|---|---|
--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-55120templates и 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 fileID шаблонов: 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_KEY | API-ключ для использования — удобно в 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Команда, роли и аккаунт
Организации и рабочие пространства, роли Владелец, Администратор, Участник и Наблюдатель, приглашения, выход и передача владения, удаление рабочего пространства, пароли, выход везде и язык писем.
Безопасность и данные
Что Dcision хранит и как долго, куда уходит ваше state — включая назначения, — как защищены ключи, секреты и пароли, роли и изоляция рабочих пространств и как не передавать чувствительные данные.