Файлы и знания помощника¶

Постоянные знания помощника можно подключать двумя принципиально разными способами: постоянный файловый контекст и поиск по файлам.

Главное различие¶

File Context
→ текст извлечён заранее
→ добавляется к постоянному контексту
→ обычно участвует в каждом запросе

File Search
→ документ индексируется
→ по вопросу выполняется поиск
→ передаются релевантные chunks

File Context¶

Подходит для коротких материалов: словарь терминов, style guide, небольшая policy, описание API, таблица соответствий.

Почему не надо класть туда сотни страниц¶

Постоянный текст конкурирует с инструкцией, историей, вопросом, результатами операций, контекстом RAG и будущим ответом.

Большой постоянный контекст делает работу дороже, медленнее и менее предсказуемой.

File Search¶

Подходит для регламентов, технических руководств, больших инструкций, базы знаний и коллекций документов.

RAG передаёт модели только наиболее релевантные фрагменты.

Правила и знания¶

Правило:

Всегда добавляй раздел «Риски».

— инструкция.

Факт:

Резервное окно — 03:40 MSK.

— документ.

Подготовка документов¶

Перед загрузкой:

удалите устаревшие дубли;
дайте понятные имена;
добавьте дату/версию;
проверьте текстовый слой PDF;
удалите секреты;
разделите независимые огромные документы.

Выбор режима¶

нужно почти всегда + мало текста → File Context
много документов + нужен поиск → File Search
нужно один раз → вложение конкретного чата

Индексация¶

После загрузки в File Search дождитесь состояния готовности. Не тестируйте retrieval пока обработка не закончилась.

Контрольные вопросы¶

Для каждого важного документа:

1. прямой факт
2. связь двух фрагментов
3. вопрос без ответа в документе

Третий тест проверяет галлюцинации.

Пример File Context¶

tone-guide.md:

Название продукта: НайсСофт — ИИ Студия.
Не использовать термин «бот» в клиентской документации.

Пример File Search¶

admin-guide.pdf            280 стр.
security-policy.pdf         96 стр.
backup-regulation.docx      42 стр.
incident-playbook.docx      80 стр.

Передавать всё это в каждый запрос не нужно.

Версии¶

Плохо:

policy-final.pdf
policy-final2.pdf
policy-new.pdf
policy-really-final.pdf

Лучше:

security-policy_current_2026-09.pdf

Архив храните отдельно от рабочей базы знаний.

Цитаты¶

Для нормативных помощников цитаты обязательны там, где механизм их поддерживает.

Пользователь должен отличать документ, вывод модели, общие знания и данные сервиса.

Сканированный PDF¶

Текущий локальный профиль извлекает существующий текст.

Image-only PDF без текстового слоя не следует считать автоматически распознанным. Сначала нужен доверенный OCR.

Секреты¶

Не храните в знаниях private keys, токены, passwords и recovery codes.

Viewer может не видеть файл в редакторе, но помощник потенциально способен использовать его содержимое в ответе.

Доступ к помощнику = косвенный доступ к знаниям¶

Если пользователь не должен знать данные документа, не подключайте этот документ к доступному ему помощнику.

Диагностика¶

файл существует?
↓
текст извлечён?
↓
индекс готов?
↓
правильный chunk находится?
↓
chunk передан?
↓
ответ модели корректен?

Контрольный документ¶

knowledge-healthcheck.md
Маркер: NICE-KB-2026-0914-ALPHA
Контрольный ответ: резервное окно — 03:40 MSK.

Вопрос:

Какое резервное окно рядом с маркером NICE-KB-2026-0914-ALPHA?

Сопровождение¶

Для базы знаний фиксируйте владельца, область, источник документов, дату ревизии, правило версионирования, аудиторию и контрольные вопросы.