Документація
Документація
Навчання
Релізи
  • English
  • Українська
Документація
Навчання
Релізи
  • English
  • Українська
  • Головна

    • Документація ConnectiveOne
    • Як користуватися порталом Service Desk
  • Підключення каналів

    • Канали (Channels)

      • Інтегратор — Хаб налаштування каналів
      • Інструкції

        • Як налаштувати віджет в Налаштування
        • Як підключити Facebook Messenger та Instagram до ConnectiveOne
        • Як підключити Gmail до ConnectiveOne
        • Як підключити Outlook до ConnectiveOne
        • Як підключити Telegram до ConnectiveOne
        • Як підключити номерні Viber, Telegram та WhatsApp через e-chat
        • Як підключити Viber до ConnectiveOne
        • Як підключити WhatsApp до ConnectiveOne
        • Як кастомізувати кольори віджету
        • Як керувати віджетом з сайту
        • Як передати параметри з сайту до сценарію
        • Як налаштувати відправку SMS через Alpha SMS
        • Як налаштувати відправку Viber/SMS через Infobip
        • Як підключити віджет на сайт
        • Як використовувати Custom Code для віджету
        • Як працювати з віджетом на SPA додатках
  • Обробка звернень

    • Операторська панель (OperatorLine)

      • Оператор — Хаб сценаріїв для Операторської панелі
      • Супервайзер — Хаб сценаріїв для Операторської панелі
      • Адміністратор — Хаб сценаріїв для Операторської панелі
      • Інтегратор — Хаб операторської панелі
      • Пояснення

        • Про обробку звернень в ConnectiveOne
        • Що таке фільтри та навіщо вони потрібні
        • Про авторозподіл діалогів між операторами
        • Про автоматичне підключення вільного оператора до нового діалогу
        • Відображення контенту Instagram у діалогах
        • Про підключення чату з оператором через операторську панель
        • Підтримка зображень HEIC/HEIF (фото з iPhone)
        • Про перерозподіл чатів з оператора
      • Інструкції

        • Змінити статус звернення
        • Створити фільтр
        • Створити папку
        • Створити вихідне звернення
        • Як створити тікет?
        • Як завантажити вкладення з діалогу?
        • Як експортувати діалог у PDF?
        • Як прив'язати тікети між собою?
        • Управляти папками
        • Як редагувати поля тікету?
        • Як керувати спостерігачами тікету?
        • Відстежувати статуси операторів
        • Моніторинг черги та аудит розподілу
        • Відкрити звернення
        • Переставити папки
        • Як відповісти клієнту?
        • Позначити тему та теги
        • Використати копілот
        • Використати швидкі відповіді
        • Переглянути список чатів
        • Переглянути чати у таблиці
        • Переглянути оцінку якості діалогу
        • Переглянути чергу звернень
        • Як переглянути логи тікету?
        • Як переглянути SLA метрики тікету?
    • Профіль (Profile)

      • Оператор — Хаб сценаріїв для Profile
      • Адміністратор — Хаб сценаріїв для Profile
      • Інструкції

        • Як змінити мову інтерфейсу?
        • Налаштувати папки
        • Налаштувати сповіщення
        • Налаштувати налаштування звернень у профілі
        • Налаштувати швидкі відповіді
        • Налаштувати підпис
    • Клієнти (BroadcastUsers)

      • Оператор — Хаб сценаріїв для BroadcastUsers
      • Інтегратор — Хаб сценаріїв для BroadcastUsers
      • Адміністратор — Хаб сценаріїв для BroadcastUsers
      • Пояснення

        • Чому в одного клієнта багато каналів?
        • Розділи картки клієнта
      • Інструкції

        • Створити сегмент за фільтрами
        • Редагувати дані клієнта
        • Експортувати дані клієнтів
        • Відфільтрувати клієнтів
        • Як керувати підпискою на розсилки?
        • Як знайти та об'єднати схожі контакти
        • Як знайти клієнта?
        • Шукати клієнтів за файлом
        • Надіслати розсилку обраним клієнтам
        • Як переглянути картку клієнта?
        • Переглянути канали клієнта
  • Розсилки

    • Розсилки (Broadcast)

      • Оператор — Хаб розсилок для Broadcast
      • Інтегратор — Хаб налаштувань для Broadcast
      • Аналітик — Хаб аналітики для Broadcast
      • Інструкції

        • Як активувати заплановану розсилку?
        • Як перевірити статус розсилки?
        • Як налаштувати ліміти розсилок?
        • Як створити розсилку?
        • Як створити тему розсилки?
        • Як деактивувати тему розсилки?
        • Як редагувати чернетку розсилки?
        • Як редагувати тему розсилки?
        • Як експортувати результати розсилки в Excel?
        • Як запустити розсилку негайно?
        • Як зберегти розсилку як чернетку?
        • Як переглянути результати розсилки?
        • Як переглянути статистику кліків?
        • Як переглянути статистику доставок?
        • Як переглянути статистику відкриттів?
  • Автоматизація

    • Scenario Builder

      • Scenario Builder — Хаб для інтеграторів
      • Інструкції

        • Як додати переклади до сценарію в Scenario Builder
        • Як налаштувати сценарій для подій Instagram у Scenario Builder
        • Як налаштувати обробку відміток у сторіс Instagram
        • Як налаштувати підключення оператора до коментарів Instagram
        • Як створити новий сценарій бота в Scenario Builder
        • Як створити секцію сценарію в Scenario Builder
        • Як редагувати сценарій в Scenario Builder
        • Як знайти ноду на полотні в Scenario Builder
        • Як експортувати та імпортувати сценарій в Scenario Builder
        • Як протестувати сценарій в Scenario Builder
        • Як використати action в сценарії Scenario Builder
        • Як переглянути історію версій сценарію в Scenario Builder
    • Scenario Dialog (Legacy)

      • Інтегратор — Хаб сценаріїв для Scenario Dialog (Legacy)
      • Пояснення

        • Actions в сценаріях — що це та як працюють
        • Про використання action autobroadcast__create у сценаріях
        • Про копіювання сценарію існуючого бота
        • Про інтеграцію ConnectiveOne з Corezoid через операторську панель
        • Про виведення зображень користувачу
        • Про категоризацію листів з пошти за допомогою AI
        • Про реферальні мітки з реклами Facebook
        • Про запуск сценарію з реклами на Facebook
        • Про HTML форматування тексту в Telegram та Widget
        • Про інлайн-клавіатуру в Telegram та Widget
        • Про налаштування alias при вихідному діалозі
        • Про оплату через бот
        • Про ботів для груп Telegram
        • Стилізація кнопок клавіатури в Telegram
        • Про Telegram WebApp у сценаріях
        • Про стилізацію клавіатури у Viber
        • Про стартове повідомлення у Viber
      • Інструкції

        • Як додати переклади до сценарію?
        • Як створити новий сценарій бота?
        • Як створити секцію сценарію?
        • Як редагувати існуючий сценарій бота?
        • Як експортувати або імпортувати сценарій?
        • Як використати action в сценарії?
        • Як переглянути та відновити версії сценарію?
    • Action Jail

      • Оператор — Хаб сценаріїв для ActionJail
      • Пояснення

        • Секції редактора дій ActionJail
        • Про те, як дані з Action Jail потрапляють у Scenario Builder
      • Інструкції

        • Як створити кастомну дію в Action Jail
        • Як створити й підтримувати дію в ActionJail (Адміністратор)
        • Налаштування AI-генератора в ActionJail (Адміністратор)
        • Як клонувати дію в ActionJail
        • Як швидко знайти дію в ActionJail
        • Як підключити дію ActionJail до сценарію бота (Інтегратор)
    • Інтеграції

      • Інтегратор — Хаб інтеграцій ConnectiveOne
      • Інструкції

        • Як інтегрувати операторську панель як віджету в CRM/ERP
        • Як налаштувати назву продукту для Zoho CRM
        • Як інтегрувати зовнішню систему через Custom Channel
        • Як отримати дані з API за допомогою send_request
        • Як передати дані з ConnectiveOne через send_request
        • Як налаштувати підписку користувача на нотифікації
        • Як запустити сценарій бота через API call_node
        • Як інтегрувати ConnectiveOne з eSputnik
        • Як надіслати розсилку по телефону через route
        • Як використовувати API ConnectiveOne
        • Як налаштувати webhook панелі оператора
      • Довідник

        • API Reference — Довідник по API ConnectiveOne
    • Користувацькі дані (CustomData)

      • Інтегратор — Custom Data
      • Адміністратор — Хаб сценаріїв для Custom Data
      • Аналітик — Хаб сценаріїв для Custom Data
      • Пояснення

        • Про Custom Data в ConnectiveOne
        • Патерни та приклади Custom Data
        • Складні кейси Custom Data
      • Інструкції

        • Додати поле до моделі
        • Налаштувати тип поля
        • Створити групу
        • Як створити модель даних?
        • Редагувати модель
        • Експортувати відфільтровані дані
        • Як експортувати дані моделі?
        • Як знайти записи за фільтрами?
        • Імпортувати дані з файлу
        • Сортувати записи
        • Валідувати дані
        • Переглянути записи моделі
      • Довідник

        • Довідник розширених налаштувань моделей Custom Data
    • Менеджер файлів (FileManager)

      • Оператор — Хаб сценаріїв для FileManager
      • Інструкції

        • Як створити завдання в Jira з файлом?
        • Як видалити файл або папку?
        • Як перейти в папку?
        • Як завантажити новий файл?
        • Як переглянути список файлів?
  • Штучний інтелект

    • Fast Line Pro (FastLinePro)

      • Інтегратор — Хаб сценаріїв для FastLinePro
      • Адміністратор — Хаб сценаріїв для FastLinePro
      • Інструкції

        • Активувати KB Plugin
        • Як перевірити відповідь AI-агента в сценарії?
        • Перевірити статус синхронізації
        • Налаштувати промпт агента
        • Як налаштувати змінні агента в FastLinePro?
        • Як налаштувати фрагментацію в базі знань FastLinePro?
        • Налаштувати синхронізацію KB Plugin
        • Налаштувати синхронізацію знань
        • Як підключити базу знань до AI-агента в FastLinePro?
        • Створити агента
        • Як створити чат-бота FastLinePro?
        • Як створити базу знань?
        • Деактивувати KB Plugin
        • Як згенерувати ключ Gemini для FastLine Pro
        • Як підготувати файл для бази знань FastLinePro?
        • Запустити синхронізацію KB
        • Оновити файли KB
        • Завантажити файли до KB
        • Як використати дію action_fastline_pro в сценарії?
    • Контроль якості (Quality Assurance)

      • Супервайзер — Хаб сценаріїв для Quality Assurance
      • Адміністратор — Хаб сценаріїв для Quality Assurance
      • Аналітик — Хаб сценаріїв для Quality Assurance
      • Пояснення

        • Як налаштувати чеклист AI QA для якісної оцінки діалогів
      • Інструкції

        • Як корегувати AI-оцінки критеріїв?
        • Як затвердити оцінку?
        • Оцінити звернення
        • Провести перевірку якості
        • Як створити нову оцінку діалогу?
        • Експортувати оцінки
        • Фільтрувати оцінки
        • Використати чеклист
        • Переглянути деталі оцінки
        • Як переглянути список оцінок та знайти потрібну?
        • Переглянути дашборд якості
        • Переглянути звіти якості
  • Статистика

    • Статистика (Statistics)

      • Супервайзер — Хаб сценаріїв для Statistics
      • Адміністратор — Хаб сценаріїв для Statistics
      • Аналітик — Хаб сценаріїв для Statistics
      • Інструкції

        • Застосувати фільтри до звіту
        • Як налаштувати CSAT (задоволеність клієнтів) в Statistics?
        • Як створити та налаштувати воронку в Statistics?
        • Створити детальний звіт
        • Створити воронку
        • Експортувати звіт
        • Як експортувати дані статистики?
        • Налаштувати цільові метрики
        • Переглянути щоденний звіт
        • Переглянути дашборд
        • Як переглянути дашборди Metabase в модулі Statistics?
        • Як переглянути робочий графік оператора в Statistics?
        • Переглянути змінний звіт
      • Довідник

        • Метрики статистики — довідник
  • Адміністрування

    • Constructor

      • Constructor — головний екран і навігація
      • Інструкції

        • Як користуватися головним екраном Constructor?
    • Налаштування

      • Супервайзер — Хаб налаштувань операторської панелі
      • Адміністратор — Хаб налаштувань системи
      • Інструкції

        • Як активувати або деактивувати бота?
        • Як налаштувати автентифікацію та управління доступом?
        • Як налаштувати бота?
        • Як налаштувати параметри чатів?
        • Як налаштувати відображення полів у картці клієнта?
        • Як налаштувати поля клієнтів?
        • Як налаштувати шаблони email (хедер і футер)?
        • Як налаштувати параметри файлів?
        • Як налаштувати гарячі клавіші?
        • Як налаштувати параметри інстансу?
        • Як налаштувати операторів у чатах?
        • Як налаштувати ролі та права доступу?
        • Як налаштувати стилі та скрипти?
        • Як налаштувати загальні налаштування системи?
        • Як налаштувати параметри тікетів?
        • Як налаштувати таймери для чатів?
        • Як налаштувати поля користувачів?
        • Як створити нового бота?
        • Як переглянути список ботів?
        • Як переглянути список користувачів?
    • Доступ

      • Відновлення доступу — Хаб сценаріїв
      • Інструкції

        • Як увімкнути потік відновлення пароля (Адміністратор)
        • Як згенерувати лінк для скидання пароля вручну (Адміністратор)
        • Як скинути пароль через «Забули пароль?»
  1. Документація
  2. /Quality Assurance
  3. /Explanation
  4. /Як налаштувати чеклист AI QA для якісної оцінки діалогів

