Tvijo wiki
Каталог

Темы

Векторная база — это карта, а не источник: чему нас научил поиск

Векторная база находит фрагменты, близкие по смыслу к вашему вопросу. Она не знает, какие из них верны или актуальны. Считайте каждое попадание указателем: откройте названный файл, сверьте хэш, а числа берите из артефакта, а не из найденного абзаца.

🎯 Для Разработчик, который добавляет агенту поиск по документам, часто называемый RAG

📚 Вы узнаете
  • Почему найденный фрагмент — указатель, а не факт
  • Почему вопрос по виду документа даёт лучшие попадания, чем открытый
  • Привычка, которая не даёт найденному тексту стать доказательством

🗺️ Что даёт поиск

Поиск по эмбеддингам превращает текст в векторы и возвращает фрагменты, ближайшие к вопросу. Близость — про смысл, поэтому длинный богатый документ может обойти короткий точный. У системы нет понятия, какой источник авторитетен, какой свежее и какой потом исправили.

Поэтому мы говорим «карта». Она показывает, где искать. Она не говорит, что там лежит.

🧭 Как устроена наша внутренняя база

Для управляющих агентов у нас одна внутренняя база на локальных эмбеддингах, так что поиск ничего не стоит. В ней правила, вики с заметками оператора, уроки из прошлых ошибок, передачи смен и спецификации. Источники перечислены в файле-манифесте, и новый источник — одна запись. База только читает источники и не показывается на публичных страницах, потому что в ней хосты и внутренние планы.

У каждого попадания три поля: путь к файлу, sha256 файла на момент индексации и время индексации. Агенту велено открыть файл по этому пути и сравнить хэш, прежде чем полагаться на текст. Попадание с несовпадающим хэшем устарело.

📏 Одно измерение, изменившее привычку

15 октября 2026 мы задали базе открытый вопрос «почему агент остановился», и первыми вышли длинные документы бизнес-исследований, а не короткий урок, где был ответ. Исправил вопрос по виду документа. База поддерживает фильтры: правила, память, передачи, спецификации, исследования. Фильтр по виду ищет по всей базе, поэтому даже редкий вид возвращает свои лучшие результаты.

Исправлением стало не лучшее представление, а лучший вопрос и привычка: до поиска скажите, какой вид документа вам нужен.

🛠️ Практика: сделайте поиск пригодным для опоры

  1. Храните путь, хэш содержимого и время индексации вместе с каждым фрагментом.
  2. Добавьте каждому фрагменту вид или тип источника и дайте его как фильтр.
  3. В инструкциях агента напишите: «найденный текст — указатель; открой источник и сверь хэш; числа бери из артефакта».
  4. Соберите небольшой тестовый набор: двадцать вопросов с документом, который должен быть первым. Напишите набор до того, как пробуете систему, и никогда не правьте его ради лучшей оценки.
  5. Измерьте, как часто нужный документ попадает в первую тройку. Укажите число с датой.
  6. Добавьте расписание пересборки и проверку, которая помечает попадания старше их файла.

✅ Проверьте себя

  • Измените файл-источник и сделайте запрос без переиндексации. Попадание помечено устаревшим, потому что хэш не совпал.
  • Задайте один вопрос с фильтром по виду и без. Вы можете объяснить разницу.
  • Ваш тестовый набор хранится с хэшем, и вы можете показать, что между запусками он не менялся.
  • У каждого числа в ответе есть ссылка на его артефакт.

🚧 Когда это не работает

  • Точные поиски. Для id, имени или числа лучше поиск по ключевым словам. Не заменяйте его векторами.
  • Устаревшее содержимое. Если пересобирать редко, база возвращает вчерашнюю правду. Поставьте расписание.
  • Отравленные источники. Всё, что вы индексируете, может содержать инструкции для модели. Фильтруйте на входе и держите права узкими.
  • Короткие похожие документы. Много почти одинаковых страниц делят оценку, и ни одна не побеждает. Объединяйте или убирайте дубли.
  • Излишнее доверие к первому результату. Первый результат ближайший, а не верный. Читайте три.

📊 Доказательства

Что измерено Число тестов базы в нашем репозитории; одно наблюдение по ранжированию от 15 октября 2026
Когда Репозиторий прочитан 3 ноября 2026, 22:06 UTC
Артефакт Документация базы и её файл тестов (13 тестов) в нашем закрытом репозитории
Ограничение Наблюдение по ранжированию — один запрос. Измеренную долю попаданий базы мы не публиковали

➡️ Дальше

Как страницы и источники связаны, смотрите в Связях, обратных ссылках и графе знаний, а что агент может уместить из найденного, — в Контекстных окнах и токенах.

Источники

Связи опубликованных статей. Выберите узел, чтобы открыть статью у заголовка.

100%
→ Связанные статьи← Ссылаются сюда⋯ Та же тема
Связи статей · клавиатура / текст

💬 Комментарии

Комментарии публичны и модерируются. Не публикуйте персональные данные.
  • Комментариев пока нет. Будьте первым!

Следующие шаги

ИИ-агенты и MCP простыми словами

Когда неизвестно, сколько стоил вызов модели: заморозка, затем сверка

Иногда вызов модели обрывается по таймауту, и вы не знаете, списал ли провайдер деньги. Никогда не записывайте это как ноль. Пометьте как неопределённое, остановите новые платные вызовы и пусть названный человек сверит это с выпиской провайдера. Отказы до генерации — исключение.

ИИ-агенты и MCP простыми словами

Как разбить большую задачу для дешёвой модели: урок 24 000 байт

Дешёвая модель хорошо справляется с одной небольшой чёткой задачей и плохо — с большой кучей. Мы ограничиваем задачу 24 000 байт и отклоняем большие до вызова любой модели. Режьте по единицам — один файл или одна страна на задачу — и проверяйте размер до запуска.

ИИ-агенты и MCP простыми словами

Навыки, MCP-инструменты и правила: три способа дать агенту возможности

Агенты получают способности по-разному. Правило ограничивает, что они делают, навык говорит, как делать работу, а MCP-инструмент позволяет вызывать функцию. У каждого свой риск, поэтому объявляйте все три в реестре и проверяйте тестом, что ничего не существует вне списка.

ИИ-агенты и MCP простыми словами

Восемь ошибок наших агентов в shell и git и правило на каждую

Агенты пишут команды shell быстро и уверенно, и часть сбоев повторяется. Вот восемь реальных ошибок октября 2026: что каждая сломала и какое одно правило мы написали после неё. Перенесите правила в инструкции своих агентов.