Дайте моделі факти та правило
Поле state містить контекст, спільний для питань. У ньому можна передати повідомлення та правила, за якими потрібно ухвалити рішення. Поле questions задає іменовані питання: їхні ідентифікатори допомагають пов’язати відповіді з логікою вашого застосунку.
Ключі варіантів Choice зручно робити стабільними: engineering, finance, logistics. Опис варіанта пояснює зміст, а ключ залишається частиною інтеграційного контракту. Зміна ключа потребуватиме узгодженої зміни коду, що обробляє результат.
{
"state": "Клієнт повідомляє: сторінка оплати показує помилку. Правило: збої сайту передавати технічній команді; питання про списані кошти — фінансовій; доставку — логістичній.",
"questions": {
"team": {
"type": "choice",
"instructions": "Яка команда має розглянути звернення за наведеним правилом?",
"criteria": {
"engineering": "Збій сайту або інтеграції",
"finance": "Списані кошти та рахунки",
"logistics": "Відправлення та доставка"
}
}
}
}Відокремте запит від зовнішньої дії
Надішліть JSON через POST /v1/systemone з API-ключем у заголовку Authorization: Bearer. Адресу сервісу та ключ тримайте у серверних змінних середовища. У прикладах документації показано HTTP-виклик; конкретний SDK для першої інтеграції не обов’язковий.
Отримання відповіді ще не означає, що звернення вже передано. Спочатку перевірте HTTP-статус і структуру даних, потім — наявність відповіді на потрібне питання. Лише після цього застосовуйте своє правило маршрутизації. Якщо виклик завершився помилкою, залиште звернення у доступній для обробки черзі.
Зробіть інтеграцію спостережуваною
Пов’язуйте виклик із внутрішнім ідентифікатором звернення, версією правила та обраною дією. Так можна розібрати окрему помилку, не змішуючи збій мережі з неправильним рішенням моделі. Якщо зберігаєте тексти у своїй системі, заздалегідь визначте необхідний обсяг і доступ до них.
Спочатку запустіть процес без автоматичної зміни маршруту: порівнюйте пропозицію API з рішенням оператора. Коли зрозумілі типові помилки, визначте правила автоматизації та ручної перевірки. Повторний HTTP-виклик і повторне виконання зовнішньої дії — різні події; захищайте свій застосунок від дублювання останньої.