Як налаштувати чеклист AI QA для якісної оцінки діалогів

Чеклист для AI-оцінки діалогів — це набір критеріїв, за якими система автоматично перевіряє якість обслуговування. Якщо критерії сформульовані нечітко або дублюють один одного, AI дає неточні оцінки, і QA-спеціалістам доводиться часто корегувати результати. Ця сторінка пояснює принципи формулювання критеріїв, щоб AI стабільно і коректно оцінював діалоги.


Короткий зміст

  • Контекст і проблема
  • Основні концепції
  • Структура критерію: опис і інструкція перевірки
  • Розмір чеклисту та групування
  • Критичність та ваги
  • Прийняті принципи
  • Практичні рекомендації для інтегратора
  • Пов'язані документи

Контекст і проблема

AI-оцінка діалогів працює за чеклистом: кожен критерій перевіряється окремо, і на основі результатів формується загальний бал. Якщо критерії:

  • описані загальними фразами без конкретики;
  • дублюють один одного;
  • не пояснюють, де і як перевіряти;
  • зібрані в один надто великий чеклист;

то AI часто помиляється, і QA-спеціалісти витрачають час на корекції замість аналізу.

Типові сценарії:

  • Інтегратор налаштовує чеклист для нового клієнта на основі їхніх стандартів якості.
  • Клієнт передає критерії в CSV, Excel або текстовому вигляді — потрібно їх структурувати.
  • Після запуску AI-оцінок виявляється багато помилок — потрібно зрозуміти, як покращити критерії.

