# Як запустити масову оцінку з таблиці чатів або зі списку номерів?

Масова оцінка AI QA оцінює одразу багато закритих чатів. Чекліст кожного чату підставляється за його темою з налаштування автооцінки, а перед запуском ви бачите, скільки чатів яким чеклістом буде оцінено і які не оцінюються. Чати можна обрати в таблиці чатів операторської панелі, завантажити списком номерів або відкрити за захищеним посиланням від колеги.

---

## Коли знадобиться

- Потрібно оцінити чати, знайдені фільтрами таблиці чатів.
- Список номерів чатів уже є — у файлі CSV або в тексті.
- Потрібно, щоб кожна тема оцінювалась своїм чеклістом, а теми з «Не оцінювати» не оцінювались.

---

## Що важливо знати

- **Коли діє це вікно.** Вікно **«Масова оцінка AI QA»** відкривається, коли на вашому інстансі увімкнено налаштування автооцінки AI QA (створено основне налаштування «Для всіх ботів»). До цього **«Оцінка діалогів»** відкриває звичне вікно **«Масовий запуск AI-оцінки»** — див. [Запустити масову AI-оцінку діалогів](/uk/quality_assurance/how-to/run-bulk-ai-evaluation.md).
- **Чекліст за темою.** Для кожного чату чекліст береться з налаштування автооцінки його бота (окреме налаштування бота або «Для всіх ботів»): спершу рядок теми, потім рядок її родини, потім рядок «Усі інші теми». Чати без теми йдуть рядком **«Без теми»**. На цей запуск рядок можна змінити — самі налаштування не змінюються.
- **«Не оцінювати».** Чати тем із «Не оцінювати» в масовій оцінці не оцінюються. Щоб оцінити такий чат, змініть рядок на чекліст або оцініть чат вручну з картки.
- **Повторна оцінка.** Чат, уже оцінений тим самим чеклістом, оцінюється ще раз як звичайний — окремих позначок і галочок немає. Кожен запуск створює нову оцінку.
- **Правила пропуску.** Перемикач **«Застосувати правила пропуску»** з'являється, якщо хоча б в одного бота вибраних чатів у налаштуванні автооцінки увімкнено «Застосовувати правила пропуску до масової оцінки». Діють лише правила, увімкнені в налаштуванні бота. Причину пропуску видно в історії запусків, а не в картці діалогу.
- **Що не оцінюється зовсім.** Відкриті чати й чати, у яких не писав оператор, відхиляються ще до запуску з причиною **«Чат відкритий або в ньому не писав оператор»**.
- **Ліміт.** Один запуск — до 30 чатів; адміністратор може підняти ліміт до 100 (див. [Налаштувати ліміти AI-оцінки](/uk/quality_assurance/how-to/configure-ai-evaluation-settings.md)). У ліміт рахуються всі чати, які можна оцінити, — і ті, що не оцінюються за темою чи пропускаються правилами. Для більшої вибірки створіть кілька запусків.
- **Файл або номери.** CSV з колонкою `chat_room_id` або номери чатів через кому, пробіл чи з нового рядка. До 1000 номерів, файл до 5 МБ. Формат XLSX не підтримується — збережіть таблицю як CSV. Повтори в списку прибираються автоматично.
- **Посилання на вибірку.** Перевірений список чатів можна передати колезі захищеним посиланням — див. [Поділитися вибіркою чатів посиланням](/uk/quality_assurance/how-to/share-bulk-selection-link.md).

---

## Перед початком

- [x] У вашої ролі в операторській панелі є право запуску оцінки якості, і вам доступна таблиця чатів.
- [x] На інстансі увімкнено налаштування автооцінки AI QA і створено основне налаштування «Для всіх ботів».
- [x] У модулі `Оцінка якості` є хоча б один активний чекліст.

---

## Покрокова інструкція

### 1. Оберіть чати

**Чати з таблиці:**

1. Відкрийте `Операторська панель` і таблицю чатів.
2. Відфільтруйте чати фільтрами таблиці й позначте потрібні.
3. Натисніть **«Дії»** → **«Оцінка діалогів»**. Якщо вибрано більше чатів, ніж дозволяє ліміт, пункт неактивний — зменшіть вибірку.
4. Вікно **«Масова оцінка AI QA»** відкриється з джерелом **«Обрані в таблиці»**.

<!-- screenshooter src=quality_assurance/run-bulk-assessment-from-chats-table/screenshot-1-actions-menu -->

**Файл або номери:**

1. У таблиці чатів натисніть **«Дії»** → **«Масова оцінка»**. Пункт доступний і без вибраних чатів.
2. У вікні оберіть джерело **«Файл або номери»**.
3. Завантажте файл CSV або вставте номери в поле.
4. Натисніть **«Перевірити»**.

<!-- screenshooter src=quality_assurance/run-bulk-assessment-from-chats-table/screenshot-2-file-or-ids -->

### 2. Перевірте результат перевірки

