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

# Як запитати AI-суддю, чому він так оцінив критерій?

Оцінку діалогу ставить **AI-агент чек-листа** — «AI-суддя». Коли вердикт по критерію здається дивним, можна попросити **AI Помічника** запитати самого суддю: на яке повідомлення оператора він спирався, яке правило вирішило (текст критерію чи відповідь бази знань) і до яких баз знань він звертався.

AI Помічник показує поруч **збережену оцінку AI** (і правку людини, якщо вона є) та **відповідь судді**. **Оцінка при цьому не змінюється** — нічого не записується.

Функція **вимкнена за замовчуванням**, і кожне питання — **окремий платний запит** до AI-агента чек-листа.

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

- AI не зарахував критерій, а ви не бачите в діалозі порушення — хочете знати, яку цитату бачив суддя.
- Є підозра, що суддя взяв правило з бази знань **не про цю тему**.
- Готуєте правку чек-листа або бази знань і хочете зрозуміти, що саме заплутало суддю.

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

- **Це новий запит до того самого AI-агента.** Своєї розмови під час оцінки суддя не бачить — лише той самий діалог, **поточний** текст критерію і збережений вердикт. Якщо інструкції агента, критерій або база знань змінилися після оцінки, суддя відповідає вже за новими.
- **Вердикт може відрізнятися.** Суддя може зараз дійти іншого висновку, ніж у збереженій оцінці, — AI Помічник про це попередить. Оцінку це не змінює: рішення за людиною ([Корегувати AI-оцінки](/uk/quality_assurance/how-to/adjust-ai-assessment.md)).
- **Один запит — один критерій.** Щоб розібрати кілька критеріїв, питайте про кожен окремо.
- **Денний ліміт.** Кількість питань до судді на інстансі за добу (UTC) обмежена — за замовчуванням **30**. Після вичерпання AI Помічник скаже, коли ліміт оновиться.
- **Витрати.** Кожне питання — запит до AI-агента чек-листа (токени моделі). У статистику «AI-відповідей» такі запити не потрапляють, але коли ліміт AI-відповідей тарифу вичерпано, суддю теж не запитати.
- **Лише в режимі редагування AI Помічника.** У режимі лише читання, у режимі «Запитати» і в режимі «План» до підтвердження плану суддю не запитати — помічник скаже, що змінити.

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

- [x] Увімкнено модуль **Оцінка якості** і **Instance Agent Integration**.
- [x] Root увімкнув перемикач **Instance Agent: Ask AI QA judge** (крок 1).
- [x] У вашої ролі є право **редагувати оцінки** в модулі «Оцінка якості» і право **«Дозволити агенту створювати, змінювати та видаляти дані (режим редагування)»** для AI Помічника; **Agent Read-Only Mode** вимкнено.
- [x] У чек-листа є AI-агент, і оцінка має вердикт AI по критерію.

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

### 1. Увімкнути функцію на інстансі (root)

1. Перейдіть **Меню → Налаштування → Налаштування інстансу**.
2. Розгорніть категорію **Instance Agent**.
3. Увімкніть **Instance Agent: Ask AI QA judge**.
4. За потреби змініть **Instance Agent: AI QA judge questions per day** — скільки питань до судді на добу дозволено всьому інстансу (від 1 до 1000; порожнє або некоректне значення — 30).

<!-- screenshot: налаштування інстансу, категорія Instance Agent, два нові рядки -->

### 2. Надати права ролям

1. Перейдіть **Меню → Налаштування → Користувачі → Ролі** і відкрийте роль.
2. У модулі **Оцінка якості** для розділу **Оцінки** надайте право на **редагування** — питати суддю можуть лише ті, хто може змінювати оцінки.
3. У модулі **AI-асистент (Instance Agent)** увімкніть **«Дозволити агенту створювати, змінювати та видаляти дані (режим редагування)»**.
4. Збережіть роль.

### 3. Запитати суддю в чаті

1. Відкрийте **AI Помічник** у режимі **«Агент»**.
2. Напишіть прямо, що хочете запитати суддю, наприклад:
   - «Спитай суддю, чому в оцінці 4055 не зараховано критерій "Повернення коштів за правилами БЗ"»;
   - «Запитай AI-суддю по оцінці 4055: на яке повідомлення він спирався?»
3. Якщо не назвати критерій, помічник візьме єдиний критерій, який AI не зарахував; якщо таких кілька — перепитає, про який саме.

На загальне питання «чому AI зняв бал?» помічник відповідає зі збереженої оцінки і суддю сам не питає; наприкінці він **може запропонувати** запитати суддю. Окремий платний запит іде лише тоді, коли ви прямо попросите або відповісте «так» на таку пропозицію.

<!-- screenshot: чат AI Помічника — питання і відповідь судді по критерію без бази знань (сценарій 1) -->

## Що у відповіді

1. **Критерій і оцінка** — назва критерію, номер оцінки.
2. **Збережена оцінка AI** — зараховано чи ні, бали, коментар AI; якщо людина змінювала оцінку — її правка й коментар.
3. **Відповідь AI-судді** — його пояснення (довгу відповідь помічник скорочує, зберігаючи ключові цитати). Якщо суддя замість відповіді на питання просто переоцінив критерій, спершу стоїть його вердикт зараз.
4. **Повідомлення, на які спирався суддя** — номери й початок повідомлень діалогу.
5. **Запити судді до бази знань** — що суддя шукав і що отримав; запит до бази, **не підключеної до цього критерію**, позначено окремо. Далі — фрагменти бази знань, якщо вони прийшли.
6. **Застереження** — наприклад, що це новий запит, що вердикт зараз інший, що критерій або діалог змінилися після оцінки, що суддя не звертався до підключеної бази знань.
7. **«Оцінку не змінено. Запитів до судді сьогодні: N з M.»**

<!-- screenshot: відповідь судді по критерію з базою знань — запити до БЗ і фрагменти (сценарій 2) -->

## Обмеження

| Ситуація | Що скаже помічник |
| --- | --- |
| Функцію вимкнено на інстансі або у ролі немає права змінювати оцінки | Що запитати суддю зараз не може, і хто це вмикає |
| Режим лише читання / «Запитати» / «План» до підтвердження | Що потрібен режим редагування / режим «Агент» / підтвердження плану |
| Денний ліміт вичерпано | Скільки дозволено на добу і коли ліміт оновиться |
| Суддю вже питають про цей критерій | Дочекатися відповіді на попереднє питання |
| AI-суддя не відповів або стався збій | Оцінку не змінено, спробуйте пізніше; повторно в тому самому повідомленні помічник не питає |
| AI ще не оцінював цю оцінку | Спершу запустити AI-оцінку |
| Критерій видалено з чек-листа або AI його не оцінював | Що питати нема про що |

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

- Оцінка, критерії та налаштування чек-листа **не змінюються**; відповідь судді лишається в історії чату AI Помічника.
- Якщо відповідь показала помилку AI — [скорегуйте оцінку](/uk/quality_assurance/how-to/adjust-ai-assessment.md) вручну, а причину (текст критерію, база знань) виправте в чек-листі.

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

- [Корегувати AI-оцінки](/uk/quality_assurance/how-to/adjust-ai-assessment.md)
- [Переглянути деталі оцінки](/uk/quality_assurance/how-to/view-assessment-details.md)
- [Що таке AI Помічник](/uk/constructor/explanation/what-is-ai-assistant.md)
- [Як налаштувати доступ до AI Помічника](/uk/constructor/how-to/configure-ai-assistant-access.md)