Основні концепції

Що таке критерій

Критерій — це окрема перевірка якості діалогу. Наприклад: «Привітання та персоналізація», «Вирішення питання клієнта», «Дотримання процедур ідентифікації».

Кожен критерій має:

  • Назву — коротко, що саме перевіряється.
  • Опис — що саме вважається помилкою, а що правильною поведінкою.
  • Інструкцію перевірки — конкретні кроки: де дивитися, що порівнювати, як перевіряти.

Модель оцінки: тільки віднімання балів

Система використовує дедуктивну модель: початковий бал — 100, за кожну виявлену помилку бали знімаються. Додаткові бали за «хорошу роботу» не нараховуються.

Наслідок: Усі критерії мають бути сформульовані як перевірки на відсутність помилок, а не на «наявність плюсів».


Структура критерію: опис і інструкція перевірки

Найважливіше правило: опис і інструкція перевірки виконують різні ролі і не повинні дублювати один одного.

Опис (description)

Призначення: Пояснити, що саме перевіряється і які помилки можливі.

Що включати:

  • Що охоплює критерій.
  • Які ситуації вважаються помилкою.
  • Яка поведінка вважається правильною.
  • Приклади, винятки, умови (якщо є).

Приклад:

Оператор має привітати клієнта та персоналізувати звернення: принаймні один раз на день спілкування привітати клієнта, назвати своє ім'я, звертатися до користувача по імені без помилок. Якщо ім'я неоднозначне (Алекс, Саша, Женя, Гоша), відсутність звернення по імені до моменту прояснення не вважається помилкою.