1. Над списком показано **«Можна оцінити: N · Відхилено: M»**.
2. У таблиці відхилених — номер чату і причина: **«Некоректний номер»**, **«Чат не знайдено»**, **«Повтор у списку»** або **«Чат відкритий або в ньому не писав оператор»**.
3. Якщо чатів більше за ліміт, вікно покаже «Вибрано {count} чатів — більше за ліміт {limit}. Зменшіть вибірку.» — запуск буде недоступний.

### 3. Перевірте чеклісти за темами

1. Блок **«Чекліст за темою на цей запуск»** показує рядок для кожної теми вибраних чатів і рядок **«Без теми»**: тема, кількість чатів і чекліст.
2. Підпис **«за темою «…»»** означає, що чекліст узято з рядка родини теми; **«за правилом «Усі інші теми»»** — що в теми немає власного рядка.
3. Якщо для однієї теми в різних ботів різні чеклісти, тема показана окремими рядками для кожного бота.
4. Щоб змінити чекліст на цей запуск, оберіть інший у колонці **«Чекліст»** або **«Не оцінювати»**. Змінений рядок позначено; щоб відмінити зміну, натисніть **«Повернути»**.

<!-- screenshooter src=quality_assurance/run-bulk-assessment-from-chats-table/screenshot-3-routes -->

### 4. Перевірте правила пропуску

1. Якщо в вікні є перемикач **«Застосувати правила пропуску»**, він типово увімкнений.
2. Зніміть його, якщо в цьому запуску правила пропуску не потрібні. Теми з «Не оцінювати» не оцінюються незалежно від перемикача.

### 5. Запустіть оцінку

1. Перевірте підсумок, наприклад: «3 → Demo main · 2 не оцінюються». Чати, уже оцінені раніше, входять у підсумок як звичайні.
2. Натисніть **«Запустити»**.

<!-- screenshooter src=quality_assurance/run-bulk-assessment-from-chats-table/screenshot-4-summary -->

---

## Що відбувається після

- Вікно закривається, вибір у таблиці знімається, і відкривається сторінка цього запуску в модулі `Оцінка якості`.
- Чати оцінюються у фоні. Коли всі опрацьовано, з'являється сповіщення про завершення. Якщо частину чатів пропущено, у ньому є рядок «Пропущено правилами: … Не оцінюється за темою: …».
- Усі запуски зібрані в історії — див. [Переглянути історію масових оцінок](/uk/quality_assurance/how-to/view-bulk-assessment-history.md).

---

## Як переконатися, що все вдалось

- На сторінці запуску джерело — **«Із таблиці чатів»**, **«Файл або номери»** або **«Посилання»**.
- Чати різних тем оцінено своїми чеклістами; чати тем із «Не оцінювати» мають статус **«Не оцінюється за темою»**.
- Кількість чатів у запуску відповідає підсумку у вікні.

---

## Якщо вибірка більша за ліміт

1. Розділіть вибірку на частини в межах ліміту інстансу. Рахуйте всі чати, які можна оцінити, включно з тими, що не оцінюються за темою.
2. Створіть окремий запуск для кожної частини.
3. Додайте до кожного запуску коментар із номером частини, наприклад «Період 01–07.08, частина 1/3».

---

## Можливі повідомлення

| Повідомлення | Що робити |
|---|---|
| Формат XLSX не підтримується. Збережіть файл як CSV. | Збережіть таблицю у форматі CSV і завантажте знову. |
| Файл більший за 5 МБ. | Розділіть файл на частини. |
| У списку більше ніж 1000 номерів. Скоротіть список. | Залиште до 1000 номерів. |
| Не знайдено жодного номера чату. | Перевірте, що у файлі є колонка `chat_room_id` або що вставлено номери. |
| Частину значень пропущено: це не номери чатів. | Перевірка продовжиться для решти номерів; за потреби виправте список. |
| Немає чатів для запуску: усі вибрані чати не оцінюються за темою. | Змініть «Не оцінювати» на чекліст хоча б в одному рядку теми. |
| Цей запуск уже створено з іншим списком. Перевірте вибірку ще раз. | Закрийте вікно, оберіть чати знову й повторіть запуск. |
| Обраний чекліст недоступний. Виберіть інший. | Чекліст видалили або вимкнули — оберіть інший у рядку теми. |
| Правила пропуску не ввімкнені для масової оцінки в налаштуванні жодного бота цих чатів. | Зніміть перемикач або увімкніть галочку в налаштуванні автооцінки бота. |
| Налаштування автооцінки вимкнено. Оновіть сторінку. | Оновіть сторінку: після оновлення відкриється звичне вікно масової оцінки. |

---

## Пов'язані матеріали

- [Переглянути історію масових оцінок і додати коментар](/uk/quality_assurance/how-to/view-bulk-assessment-history.md)
- [Поділитися вибіркою чатів посиланням](/uk/quality_assurance/how-to/share-bulk-selection-link.md)
- [Запустити масову AI-оцінку діалогів (звичне вікно)](/uk/quality_assurance/how-to/run-bulk-ai-evaluation.md)
- [Налаштувати ліміти AI-оцінки](/uk/quality_assurance/how-to/configure-ai-evaluation-settings.md)
- [Переглянути деталі оцінки](/uk/quality_assurance/how-to/view-assessment-details.md)
