Чтобы сделать AI-помощника по своим документам, начните с небольшой учебной подборки и вопросов с известными ответами. Помощник должен находить подходящие фрагменты, ссылаться на них и сообщать, когда нужных сведений нет.
Что подготовить
Выберите, например, десять коротких документов без секретов и личных данных. Это удобный размер первой пробы, а не технический предел. Для каждого сохраните ID, название, версию, дату и разрешённых читателей.
Составьте вопросы и эталонные ответы до запуска помощника. Добавьте вопрос без ответа и две версии одного документа с разными условиями. Определите, какая версия считается действующей.
Как выбрать поиск
Для маленькой текстовой подборки сначала оцените обычный поиск по словам. Если нужны ответы по смыслу и много документов, можно рассмотреть поиск по сходству фрагментов. Его часто называют векторным поиском.
В OpenAI Responses API инструмент file_search использует загруженные файлы в vector_store и может возвращать ссылки на файлы в ответе. Это отдельная API-интеграция. Наличие чтения файлов в Codex само по себе не создаёт такого помощника. Документация File search.
Что проверить в первой версии
| Вопрос или условие | Критерий результата |
|---|---|
| Ответ есть в одном документе | Правильный ответ и конкретное подтверждение |
| Нужны два документа | Использованы оба, условия сохранены |
| Ответа нет | Отсутствие сведений обозначено |
| Документы противоречат | Названы версии и правило выбора |
| Документ обновлён | Использована новая принятая версия |
| Пользователь не имеет доступа | Документ и его фрагменты не выданы |
Права нужно применять до передачи фрагментов модели. Просьба «не показывать чужие данные» после их получения не является надёжной изоляцией.
Промпт для Codex
Подготовь учебного помощника по документам: [папка]. Вопросы с известными ответами: [файл].
Сначала перечисли документы, версии, права и варианты поиска. Начни с подходящего простого способа.
Составь проверки точного ответа, двух источников, отсутствующих сведений, противоречия, обновления и запрета доступа.
Сохраняй найденные фрагменты отдельно от ответа модели, чтобы можно было понять причину ошибки.
Пока подготовь локальную пробу. Не загружай документы во внешние сервисы и не запускай платные API-вызовы.
Полный план: Подготовить помощника по документам. Границы доступа: инструкция.
Как исправлять ошибки и обновлять базу
Сначала выясните, был ли найден нужный фрагмент. Если нет, исправляйте подготовку документов или поиск. Если фрагмент верен, а ответ нет, проверьте, как модель использовала условия и даты.
При удалении документа отдельно учитывайте исходник, поисковый индекс и сохранённые фрагменты. При обновлении повторяйте вопросы, на которые изменилась правильная версия ответа.
Источники и границы проверки
Инструкция помогает подготовить документы, поиск и проверочные вопросы. Для работающего помощника отдельно нужны реализация запроса к модели, индекс, правила доступа и тесты. Промпт выше готовит локальную пробу, а не подключает платный API.