Інструкція перевірки (check_instruction)

Призначення: Пояснити, як саме перевіряти критерій — де шукати інформацію і які дії виконати.

Що включати:

  • Де шукати (діалог, профіль клієнта, тікет).
  • Що порівнювати з вимогами.
  • Конкретні кроки перевірки (крок 1, крок 2 тощо).
  • Винятки, якщо вони впливають на спосіб перевірки.

Що не включати:

  • Повторення списку помилок з опису.
  • Повторення прикладів з опису.
  • Загальні фрази на кшталт «Перевірити відповідність».

Приклад інструкції перевірки:

  1. Відкрити транскрипт діалогу. 2. Знайти перше повідомлення оператора на день спілкування. 3. Перевірити наявність привітання, назви оператора та звернення до клієнта по імені. 4. Якщо ім'я неоднозначне — перевірити, чи було прояснення до моменту звернення по імені.

Чому важливо не дублювати

Якщо інструкція перевірки повторює опис, AI отримує однакову інформацію двічі і може неправильно інтерпретувати, що саме робити. Інструкція має давати методологію перевірки, а опис — зміст і контекст.


Розмір чеклисту та групування

Оптимальна кількість критеріїв

  • 8–15 критеріїв — оптимально: достатньо деталізації, але без перевантаження.
  • До 20 критеріїв — максимально допустимо в одному чеклисті.
  • Понад 20 — варто розбити на кілька чеклистів.

