Почніть з одного рішення
Візьмімо чергу підтримки. У зверненні клієнта є опис проблеми, але вашій системі потрібне конкретне наступне завдання: передати його технічній команді, фінансам або логістиці. Тут корисно заздалегідь визначити варіанти та критерії вибору.
У Shvydko це питання типу Choice. Ви передаєте повідомлення разом із правилами маршрутизації та описуєте кожен дозволений варіант. Результат можна використати у власній логіці розподілу. Сам API не переміщує звернення у вашій системі — цю дію виконує інтеграція.
Три форми відповіді
Форма залежить від наступної дії. Choice підходить для вибору категорії. Score — для впорядкованої шкали з описом кожного рівня. Noul — для оцінки ймовірності сформульованого твердження. В одному запиті можна поставити кілька питань до спільного контексту.
Наприклад, до звернення підтримки можна додати питання про вплив проблеми та потребу в перевірці людиною. Це окремі рішення: технічна категорія сама собою не означає максимальну терміновість. Описуйте їх окремо, щоб потім бачити, на якому кроці виникає помилка.
- Choice: якій команді передати звернення?
- Score: наскільки проблема перешкоджає оформленню замовлення?
- Noul: чи потребує звернення перевірки за заданим правилом?
Від Playground до інтеграції
Почніть із готового сценарію в Playground. Прочитайте контекст і критерії, замініть їх своїм прикладом та виконайте запит. Порівняйте відповідь із рішенням, яке ви очікуєте за власними правилами. Спробуйте також випадок із відсутніми або суперечливими даними.
Коли формат зрозумілий, створіть API-ключ робочого простору та перенесіть запит у свій серверний код. Зберігайте ключ поза браузером. Перед автоматизацією перевірте якість на окремій вибірці й визначте, які випадки мають потрапляти до людини.