Хранилище контекста для ИИ‑агентов: как построить в банке
Хранилище отдаёт агенту нужные фрагменты с источником, версией и правами.
В научном сравнении модель в длинном окне теряет нужное: при 32 тыс. токенов она находит его в 70 % случаев вместо 99 % на коротком тексте. Поиск в хранилище сочетает несколько способов находить материалы. У каждого результата сохраняются источник и версия. До передачи модели система проверяет доступ. Качество оценивают по тому, удалось ли решить задачу. В примере страницы агент получает три фрагмента со ссылкой и версией; число и объём фрагментов для своего процесса подбирают на реальных вопросах. Ниже девять шагов с примерами, в конце ресурсы.
- слованомера и коды
- векторысмысл
- графсвязи
- пакет агентуфрагмент · источник · версия
Сцена проходит один раз и останавливается на последнем кадре.
Последний кадр: пакет из трёх фрагментов у агента.
- 42 → 75 %нужных фрагментов в первой сотнеодни векторы против слов и векторов вместетехнический блог крупного банкаГибридный поиск на своих данных: тест крупного банка ↗
- 99 → 70 %находок в длинном окне моделикороткий текст против 32 тыс. токеновнаучное сравнениеДлинное окно модели: где теряется нужное ↗
- 2 ч и 72 чпоставщик обновляет текст и правапри узком доступе, без уведомлений об измененияхдокументация поставщикаОбновление текста и прав в корпоративном поиске ↗
- ×11токенов на обогащение документа8 000 токенов дают 88 500расчёт, допущения в тексте
Шаг 1 · старт
Начинают с одного сценария, который проверяют свои эксперты
Первый сценарий: помощник отвечает разработчику из платёжной команды, кто владеет API переводов и как его вызвать. Берут два‑три источника, у которых есть владелец и права. Помощника проверяют по эталону. Эталон пишут свои эксперты, нанимать людей для старта не нужно, если у экспертов есть на это время. Ориентир для первого набора по чужой практике: 300–500 вопросов, у каждого ответ, дата фактов и обязательные доказательства. Надёжность во всех сегментах, документах и правах такой набор ещё не доказывает.
Карта источников первого сценария
В первом сценарии
Один вопрос эталона
Какой сервис владеет API переводов, от чего он зависит и как его вызвать?
- Роль
- разработчик платёжной команды
- Факты на дату
- 01.10.2026
- Версии
- каталог API v12, основная ветка кода
- Доказательства
- карточка API, граф зависимостей, описание репозитория
- Ответ
- сервис переводов; вызывает проверку на мошенничество и журнал проводок; метод POST /transfers
- Если данных нет
- отказаться и дать ссылку на владельца источника
Кто делает старт
- 500 вопросовв первом наборе проверки у банкакогда меняют поиск или подсказки, правку прогоняют через этот наборвыступление руководителя банкаНабор вопросов для проверки: опыт банка ↗
- 300 ответовразметили люди, чтобы настроить автоматического оценщикаменьше 150 разметок: системы уже не различитьстатья авторов методаАвтоматическая оценка поиска с ответами людей ↗
синтетический пример банка
Шаг 2 · три поиска
Три поиска отвечают на разные вопросы: о коде, о смысле и о связях
Возьмём один вопрос: «кто владеет API переводов и от чего он зависит?». Поиск по словам находит карточку по точному имени API: так же он находит номера, коды и имена полей. Векторы ищут не по словам, а по смыслу и приносят похожее, здесь старую схему 2023 года. Граф показывает владельца и зависимости. По типу вопроса выбирают маршрут: какие поиски соберут пакет агенту. Граф помогает в вопросах о связях и мешает, когда нужен простой факт. В тесте банка слова и векторы вместе нашли 75 % нужных фрагментов, одни векторы 42 %, одни слова 66 %.
Выберите вопрос: ответят все три поиска
Что значит ошибка PAY‑4012 в API переводов?
нашёл код первым
- PAY‑4012: счёт получателя закрыт, перевод отклонёнКаталог API · коды ошибок
- ошибка 4012 при закрытом счёте получателяКод сервиса переводов
- клиент получил PAY‑4012 после смены счётаТикеты поддержки
принёс соседний код PAY‑4013
- PAY‑4013: счёт получателя заблокированКаталог API · коды ошибок
- PAY‑4021: превышен лимит переводаКаталог API · коды ошибок
- отклонённый перевод возвращается за 1 рабочий деньРегламент возврата v7
код не связь
- команда платежей → владеет → API переводовГраф · каталог сервисов
- API переводов → возвращает → коды PAY‑4xxxГраф · каталог API
- сервис переводов → вызывает → проверку на мошенничествоГраф · код
Маршрут: Поиск по словам
Пакет агенту в примере: три фрагмента
- PAY‑4012: счёт получателя закрыт, перевод отклонёнКаталог API · коды ошибок
- ошибка 4012 при закрытом счёте получателяКод сервиса переводов
- клиент получил PAY‑4012 после смены счётаТикеты поддержки
На этом вопросе код нашёл поиск по словам, а векторы принесли соседний код: для них PAY‑4012 и PAY‑4013 похожи. В тесте банка одни векторы нашли 42 % нужных фрагментов, слова 66 %. Гибридный поиск на своих данных: тест крупного банка ↗
- 42 / 66 / 75 / 81 %нужных фрагментов в первой сотневекторы, слова, вместе, вместе с разбором вопросатехнический блог крупного банкаГибридный поиск на своих данных: тест крупного банка ↗
- 60 → 63 и 65 → 61баллов ответа с графомпо вопросам о связях растут, по простым фактам падаютнаучное сравнениеГраф против векторного поиска: систематическое сравнение ↗
- 5,7 → 1,9 %пропусков нужного фрагментаконтекст к фрагменту, слова и переранжирование (найденное сортируют второй раз)блог разработчика моделиКонтекст к каждому фрагменту перед поиском ↗
синтетический пример банка
Шаг 3 · права и свежесть
Права сотрудника проверяют до того, как фрагмент попадёт к модели
У каждого фрагмента паспорт: источник, версия, владелец, срок действия и права. Ворота прав ставят до модели: фрагмент, на который у сотрудника нет прав, до модели доходить не должен. Всё, что получено из фрагмента, наследует его паспорт: рёбра графа, сводки, кэш ответов, память агента. Свежесть меряют двумя сроками: один для нового текста, другой для снятого доступа. У поставщика при узком доступе это около 2 и 72 часов.
Паспорт фрагмента
- Источник
- Регламент возврата ошибочных переводов
- Версия
- v7 от 12.09.2026
- Владелец
- методолог операций
- Статус
- действует
- Срок
- до выхода новой версии
- Права
- операции и поддержка
- Происхождение
- раздел 4.2, страница 6
- Источник
- Индекс
- Праваправа до модели
- Переранжирование
- Модель
Паспорт наследуют
- рёбра графа
- сводки
- кэш ответов
- память агента
такие сроки даёт поставщик корпоративного поиска, когда доступ узкий, то есть к отдельным разделам, и об изменениях не уведомляют. С уведомлениями поиск обновляется почти сразу. У банка свои сроки, и снимать доступ ему нужно быстрее, чем за 72 часа
В 10:00 сотрудника перевели: шесть путей должны замолчать
- поиск по словам
- векторы
- граф
- сводки
- кэш ответов
- память агента
Чат против регламента
В чате пишут «возврат за 3 дня», а регламент v7 даёт 5 рабочих дней. Агент отвечает по регламенту, главному источнику по переводам, и показывает, что в чате написано иначе. Обе версии остаются в индексе.
- ≈ 2 ч и ≈ 72 чтекст и права у поставщика при узком доступес уведомлениями об изменениях почти сразудокументация поставщикаОбновление текста и прав в корпоративном поиске ↗
- до 24 чдругой поставщик обновляет права полным обходомдокументация поставщикаПрава обновляются полным обходом ↗
- ≈ 164 судалённый документ жил в ответахпрепринт авторов методаУдалённый документ в ответах помощника ↗
мой порядок, не замер
Шаг 4 · бюджет индекса
Описания к фрагментам умножают чтение модели в 11 раз
При обогащении модель читает весь документ для каждого фрагмента и пишет описание, чтобы фрагмент находился по смыслу. Так документ в 8 000 токенов обходится в 88 500 токенов чтения, в 11 раз больше. Запись описаний, векторы и кэш в это число не входят, их считают отдельно. Весь бюджет индекса считают до старта. Граф в этот счёт не входит: его цену меряют в часах, за которые он строится, по условиям чужого сравнения.
Один документ
10 фрагментов × (8 000 документ + 800 фрагмент + 50 инструкция)
- 88 500модель читает
- 16 500с кэшем начала документа
- 1 000модель пишет описания
- 9 000модель векторов читает
8,85 млрдмодель читает
1,65 млрдс кэшем
100 млнпишет
900 млнвекторы
88,5 млнобновление 1 % документов
токенов
граф, часов построения
- 0,68 / 1,19 / 1,72 чуходит у трёх способов на граф из 1 млн токеновусловия сравнения: 2 карты по 80 ГБнаучное сравнениеНужен ли граф агенту: сравнение 2026 года с ценой построения ↗
- ≈ 75 %цены индекса уходит на извлечение графаоценка разработчика методадокументация разработчика методаСпособы построить граф и их цена ↗
- 0,1 %цены полного графа стоит отложенныйего строят по запросублог разработчика методаОтложенный граф: индекс за долю цены ↗
расчёт, допущения в тексте
Шаг 5 · модели в контуре
Модель для контура банка сначала проверяют по лицензии
Контур банка: свои серверы, без внешних сервисов. Там работают открытые модели: одни строят векторы, другие переранжируют найденное, третьи пишут ответы. Лицензия решает раньше скорости: одна открытая модель запрещает работу с банковской тайной. Разрешение по лицензии ещё не говорит о качестве на банковской задаче, его проверяют на своём эталоне. Потом считают память видеокарты: по расчёту весов и кэша модели на 8 млрд параметров нужно 35,7 ГБ при 4 запросах по 32 тыс. токенов. Это нижняя граница, буферы в расчёт не вошли. Хватит ли одной карты на 48 ГБ, показывает испытание под нагрузкой.
Нижняя граница памяти видеокарты: веса и кэш при 4 запросах по 32 тыс. токенов
веса кэш · нижняя граница: в расчёт вошли веса по 2 байта на параметр и кэш ключей и значений, буферы не вошли; хватит ли карт, показывает только испытание
Устройство открытой модели на 8 млрд ↗Устройство открытой модели на 14 млрд ↗Устройство открытой модели на 32 млрд ↗
- 5 832 токена/считает и пишет открытая русская модель-смесь на одной карте 80 ГБ32 параллельных запроса; из них 2 866 на записьзамер авторов моделиОткрытая русская модель-смесь: замер авторов ↗
- 35,7 / 51 / 99,9 ГБпамяти как минимум нужно моделям на 8, 14 и 32 млрд4 запроса по 32 тыс. токенов; карты: 1 × 48 ГБ, 1 × 80 ГБ, 2 × 80 ГБрасчёт, допущения в текстеУстройство открытой модели на 8 млрд ↗Устройство открытой модели на 32 млрд ↗
- +4,7 баллапереранжирование на русском17 наборовнаучное сравнениеПоиск на русском: 17 наборов ↗
карточка и лицензия модели
Шаг 6 · шлюз агентов
Шлюз проверяет описания инструментов в одном месте
Агенты просят контекст через один шлюз по MCP. Этот открытый протокол подключает их к данным и инструментам. Шлюз держит каталог серверов и четыре операции хранилища. Права на чтение и на действие у него отдельные, каждый вызов пишется в журнал. У описания каждого инструмента закрепляют версию. В научном сравнении без проверки описаний удавались до 72,8 % атак через их подмену.
- помощник разработчика
- агент по спецификации
- агент проверки кода
- каталог серверов
- права на чтение и на действие отдельно
- описания инструментов с версией
- журнал каждого вызова
Четыре операции хранилища
find_contextнайти контекст по вопросу и ролиget_evidenceполучить доказательство: фрагмент, источник, версиюexpand_entityраскрыть сущность: владелец, зависимостиget_source_versionвзять версию источника на дату
хранилище контекста
Один вызов: вопрос агента, операция, ответ хранилища
- до 72,8 %атак удаются без проверки, когда подменяют описание инструмента1 348 атак на 45 серверахнаучное сравнениеПодмена описаний инструментов: 1 348 атак ↗
- 150 тыс. → 2 тыс.токенов уходит на служебный контекст инструментовописания грузятся не все сразу, а по запросублог разработчика моделиИнструменты как код: служебный контекст в 75 раз меньше ↗
- 800+ и 5 000+серверов и инструментов за одним шлюзоминженерный блог компанииШлюз для серверов агентов в большой компании ↗
синтетический пример банка
Шаг 7 · оценка
Каждую ступень хранилища оставляют по замеру
Сначала на своём наборе вопросов ставят лесенку опытов: ступень остаётся, только если растёт доля решённых задач. В синтетическом примере доля растёт с 31 до 55 из 100. С графом для всех вопросов доля не выросла, поэтому граф получает только вопросы о связях. Парный разбор тех же задач показывает больше, чем итог: 52 решённые против 53 скрывают 7 новых побед и 8 потерь. Потом ступени проверяют A/B на живых задачах.
решено задач из 100
- без контекста31оставили
- поиск по словам38оставили
- слова и векторы46оставили
- переранжирование50оставили
- обогащение фрагментов53оставили
- граф для всех вопросов52не оставили: доля не выросла
- граф только для связей55оставили
Парный разбор 100 задач: без графа 53, граф для всех 52
- 45решили обе
- 7только с графом
- 8только без графа
- 40не решила ни одна
7 побед и 8 потерь разбирают по одной: каждая потеря становится вопросом эталона
- 0,564 → 0,625доля эталонных фактов, которая попадает в ответта же модель без поиска и с поискомнаучное сравнениеСвежие вопросы о коде: поиск и переранжирование ↗
- 63,7 → 75,0 %задач решает агент с памятью-плейбукомпрепринт авторов методаПамять-плейбук агента: доля решённых задач ↗
- 0,62 против 0,70насколько оценщик согласен с экспертами и эксперты между собойего настраивают по ответам людейнаучное сравнениеТонкая оценка ответов и согласие экспертов ↗
синтетический пример банка
Шаг 8 · команды
Хранилище предлагают командам без приказа
Гипотеза: команды подключаются сами, если своего помощника можно настроить за минуты. Её проверяет воронка подключения. У тех, кто работает на внутренней платформе, пропускная способность на 8 % ниже, чем у команд без платформы. Отраслевой отчёт связывает потери прежде всего с обязательной платформой. Воронка показывает, на каком шаге команды уходят. Главный шаг в ней: первая решённая задача.
- доступно
- подключились
- решили первую задачу
- работают через 12 недель
Что смотреть у каждой команды
- время до первой решённой задачи
- почему команда ушла (её словами)
- оценка после работы и доля ответивших
- удержание через 4, 8 и 12 недель
- меньше 5 минутчтобы настроить помощника командыинженерный блог компанииПомощник команды за 5 минут: внутренняя платформа ↗
- −8 %пропускной способности у пользователей платформособенно когда платформа обязательна на весь цикл разработкиотраслевое исследованиеЕжегодное исследование разработки: платформы ↗
- 29,6 %команд, которые строят платформы, не меряют успехотраслевое исследованиеОпрос платформенных команд: как меряют успех ↗
синтетический пример банка
Шаг 9 · план
Следующий этап начинают, когда предыдущий дал свою цифру
Мой порядок: четыре этапа по 2–4 недели, всего 12 недель, если ни один этап не повторяют. Между этапами ворота: этап должен дать свою цифру. Если этап не прошёл ворота, его повторяют, и срок растёт. О графе решают только по замеру в конце.
- недели 1–21сценарий, два‑три источника с владельцем, 300 вопросов эталонаэталон готов, у каждого источника владелец
- недели 3–62слова и векторы на одном сценарии, паспорт фрагмента, лесенка опытовдоля решённых задач выше, чем без контекста
- недели 7–93ворота прав, два срока свежести, шлюз и четыре операциикогда доступ отзывают, все шесть путей замолкают в срок
- недели 10–124A/B на живых задачах, решение о графе, воронка команд
не прошли ворота: этап повторяют, причину записывают в эталон
мой порядок, не замер
Как дать агенту больше самостоятельности, когда контекст готов? →
Ресурсы
По чему собрана страница: первоисточники и инструменты
Каждая цифра выше ведёт сюда. У ссылки вид источника и год.
Методы поиска
слова, векторы, граф и маршрут между ними
- Гибридный поиск на своих данных: тест крупного банка ↗инженерный блог · 2025
- Контекст к каждому фрагменту перед поиском ↗инженерный блог · 2024
- Граф против векторного поиска: систематическое сравнение ↗научная статья · 2026
- Нужен ли граф агенту: сравнение 2026 года с ценой построения ↗препринт · 2026
- Граф как память: сравнение методов и цены построения ↗научная статья · 2025
- Способы построить граф и их цена ↗документация · 2026
- Отложенный граф: индекс за долю цены ↗инженерный блог · 2024
- Длинное окно или поиск: маршрут по вопросу ↗научная статья · 2024
Оценка
эталон, оценщик и метрики поиска и ответа
- Длинное окно модели: где теряется нужное ↗научная статья · 2025
- Свежие вопросы о коде: поиск и переранжирование ↗научная статья · 2025
- Поиск на русском: 17 наборов ↗научная статья · 2025
- Автоматическая оценка поиска с ответами людей ↗научная статья · 2024
- Тонкая оценка ответов и согласие экспертов ↗научная статья · 2024
- Набор вопросов для проверки: опыт банка ↗выступление · 2025
- Как оценивать агентов: разбор разработчика модели ↗инженерный блог · 2026
- Метрики поиска и ответа: справочник ↗документация · 2026
- Меры качества поиска: определения ↗документация · 2026
Права и свежесть
сроки обновления текста и прав, утечки через индекс
- Обновление текста и прав в корпоративном поиске ↗документация · 2026
- Права обновляются полным обходом ↗документация · 2026
- Удалённый документ в ответах помощника ↗препринт · 2024
- Уязвимости векторов и эмбеддингов: перечень рисков ↗документация · 2025
Шлюз и протокол агентов
спецификация, безопасность, опыт большого шлюза
- Спецификация протокола подключения агентов ↗спецификация · 2026
- Безопасность протокола: лучшие практики ↗документация · 2026
- Подмена описаний инструментов: 1 348 атак ↗научная статья · 2026
- Инструменты как код: служебный контекст в 75 раз меньше ↗инженерный блог · 2025
- Шлюз для серверов агентов в большой компании ↗инженерный блог · 2026
Модели и лицензии
открытые модели для контура банка и их устройство
- Русская модель векторов ↗карточка модели · 2025
- Многоязычная модель с тремя режимами поиска ↗карточка модели · 2024
- Многоязычная модель векторов до 4 096 измерений ↗карточка модели · 2025
- Многоязычный переранжировщик ↗карточка модели · 2024
- Открытая русская модель-смесь: замер авторов ↗карточка модели · 2026
- Русская адаптация открытой модели на 32 млрд ↗карточка модели · 2025
- Русская адаптация открытой модели на 8 млрд ↗карточка модели · 2025
- Особая лицензия открытой русской модели ↗лицензия · 2025
- Устройство открытой модели на 8 млрд ↗карточка модели · 2025
- Устройство открытой модели на 14 млрд ↗карточка модели · 2025
- Устройство открытой модели на 32 млрд ↗карточка модели · 2025
- Кэш начала запроса на своём сервере моделей ↗документация · 2026
Память агента
что агент помнит между задачами
- Память-плейбук агента: доля решённых задач ↗препринт · 2025
- Слой памяти вместо полного диалога ↗препринт · 2025
Агенты-разработчики
контекст для агентов, которые пишут код
- Разработка по спецификации: открытый набор ↗документация · 2026
- Карта репозитория для агента ↗документация · 2026
- Агенты на больших кодовых базах: испытание ↗инженерный блог · 2026
Внутренние платформы
как команды подключаются и как это мерить
- Ежегодное исследование разработки: платформы ↗отраслевой отчёт · 2024
- Опрос платформенных команд: как меряют успех ↗отраслевой отчёт · 2025
- Помощник команды за 5 минут: внутренняя платформа ↗инженерный блог · 2025
- Внутренние платформы: открытое руководство ↗документация · 2026