Коли об'єднувати критерії

Об'єднуйте критерії, якщо:

  • Назви дуже схожі (наприклад, «Привітання» і «Привітання оператора»).
  • Опису перетинаються більш ніж на 60%.
  • Критерії належать до однієї логічної категорії і перевіряють одне й те саме.

Приклад об'єднання: «Привітання» + «Персоналізація звернення» → «Привітання та персоналізація звернення» (якщо вони завжди перевіряються разом).

Коли розбивати на кілька чеклистів

Розбивайте, якщо критерії логічно групуються за категоріями:

  • Стилістика: граматика, привітання, тон, стиль спілкування.
  • Коректність контенту: відповідність скрипту, процедурам, точність інформації.
  • Процес: таймінг, ідентифікація, технічні процедури.

Кожен чеклист можна використовувати окремо для різних типів звернень або етапів перевірки.


Критичність та ваги

Критичні критерії

Критичний критерій — порушення якого автоматично призводить до незадовільної оцінки, незалежно від інших балів.

Позначайте критерій як критичний, якщо:

  • У назві або описі явно вказано «критична помилка», «блокуюча помилка» тощо.
  • Це процедури ідентифікації, безпеки або обов'язкові регуляторні вимоги.
  • Клієнт чітко визначив це як блокуючу умову.

