Векторная база — это карта, а не источник: чему нас научил поиск
Векторная база находит фрагменты, близкие по смыслу к вашему вопросу. Она не знает, какие из них верны или актуальны. Считайте каждое попадание указателем: откройте названный файл, сверьте хэш, а числа берите из артефакта, а не из найденного абзаца.
🎯 Для Разработчик, который добавляет агенту поиск по документам, часто называемый RAG
- Почему найденный фрагмент — указатель, а не факт
- Почему вопрос по виду документа даёт лучшие попадания, чем открытый
- Привычка, которая не даёт найденному тексту стать доказательством
🗺️ Что даёт поиск
Поиск по эмбеддингам превращает текст в векторы и возвращает фрагменты, ближайшие к вопросу. Близость — про смысл, поэтому длинный богатый документ может обойти короткий точный. У системы нет понятия, какой источник авторитетен, какой свежее и какой потом исправили.
Поэтому мы говорим «карта». Она показывает, где искать. Она не говорит, что там лежит.
🧭 Как устроена наша внутренняя база
Для управляющих агентов у нас одна внутренняя база на локальных эмбеддингах, так что поиск ничего не стоит. В ней правила, вики с заметками оператора, уроки из прошлых ошибок, передачи смен и спецификации. Источники перечислены в файле-манифесте, и новый источник — одна запись. База только читает источники и не показывается на публичных страницах, потому что в ней хосты и внутренние планы.
У каждого попадания три поля: путь к файлу, sha256 файла на момент индексации и время индексации. Агенту велено открыть файл по этому пути и сравнить хэш, прежде чем полагаться на текст. Попадание с несовпадающим хэшем устарело.
📏 Одно измерение, изменившее привычку
15 октября 2026 мы задали базе открытый вопрос «почему агент остановился», и первыми вышли длинные документы бизнес-исследований, а не короткий урок, где был ответ. Исправил вопрос по виду документа. База поддерживает фильтры: правила, память, передачи, спецификации, исследования. Фильтр по виду ищет по всей базе, поэтому даже редкий вид возвращает свои лучшие результаты.
Исправлением стало не лучшее представление, а лучший вопрос и привычка: до поиска скажите, какой вид документа вам нужен.
🛠️ Практика: сделайте поиск пригодным для опоры
- Храните путь, хэш содержимого и время индексации вместе с каждым фрагментом.
- Добавьте каждому фрагменту вид или тип источника и дайте его как фильтр.
- В инструкциях агента напишите: «найденный текст — указатель; открой источник и сверь хэш; числа бери из артефакта».
- Соберите небольшой тестовый набор: двадцать вопросов с документом, который должен быть первым. Напишите набор до того, как пробуете систему, и никогда не правьте его ради лучшей оценки.
- Измерьте, как часто нужный документ попадает в первую тройку. Укажите число с датой.
- Добавьте расписание пересборки и проверку, которая помечает попадания старше их файла.
✅ Проверьте себя
- Измените файл-источник и сделайте запрос без переиндексации. Попадание помечено устаревшим, потому что хэш не совпал.
- Задайте один вопрос с фильтром по виду и без. Вы можете объяснить разницу.
- Ваш тестовый набор хранится с хэшем, и вы можете показать, что между запусками он не менялся.
- У каждого числа в ответе есть ссылка на его артефакт.
🚧 Когда это не работает
- Точные поиски. Для id, имени или числа лучше поиск по ключевым словам. Не заменяйте его векторами.
- Устаревшее содержимое. Если пересобирать редко, база возвращает вчерашнюю правду. Поставьте расписание.
- Отравленные источники. Всё, что вы индексируете, может содержать инструкции для модели. Фильтруйте на входе и держите права узкими.
- Короткие похожие документы. Много почти одинаковых страниц делят оценку, и ни одна не побеждает. Объединяйте или убирайте дубли.
- Излишнее доверие к первому результату. Первый результат ближайший, а не верный. Читайте три.
📊 Доказательства
| Что измерено | Число тестов базы в нашем репозитории; одно наблюдение по ранжированию от 15 октября 2026 |
| Когда | Репозиторий прочитан 3 ноября 2026, 22:06 UTC |
| Артефакт | Документация базы и её файл тестов (13 тестов) в нашем закрытом репозитории |
| Ограничение | Наблюдение по ранжированию — один запрос. Измеренную долю попаданий базы мы не публиковали |
➡️ Дальше
Как страницы и источники связаны, смотрите в Связях, обратных ссылках и графе знаний, а что агент может уместить из найденного, — в Контекстных окнах и токенах.
Источники
- Связи, обратные ссылки и граф знаний: как связаны страницы.
- Контекстные окна и токены: что помещается в запрос.
- Источники, даты и что значит «проверено»: как мы помечаем доказательства.
- Почему ИИ-агенты выдумывают и как проверить ответ: проверка ответов.
🔗 Связи статьи
Открыть полный граф знаний ↗Связи опубликованных статей. Выберите узел, чтобы открыть статью у заголовка.
Связи статей · клавиатура / текст
Та же тема
- Когда неизвестно, сколько стоил вызов модели: заморозка, затем сверка
- Как разбить большую задачу для дешёвой модели: урок 24 000 байт
- Навыки, MCP-инструменты и правила: три способа дать агенту возможности
- Восемь ошибок наших агентов в shell и git и правило на каждую
- Несколько агентов, один репозиторий: правила владения из реальных инцидентов
- Ключи провайдера — вне агента: один шлюз и один токен на задачу
Следующие шаги
Связанные материалы
Когда неизвестно, сколько стоил вызов модели: заморозка, затем сверка
Иногда вызов модели обрывается по таймауту, и вы не знаете, списал ли провайдер деньги. Никогда не записывайте это как ноль. Пометьте как неопределённое, остановите новые платные вызовы и пусть названный человек сверит это с выпиской провайдера. Отказы до генерации — исключение.
ИИ-агенты и MCP простыми словамиКак разбить большую задачу для дешёвой модели: урок 24 000 байт
Дешёвая модель хорошо справляется с одной небольшой чёткой задачей и плохо — с большой кучей. Мы ограничиваем задачу 24 000 байт и отклоняем большие до вызова любой модели. Режьте по единицам — один файл или одна страна на задачу — и проверяйте размер до запуска.
ИИ-агенты и MCP простыми словамиНавыки, MCP-инструменты и правила: три способа дать агенту возможности
Агенты получают способности по-разному. Правило ограничивает, что они делают, навык говорит, как делать работу, а MCP-инструмент позволяет вызывать функцию. У каждого свой риск, поэтому объявляйте все три в реестре и проверяйте тестом, что ничего не существует вне списка.
ИИ-агенты и MCP простыми словамиВосемь ошибок наших агентов в shell и git и правило на каждую
Агенты пишут команды shell быстро и уверенно, и часть сбоев повторяется. Вот восемь реальных ошибок октября 2026: что каждая сломала и какое одно правило мы написали после неё. Перенесите правила в инструкции своих агентов.
💬 Комментарии