# Як з'ясувати через AI Помічник, чому AI зняв бал в оцінці?

AI Помічник порівнює критерій чекліста, діалог, базу знань і ручну правку QA-спеціаліста та відповідає, хто помилився: **AI**, **критерій**, **база знань** чи **людина**. До кожного вердикту він додає дослівні цитати, показує, де це подивитись в інтерфейсі, і пропонує чернетку правки. Сам помічник нічого не змінює.

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

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

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

- **Вердикт** — це шар, у якому зміна тексту запобігла б помилці. Помічник перевіряє шари в такому порядку:
  - **Людина** — рішення AI прямо випливає з критерію (і бази знань), а ручна правка на них не спирається. Чернетки немає, лише порада переглянути правку.
  - **Критерій** — AI прочитав критерій так, як дозволяє його текст: немає межі теми чи винятку, формулювання двозначне. Чернетка — правка тексту критерію.
  - **База знань** — правило в базі знань хибне, застаріле або його немає. Чернетка — текстова пропозиція для документа.
  - **AI** — потрібне правило вже написане в критерії чи базі знань, а AI йому суперечить. Чернетка — правка критерію або системного промпту оцінки.
- **Помилки оцінки немає.** Якщо QA-спеціаліст критерій не правив, а AI зняв бал за правилом, прямо написаним у критерії (або в базі знань на тему критерію), і процитував повідомлення оператора з порушенням, помічник відповідає «Помилки оцінки немає: штраф обґрунтований»: цитує правило й повідомлення, показує, де дивитись, і чернетки не пропонує.
- Якщо даних бракує (немає доступу, діалогу чи бази знань), помічник пише «Вердикт не поставлено: бракує …» і не вгадує. Обґрунтований штраф — це не брак даних.
- **Базу знань перечитано зараз.** Помічник шукає в базі знань у момент питання, з налаштуваннями пошуку датасету. Під час оцінки AI міг отримати інші фрагменти: журнал його запитів не зберігається. Про це є застереження у відповіді.
- Якщо критерій змінили після оцінки, помічник попередить: вердикт стосується поточного тексту критерію.
- **Пошук у базі знань — це тестовий запит**, такий самий, як на екрані [Перевірка пошуку](/uk/fastlinepro/how-to/test-kb-retrieval.md). Він нічого не змінює в базі знань, але зберігається в історії тестових запитів бази на боці Fast Line Pro і враховується в метриках пошуку. Екран **Перевірка пошуку** цієї історії не показує.
- **Помічник нічого не записує.** Він не змінює критерії, налаштування, базу знань і оцінки та не запускає повторну оцінку. Чернетку правки ви застосовуєте самі в інтерфейсі.
- За один раз помічник розбирає до 3 критеріїв. Решту він запропонує розібрати наступною порцією — напишіть «далі».

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

- [x] У вашої ролі є доступ до модуля **AI-асистент** ([як користуватися AI Помічником](/uk/constructor/how-to/use-ai-assistant.md)).
- [x] Ваша роль може переглядати оцінки якості: розділ **Оцінки** модуля `Оцінка якості` або галочка **«Перегляд оцінок якості»** у правах Лінії операторів. З розділом **Мої оцінки** помічник розбирає лише ваші власні оцінки. Розділ **Чеклисти** чи галочка **«Запуск оцінок якості»** без перегляду оцінок відкривають тільки чеклісти — для діагностики цього недостатньо.
- [x] Ви маєте доступ до діалогу оцінки в Лінії операторів (якщо роль обмежена групами навичок чи ботами, діалог може бути недоступний).
- [x] Ви знаєте номер оцінки, номер діалогу або назву чекліста й період.

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

### 1. Відкрити AI Помічник і поставити питання

1. Натисніть кнопку з іконкою **«іскра»** у верхній панелі.
2. За бажанням наберіть **`/`** і оберіть навичку **«Контроль якості — діагностика оцінок AI»**. Без цього помічник теж підхопить навичку за змістом питання.
3. Напишіть питання одним із способів:
   - за номером оцінки: «Чому AI зняв бали в оцінці 4055? Хто винен і що правити?»;
   - за критерієм: «Розбери критерій 57 в оцінці 4055»;
   - за діалогом: «Розбери діалог 788610 — чому мінус?»;
   - за ручними правками: «Покажи ручні правки AI-оцінок за чеклістом 4 за 24–25.09 і скажи, чий косяк».
4. Надішліть запит.

<!-- Місце для скріна: питання в чаті AI Помічника. -->

### 2. Прочитати відповідь

По кожному критерію помічник відповідає в такому порядку:

1. **Вердикт** — `Критерій 57 «Назва критерію» — вердикт: AI / Критерій / БЗ / Людина` і одне речення, чому. Або `Критерій 57 «Назва критерію» — помилки оцінки немає: штраф обґрунтований` з цитатою правила й повідомлення оператора.
2. **Цитати** дослівно: фрагмент критерію, коментар AI, коментар QA-спеціаліста, повідомлення діалогу з номером, фрагмент бази знань з назвою документа.
3. **Застереження**, якщо вони є: база знань перечитана зараз; критерій змінено після оцінки.
4. **Куди дивитись** — шлях до оцінки «Контроль якості → Оцінки (або «Мої оцінки») → #номер» (посилання — лише коли його можна зібрати з адреси сторінки, на якій ви відкрили помічник), чекліст і критерій, документ бази знань.
5. **Чернетка правки** — одне-два речення і блок `qa-fix-draft` з точною заміною тексту. Під ним рядок «Нічого не записано». Для «Людина» і «Помилки оцінки немає» чернетки немає.

Якщо ви питали про ручні правки за період, помічник бере оцінки, у яких QA-спеціаліст виправив хоча б один критерій, — навіть коли підсумковий бал від цього не змінився. На початку відповіді є рядки на кшталт «Період: 28.09.2026 00:00 – 23:59 (Київ)» і «Переглянуто оцінок: 2, з ручними правками: 1, розібрано критеріїв: 3». Без періоду в питанні помічник бере останні 7 днів за київським часом.

<!-- Місце для скріна: відповідь з вердиктом, цитатами і чернеткою правки. -->

### 3. Застосувати правку (за потреби)

1. Відкрийте чекліст за посиланням з розділу «Куди дивитись» і знайдіть критерій.
2. Замініть у тексті критерію фрагмент із чернетки на запропонований і збережіть.
3. Для правки бази знань відкрийте документ за посиланням і змініть фрагмент.

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

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

Помічник лише відповідає в чаті — дані на платформі не змінюються. Нові правила діють для оцінок, запущених після того, як ви збережете критерій чи змінене налаштування.

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

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

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

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