TypeSafe Decisions

Используйте Jev для проверки условий, классификации, оценки и выбора инструментов.

Decisions использует Jev для оценки текста или бизнес-состояния и возвращает ответы, которые можно читать непосредственно в коде. API синхронно возвращает JSON и не поддерживает потоковые ответы.

POST/v1/decisions

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте API Key, выданный текущим сайтом.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели решений, доступной на текущем сайте.

state*string||array<unknown>

Содержимое или бизнес-состояние для оценки. Все вопросы в одном запросе используют общий state.

questions*

Непустое отображение вопросов. Каждый ключ — пользовательский ID вопроса; ответы возвращаются с теми же ID.

Поля1 <= properties

stream?false

Пропустите или задайте false. API не поддерживает stream: true.

Допустимые значения

false

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/decisions" \  -H "Authorization: Bearer your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "jev-1.13.0",    "state": "My subscription was charged twice. Please refund the duplicate charge.",    "questions": {      "ticket": {        "type": "noul",        "instructions": "Does the customer explicitly request a refund?",        "criteria": {          "true": "The message explicitly asks for a refund.",          "false": "The message does not ask for a refund."        }      }    }  }'

{
  "model": "jev-1.13.0",
  "answers": {
    "ticket": {
      "type": "noul",
      "noul": 0.99
    }
  },
  "usage": {
    "input_tokens": 319,
    "output_tokens": 20
  }
}

Примеры запросов

В следующих примерах используется jev-1.13.0. Выберите сценарий вопроса и язык программирования, чтобы скопировать соответствующий запрос.

Определить, запрошен ли возврат средств

curl --request POST 'https://api.agtcloud.cn/v1/decisions' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "jev-1.13.0",
  "state": "My subscription was charged twice. Please refund the duplicate charge.",
  "questions": {
    "ticket": {
      "type": "noul",
      "instructions": "Does the customer explicitly request a refund?",
      "criteria": {
        "true": "The message explicitly asks for a refund.",
        "false": "The message does not ask for a refund."
      }
    }
  }
}'

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

Тип	Назначение	Возвращаемые поля
`noul`	Определить, выполняется ли условие, например просит ли клиент возврат средств	`noul`: вероятность выполнения условия
`choice`	Выбрать категорию или действие из вариантов, например отдел обработки обращения	`choice`, `probabilities`, `confidence`
`score`	Оценить по упорядоченным критериям, например срочность обращения	`score`, `legend`, `probabilities`, `confidence`

Передайте оцениваемое содержимое в state, а вопросы и критерии — в questions. Запрос может содержать несколько вопросов и сочетать три типа; все вопросы используют один и тот же state.

Чтение результатов

answers использует те же идентификаторы вопросов, что и questions. Например, для вопроса с ID ticket ответ читается из answers.ticket.

Проверка условия: Прочитайте noul. Значения находятся в диапазоне 0–1: близость к 1 указывает на склонность к истине, к 0 — к ложности. Выберите порог решения с учётом бизнес-задачи.
Классификация: Прочитайте choice для получения имени выбранного варианта, а probabilities — для вероятностей каждого варианта.
Оценка: Прочитайте score. Уровни нумеруются с 0 по позиции в массиве criteria; три уровня соответствуют 0–2, оценка может быть дробной. legend сопоставляет номера уровней с их описаниями.

Для choice и score поле confidence отражает определённость распределения вероятностей, а не правильность ответа. Вероятности, оценки и расход Token зависят от запроса.

При выборе инструмента choice возвращает имя действия, например lookup_payment. Приложение выполняет последующую операцию по этому имени; сам запрос решения не выполняет инструменты и не генерирует OpenAI tool_calls.

Расход Token и стоимость

usage.input_tokens и usage.output_tokens отражают расход входных и выходных Token соответственно. Jev тарифицирует только входные Token; выходные Token не оплачиваются. Несколько вопросов и описания вариантов также влияют на расход входных Token. Актуальные цены доступны в Каталоге моделей.

200application/json

400application/json

422application/json

`application/json`

`application/json`

`application/json`