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

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

Score

Числова оцінка на шкалі, рівні якої ви пояснюєте словами.

Задайте впорядковану шкалу

criteria — масив із 1–255 описів у порядку від першого рівня до останнього. Індекси починаються з 0. Для трьох критеріїв результат лежить у межах 0–2.

Опишіть спостережувану різницю між рівнями. Для терміновості це може бути вплив на роботу та наявність обхідного способу; для релевантності — відповідність конкретному запиту.

Score у повному запиті
{
  "state": "Оплата карткою не працює. Оплата при отриманні доступна. Клієнт просить допомогти оформити замовлення.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "Оціни терміновість звернення за наведеними рівнями.",
      "criteria": [
        "Інформаційне питання; нічого не заблоковано",
        "Є незручність, але доступний інший спосіб завершити дію",
        "Дію повністю заблоковано; потрібна оперативна допомога"
      ]
    }
  }
}

Score може бути дробовим

score — оцінка позиції на шкалі, а не текстова назва рівня. probabilities використовує строкові ключі індексів: «0», «1», «2». confidence повертається окремо. Сервіс також повертає legend — описи рівнів за їхніми індексами.

Вирішіть у своєму коді, чи потрібен безперервний бал, округлений рівень або порогове рішення. Не перетворюйте score на відсоток імовірності: шкала визначається вашими критеріями.

Ілюстрація answers.urgency; не результат запуску
{
  "type": "score",
  "score": 1.1,
  "probabilities": {
    "0": 0.05,
    "1": 0.8,
    "2": 0.15
  },
  "legend": {
    "0": "Інформаційне питання; нічого не заблоковано",
    "1": "Є незручність, але доступний інший спосіб завершити дію",
    "2": "Дію повністю заблоковано; потрібна оперативна допомога"
  },
  "confidence": 0.7
}

Порівнюйте на однаковій шкалі

Для ранжування кількох записів застосовуйте ті самі instructions і criteria. Якщо ви зміните кількість або зміст рівнів, попередні й нові оцінки більше не будуть прямо порівнюваними.

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