# Как задать хороший вопрос по документам

> Назвать документ, раздел и период; сказать, в каком виде нужен ответ; приложить файл; как читать ответ со ссылкой и что значит «не нашла».

ИИ-агент уточнит, если чего-то не хватает, но чем точнее вопрос, тем меньше кругов и тем меньше документов ему придётся прочитать. Примеры ниже — из вымышленной компании «Заметки»: сервис заметок для команд с тарифами «Старт», «Бизнес» и «Корпоративный»; документы отделов лежат в папке «Документы компании».

## Хорошо

- **Назовите документ, раздел или период**, если знаете: «по договору и тарифному приложению», «в регламенте закупок 2026», «за третий квартал». Тогда агент идёт в нужную папку, а не перебирает все.
- **Скажите, в каком виде нужен ответ**: таблицей, списком, цитатой, коротким «да/нет» со ссылкой.
- **Назовите, с чем сверить**, если подозреваете расхождение: «совпадает ли с FAQ?».

## Плохо

- Слишком общо («что у нас с возвратами?») — непонятно, о каком документе и о каком случае.
- Несколько вопросов в одном — разбейте, каждый получит свою ссылку.
- Скрытый контекст: «как у того клиента» — агент не знает, у какого.

| Плохо | Хорошо |
| --- | --- |
| «Что у нас с возвратами?» | «Клиент просит возврат через 20 дней после оплаты — что говорят регламент и договор?» |
| «Сроки поддержки» | «Какой срок первой реакции обещан клиенту на тарифе «Бизнес» по договору и совпадает ли он с FAQ?» |
| «Пени» | «В каких договорах 2026 года есть пени за просрочку и какие ставки? Таблицей: контрагент, ставка, потолок» |

## Файл, которого нет в источниках

Приложите его к вопросу — до 10 МБ: Word, Excel, PowerPoint, PDF, текст. Агент читает содержимое, а не имя файла: текст, таблицы, слайды и заметки к ним. Так проверяют то, что ещё не лежит в общей папке: «Проверь этот текст на соответствие документу «Как мы говорим о продукте»» — и текст вложением.

Скан без текстового слоя приложить можно, но прочитать его агент не сможет: распознавания изображений нет. Если документ существует только сканом, попросите текстовую версию.

## Как читать ответ

- **Ссылка на документ и раздел.** У страницы Notion, Confluence или документа на Диске это ссылка на саму страницу; у файла на сервере — путь к файлу. По ссылке стоит сходить, если ответ важен: агент цитирует, но решение принимаете вы.
- **Два документа расходятся — названы оба.** «Регламент и договоры обещают четыре рабочих часа, FAQ поддержки — восемь» — это не ошибка агента, а находка: документы нужно привести в порядок, а до тех пор в базу знаний записать, какому верить.
- **«Ход рассуждений»** показывает, что агент открыл и в каком порядке. Если он искал не там — уточните папку или раздел.
- **Ответ без ссылки** — повод спросить «по какому документу?». Ответ по записи базы знаний ссылается на запись, а не на документ.

## Что значит «не нашла»

Агент не нашёл документ, хотя вы знаете, что он есть. Четыре обычные причины:

1. **Папка или раздел не входят в область подключения** — корнем отмечена другая папка, или нужная попала в исключения. Это настройка подключения, её меняет ИТ: [что попросить](/docs/for-admin).
2. **Подключение не работает** — статус и последняя ошибка видны в разделе «Коннекторы» приложения; запускает его ИТ.
3. **У учётной записи нет доступа** — папкой на Диске не поделились с учётной записью коннектора, интеграцию Notion не подключили к разделу, у учётной записи сетевой папки нет права читать её.
4. **Документ — скан без текстового слоя** — агент видит файл, но прочитать его не может.

Если ничего из этого, задайте вопрос точнее: назовите файл или папку.

## Уточняйте, а не начинайте заново

Продолжение в том же диалоге держит контекст: агент помнит, что уже прочитал, и уточнение обходится дешевле нового вопроса. Новый диалог начинает с чистого листа. Агент и сам может задать встречный вопрос с вариантами — ответьте в том же диалоге.

## Расход «вход / выход»

В шапке диалога видны два числа и стоимость. **Вход** — всё, что агент прочитал: ваш вопрос, открытые для ответа документы, записи базы знаний, предыдущие сообщения диалога. **Выход** — всё, что он написал: ответ и ход рассуждений. Чем точнее вопрос, тем меньше вход. Подробнее — [Сколько стоит вопрос](/docs/cost-of-a-question).