Для критичних критеріїв вага не використовується (встановлюється 0).

Ваги некритичних критеріїв

Для некритичних критеріїв сума ваг має дорівнювати 100. Вага показує відносну важливість критерію:

  • Більша вага — більший вплив на фінальний бал при порушенні.
  • Менша вага — менший вплив.

Приклад: Якщо є 10 некритичних критеріїв з однаковою важливістю, кожен отримує вагу 10. Якщо «Вирішення питання» важливіше за «Привітання», можна задати, наприклад, 15 і 5.


Прийняті принципи

  1. Мова клієнта — усі тексти критеріїв (назва, опис, інструкція перевірки) пишуться мовою клієнта (українська, російська тощо).

  2. Тільки негативна оцінка — критерії перевіряють відсутність помилок; додаткові бали за «плюси» не нараховуються.

  3. Інструкція важливіша за опис — для AI ключова інструкція перевірки: вона визначає, як саме перевіряти. Опис дає контекст і приклади.

  4. Без дублювання — опис і інструкція перевірки не повторюють один одного.

  5. Конкретні кроки — інструкція містить дієслова: перевірити, знайти, порівняти, переконатися, вказати.


Практичні рекомендації для інтегратора

Перед створенням чеклисту

  1. Отримайте від клієнта критерії в будь-якому форматі (CSV, Excel, текст).
  2. Перевірте кількість критеріїв: якщо більше 20 — заплануйте розбиття на кілька чеклистів.
  3. Визначте критичні критерії за назвами та описом клієнта.

При формулюванні кожного критерію

  1. Опис: Збережіть усі деталі з джерела клієнта — приклади, винятки, умови. Не спрощуйте і не видаляйте важливі нюанси.

  2. Інструкція перевірки: Напишіть окремо, як перевіряти:

    • де шукати (діалог, профіль, тікет);
    • що порівнювати;
    • які кроки виконати.
  3. Перевірка на дублювання: Переконайтеся, що інструкція не повторює опис. Якщо більше половини тексту збігається — переформулюйте інструкцію, зосередившись на методології перевірки.

Після налаштування

  1. Запустіть кілька тестових AI-оцінок на реальних діалогах.
  2. Перегляньте результати: якщо AI часто помиляється по одному критерію — уточніть інструкцію перевірки.
  3. Якщо QA-спеціалісти часто коректують одні й ті самі критерії — перегляньте формулювання.

Типові помилки

ПомилкаПроблемаРішення
Інструкція повторює описAI не розуміє, що саме робитиНаписати інструкцію як окремі кроки перевірки
Занадто загальна інструкція («Перевірити привітання»)AI інтерпретує по-різномуДодати: де шукати, що перевіряти, у якому порядку
Один великий чеклист (25+ критеріїв)Перевантаження, гірша точністьРозбити на 2–3 чеклисти за логічними групами
Критичність не позначенаКритичні помилки не блокують оцінкуПозначити критерії з «критичними» у назві/описі
Сума ваг ≠ 100Некоректний розрахунок балуПерерахувати ваги так, щоб сума дорівнювала 100

Пов'язані документи

  • Створити оцінку — як створити оцінку та обрати чеклист
  • Корегувати AI-оцінки — як виправляти помилки AI після оцінки
  • Використати чеклист — як проводити перевірку за чеклистом

On this page