# Decisions API

Source: https://provod.ai/ru/docs/decisions

Jev от TypeSafe отвечает на конкретные вопросы о данных: выбирает категорию, оценивает условие или выставляет оценку. Результат содержит типизированные значения и вероятности. Для обычного диалога выберите текстовую модель.

## Выбрать модель

Откройте [каталог моделей](/ru/models?category=decision) и вкладку **Decisions**. Доступность, цена, контекст и поддерживаемые возможности указаны в каталоге. Jev появляется после подключения модели; приведённый ниже ID используйте только если он доступен в вашем рабочем пространстве.

В кабинете откройте **Чат → выбор модели → Decisions → Jev**. Заполните контекст и вопросы, затем нажмите кнопку запуска. Выбор другой модели возвращает обычный чат и сохраняет его историю. Сам выбор модели не отправляет платный запрос.

## Первый запрос

Используйте свой [API-ключ](/ru/docs/authentication) с разрешением на инференс и доступом к выбранной модели. Сохраните тело в `decision.json` и выполните команду:

```bash
export PROVOD_API_KEY="sk_..."

curl --fail-with-body --silent --show-error https://api.provod.ai/api/alpha/decisions \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @decision.json
```

```json
{
  "model": "typesafe/jev-1.14",
  "state": {"order": 1042, "paid": true},
  "questions": {
    "paid": {"type": "noul", "instructions": "The order is paid."},
    "action": {
      "type": "choice",
      "instructions": "Choose the next action.",
      "criteria": {"ship": null, "request_payment": null}
    },
    "priority": {
      "type": "score",
      "instructions": "Rate delivery urgency.",
      "criteria": ["Normal", "Urgent"]
    }
  }
}
```

## Типы вопросов

| Тип      | Что передать                                                | Как прочитать ответ                                                                          |
| -------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `noul`   | Условие в `instructions`                                    | `noul`: вероятность выполнения условия от 0 до 1, не Boolean                                 |
| `choice` | Объект `criteria`: ключи вариантов и их описания или `null` | `choice`: ключ выбранного варианта                                                           |
| `score`  | Упорядоченный массив `criteria`                             | `score`: позиция на шкале от 0 до количества уровней минус 1; значение может быть дробным    |
| `box`    | Описание объекта на изображении                             | Поддерживается через [System One](/ru/docs/system-one) при наличии этой возможности у модели |

`state` принимает строку, объект или массив JSON. `questions` содержит именованные вопросы; эти же имена будут ключами в `answers`. В Decisions API поле `instructions` обязательно для каждого вопроса. Для Choice нужен хотя бы один вариант, для Score хотя бы один уровень. Допустимые размеры и число вариантов зависят от возможностей модели.

## Ответ

Иллюстративный ответ: вероятности и количество токенов будут отличаться в реальном запросе.

```json
{
  "model": "typesafe/jev-1.14",
  "answers": {
    "paid": {"type": "noul", "noul": 0.99},
    "action": {
      "type": "choice", "choice": "ship", "confidence": 0.98,
      "probabilities": {"ship": 0.99, "request_payment": 0.01}
    },
    "priority": {
      "type": "score", "score": 0.1, "confidence": 0.8,
      "probabilities": {"0": 0.9, "1": 0.1},
      "legend": {"0": "Normal", "1": "Urgent"}
    }
  },
  "usage": {"input_tokens": 120, "output_tokens": 0}
}
```

`confidence`, `probabilities` и `legend` могут отсутствовать в Decisions API. Порог принятия решения задаёт ваше приложение. Вероятность не гарантирует правильность ответа.

## Форматы и ограничения

| Формат        | Путь                        | Вход                                                                            |
| ------------- | --------------------------- | ------------------------------------------------------------------------------- |
| Decisions API | `POST /api/alpha/decisions` | Текст и JSON; изображения только при подтверждённой поддержке профилем маршрута |
| System One    | `POST /v1/systemone`        | Текст и JSON; PNG/JPEG при поддержке моделью                                    |

Используйте `Content-Type: application/json`. Потоковая выдача, `messages`, `temperature`, `tools` и `max_tokens` для этих запросов не поддерживаются. Поддержка изображений и Box в Decisions API зависит от опубликованных и проверенных возможностей выбранного маршрута; не переносите поддержку между протоколами. Для формата `assets` с PNG/JPEG используйте [System One](/ru/docs/system-one) и модель с подтверждённой поддержкой изображений.

## Стоимость и повторные запросы

Актуальная цена за миллион входных и выходных токенов указана в каталоге. Несколько вопросов могут увеличивать учитываемый объём входа; ориентируйтесь на `usage.input_tokens`, а не только на длину `state`. При запуске баланс временно резервируется, после ответа учитывается фактическое использование.

В ответе API возвращаются `usage.input_tokens` и `usage.output_tokens`; поле `usage.cost` не выдаётся. Фактическое списание смотрите в [использовании](/ru/docs/usage-costs) или результате запуска в кабинете, в валюте вашего баланса.

Ошибки возвращаются в [общем формате API](/ru/docs/errors). Исправьте некорректные вопросы или недоступные возможности перед повтором. После обрыва соединения сначала проверьте использование: повторная отправка может создать ещё один платный запрос.

## Решение проблем


**Почему модель недоступна?**


Проверьте выбранное рабочее пространство, доступ к модели и баланс. Если Jev отсутствует в каталоге Decisions, он пока не подключён для вашего доступа.


**Что делать после тайм-аута?**


Сначала проверьте [использование](/ru/docs/usage-costs) за время запроса. Отсутствие ответа не означает отсутствие списания. Повторную отправку запускайте осознанно.
