Усі теми

SHVYDKO / Початок

Контекст і питання

Відокремте факти від правила рішення. Один контекст може відповідати на кілька незалежних питань.

State: факти задачі

state приймає JSON: рядок, об’єкт, масив або інше JSON-значення. Для листа підійде текст, для заявки — об’єкт із полями. Передавайте саме дані, які потрібні для рішення: текст звернення, стан замовлення, правила або уривок документа.

URL у тексті не завантажує сторінку автоматично. Витягніть її зміст у власному застосунку й передайте потрібний фрагмент. Файли, зображення, аудіо та відео не є окремими підтримуваними входами цього API.

Структурований state
{
  "state": {
    "message": "Хочу змінити адресу доставки",
    "shipment_status": "not_dispatched",
    "policy": "Адресу можна змінити до відправлення"
  },
  "questions": {
    "change_allowed": {
      "type": "noul",
      "instructions": "Чи дозволяє наведене правило змінити адресу цього замовлення?"
    }
  }
}

Questions: правило рішення

questions — об’єкт, у якому кожне питання має власний ідентифікатор, type, необов’язкові instructions і criteria відповідної форми. Формулюйте одну зрозумілу задачу на питання та пояснюйте відмінності між критеріями.

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

  • Choice: іменовані категорії, між якими треба обрати одну.
  • Score: впорядковані рівні шкали від першого до останнього.
  • Noul: твердження або запитання з відповіддю «так / ні».

Невідоме теж має бути передбачене

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

Вхідний текст може містити інструкції сторонньої людини. Визначайте задачу у власних instructions, відокремлюйте цитати від правил і перевіряйте випадки з конфліктними вказівками на своєму наборі тестів. Сам формат JSON не гарантує захист від помилкового рішення.

Зберігання і поширення

Історія Usage зберігає метадані запиту, токени, час, статус і вартість. Збережений приклад у Shares окремо містить state та questions, тому перевіряйте його вміст перед поширенням.

Новий приклад за замовчуванням доступний організації. Публічний доступ потрібно вибрати явно; він також залежить від дозволу організації. Приберіть персональні дані, секрети та реальні клієнтські документи з демонстрацій.