ДокументаціяТипи відповідей
Усі теми

SHVYDKO / Типи відповідей

Choice

Одна іменована категорія з ваших варіантів: команда, намір, маршрут або клас документа.

Опишіть категорії

criteria — об’єкт із 1–255 варіантів. Ключі — стабільні ідентифікатори для вашого коду, значення пояснюють зміст категорій. Назви мають бути унікальними в JSON-об’єкті.

Choice повертає рівно одну категорію. Для кількох незалежних ознак створіть кілька питань Noul; для впорядкованої шкали використайте Score.

Choice у повному запиті
{
  "state": "Оплата карткою не працює. Оплата при отриманні доступна. Клієнт просить допомогти оформити замовлення.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Якій команді передати звернення?",
      "criteria": {
        "engineering": "Збої сайту та платіжних інтеграцій",
        "logistics": "Доставка й отримання замовлень",
        "other": "Питання поза цими категоріями або недостатньо даних"
      }
    }
  }
}

Прочитайте choice і probabilities

answers.team.choice — ключ обраної категорії. probabilities містить числові оцінки для всіх ваших ключів; confidence — окремий показник упевненості від 0 до 1.

Для бізнес-дії використовуйте дозволений перелік ключів. Низька впевненість або категорія other можуть вести до ручного розгляду. Поріг підбирайте на власних розмічених даних.

Ілюстрація answers.team; не результат запуску
{
  "type": "choice",
  "choice": "engineering",
  "probabilities": {
    "engineering": 0.88,
    "logistics": 0.04,
    "other": 0.08
  },
  "confidence": 0.82
}

Значення probabilities та confidence не є гарантією правильності рішення.

Як зробити критерії корисними

  • Пишіть, що входить у кожну категорію, а не лише коротку назву.
  • Приберіть категорії з однаковим змістом або поясніть правило вибору між ними.
  • Додайте приклади на межі категорій до оцінювання, а не лише очевидні позитивні випадки.
  • Не змінюйте значення ідентифікаторів без оновлення коду, який обробляє відповідь.