Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Yandex Managed Service for YDB
  • Начало работы
    • Все руководства
    • Развертывание веб-приложения
    • Подключение к YDB из функции Yandex Cloud Functions на Python
    • Подключение к базе данных YDB из функции Yandex Cloud Functions на Node.js
    • Разработка навыка Алисы и сайта с авторизацией
    • Миграция базы данных из Yandex Managed Service for MySQL® с помощью Yandex Data Transfer
    • Поставка данных из YDB в Yandex Managed Service for Apache Kafka® с помощью Yandex Data Transfer
    • Поставка данных из YDB в Yandex Data Streams с помощью Yandex Data Transfer
    • Загрузка данных из Yandex Object Storage в YDB с помощью Yandex Data Transfer
    • Загрузка данных из YDB в Yandex Object Storage с помощью Yandex Data Transfer
    • Загрузка данных из YDB в Yandex Managed Service for ClickHouse® с помощью Yandex Data Transfer
    • Миграция данных из Yandex Managed Service for OpenSearch в YDB с помощью Yandex Data Transfer
    • Построение пайплайна CI/CD в GitLab с использованием serverless-продуктов
    • Поставка данных из Yandex Managed Service for PostgreSQL в Yandex Managed Service for YDB с помощью Yandex Data Transfer
    • Передача событий Yandex Cloud Postbox в Yandex Data Streams и их анализ с помощью Yandex DataLens
    • Поставка данных из Yandex Managed Service for Apache Kafka® в Data Streams с помощью Yandex Data Transfer
    • Поставка данных из Yandex Managed Service for Apache Kafka® с помощью Yandex Data Transfer
    • Сохранение потока данных Data Streams в Managed Service for ClickHouse®
    • Поставка данных из очереди Data Streams в Managed Service for Apache Kafka® с помощью Data Transfer
    • Поставка данных из очереди Data Streams в Managed Service for YDB с помощью Data Transfer
    • Захват изменений MySQL® и поставка в YDS
    • Захват изменений PostgreSQL и поставка в YDS
    • Интерактивная отладка функций Cloud Functions
    • Блокировка состояний Terraform с помощью Managed Service for YDB
    • Разработка пользовательской интеграции в API Gateway
    • Разработка CRUD API для сервиса фильмов
    • Создание интерактивного serverless-приложения с использованием WebSocket
    • Интеграция Yandex Cloud Postbox с внешними системами через вебхуки
    • Память, RAG и семантический кеш для ИИ-агента с Managed Service for YDB в режиме Serverless
    • Развертывание кластера YDB во внешней инфраструктуре
  • Управление доступом
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Вопросы и ответы
  • Публичные материалы
  • Обучающие курсы

В этой статье:

  • Перед началом работы
  • Необходимые платные ресурсы
  • Как устроен агент
  • Состав решения
  • Схема обработки сообщения
  • Разверните агента
  • Создайте базу данных и сервисный аккаунт функции
  • Разверните функцию
  • Запустите локальный интерфейс
  • API функции
  • Сообщение агенту
  • Загрузка документа
  • Долговременная память
  • Эмбеддинги для памяти
  • RAG по документам
  • Семантический кеш
  • Ограничения кеша
  • Память для ИИ-агента через MCP
  • Пространства имен
  • Подключите MCP-сервер
  • Параметры сервера
  • Проверьте память
  • Просмотрите данные агента
  • Как удалить созданные ресурсы
  1. Практические руководства
  2. Память, RAG и семантический кеш для ИИ-агента с Managed Service for YDB в режиме Serverless

Память, RAG и семантический кеш для ИИ-агента с Managed Service for YDB в режиме Serverless

Статья создана
Yandex Cloud
Обновлена 18 ноября 2026 г.
Открыть в Markdown
  • Перед началом работы
    • Необходимые платные ресурсы
  • Как устроен агент
    • Состав решения
    • Схема обработки сообщения
  • Разверните агента
    • Создайте базу данных и сервисный аккаунт функции
    • Разверните функцию
    • Запустите локальный интерфейс
  • API функции
    • Сообщение агенту
    • Загрузка документа
  • Долговременная память
    • Эмбеддинги для памяти
  • RAG по документам
  • Семантический кеш
    • Ограничения кеша
  • Память для ИИ-агента через MCP
    • Пространства имен
    • Подключите MCP-сервер
    • Параметры сервера
    • Проверьте память
  • Просмотрите данные агента
  • Как удалить созданные ресурсы

В этом руководстве вы развернете ИИ-агента, который использует одну базу данных Yandex Managed Service for YDB в режиме Serverless для трех задач:

  • Хранение долговременной памяти.
  • Поиск по фрагментам документов для RAG.
  • Семантический кеш.

Код агента находится в репозитории ydb-serverless-webinar-ai. Если вы не хотите писать код агента самостоятельно, в разделе Память для ИИ-агента через MCP описано, как подключить ту же базу данных к готовому агенту.

Перед началом работыПеред началом работы

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

  1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
  2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

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

Подробнее об облаках и каталогах.

Необходимые платные ресурсыНеобходимые платные ресурсы

В стоимость инфраструктуры для этого руководства входит плата за использование Managed Service for YDB в режиме Serverless и генерацию текста моделью YandexGPT (тарифы Yandex Managed Service for YDB и тарифы Yandex AI Studio).

В режиме Serverless вы оплачиваете выполненные запросы и объем хранимых данных. Время работы серверов не тарифицируется. Бесплатный лимит каждый месяц включает миллион единиц запросов (request units) и 1 ГБ хранения. Этого объема хватает для разработки и демонстрации агента.

При попадании в кеш функция вычисляет один эмбеддинг вопроса и читает одну запись из таблицы вместо генерации ответа моделью. Чем длиннее ответ модели, тем больше вы экономите на каждом попадании в кеш.

В демонстрации агент использовал модель YandexGPT Pro 5.1. Демонстрационный диалог израсходовал 9 000 входящих и 1 500 исходящих токенов. Актуальные цены на модели приведены в правилах тарификации Yandex AI Studio.

Как устроен агентКак устроен агент

Языковая модель обрабатывает каждый запрос независимо и не хранит состояние между запросами. Поэтому агент хранит память во внешнем хранилище. Долговременная память, поиск по документам (RAG) и семантический кеш выполняют одну операцию. Они сохраняют эмбеддинги текстов и ищут ближайшие векторы по косинусной близости. Близкие по смыслу тексты получают близкие векторы.

Задачи различаются только данными, которые агент векторизует и возвращает:

  • Память векторизует факты о пользователе и возвращает похожие на запрос факты.
  • RAG векторизует фрагменты документов и возвращает фрагменты, релевантные запросу пользователя.
  • Семантический кеш векторизует вопросы пользователя и возвращает сохраненные ответы модели.

Поэтому агент хранит данные всех трех задач в одной СУБД Managed Service for YDB, в таблицах memories, rag_documents и semantic_cache. Функция агента создает эти таблицы автоматически при первом обращении к ним.

Состав решенияСостав решения

  • Логика агента работает в одной функции Yandex Cloud Functions с точкой входа index.handler.
  • Ответы генерирует модель YandexGPT, которую задает переменная LLM_MODEL со значением yandexgpt-5.1 по умолчанию.
  • Эмбеддинги вычисляют модели YandexGPT Embeddings text-search-query и text-search-doc.
  • Библиотека mem0 извлекает факты из сообщений и управляет долговременной памятью.
  • Библиотека langchain-ydb записывает векторы в Managed Service for YDB и выполняет поиск по ним.
  • Локальный чат на Gradio из файла ui.py отправляет сообщения пользователя в функцию.

Схема обработки сообщенияСхема обработки сообщения

  1. Если сообщение длиннее 20 символов, функция ищет похожий вопрос в семантическом кеше. При попадании в кеш функция сразу возвращает сохраненный ответ и пропускает остальные шаги.
  2. Функция извлекает из памяти факты о пользователе, которые относятся к его сообщению.
  3. Функция дополняет сообщение найденными фактами и ищет по этому запросу фрагменты документов.
  4. Модель YandexGPT генерирует ответ по системному промпту, в который функция добавила факты и фрагменты.
  5. Библиотека mem0 извлекает из сообщения новые факты и сохраняет их в память.
  6. Если сообщение длиннее 20 символов, функция сохраняет ответ модели в семантический кеш.

Разверните агентаРазверните агента

Агент использует два сервисных аккаунта с разными ролями. Первый аккаунт работает от имени функции и обращается к Managed Service for YDB и YandexGPT, а второй аккаунт вызывает функцию из локального интерфейса.

Создайте базу данных и сервисный аккаунт функцииСоздайте базу данных и сервисный аккаунт функции

Консоль управления
  1. В консоли управления выберите каталог, в котором будете создавать ресурсы.
  2. Перейдите в сервис Managed Service for YDB.
  3. Нажмите кнопку Создать базу данных и выберите тип Serverless.
  4. Задайте имя базы данных и нажмите кнопку Создать базу данных.
  5. Дождитесь запуска базы данных. В процессе создания база имеет статус Provisioning, а когда готова к использованию — статус меняется на Running.
  6. Сохраните значения полей Эндпоинт и Путь к базе данных. Из эндпоинта возьмите хост и порт для переменных окружения YDB_HOST и YDB_PORT. Значение поля пути задает переменную YDB_DATABASE.
  7. Перейдите в сервис Identity and Access Management.
  8. На панели слева выберите Сервисные аккаунты.
  9. Нажмите кнопку Создать сервисный аккаунт и создайте сервисный аккаунт с ролями ydb.editor и ai.languageModels.user. Роль ydb.editor дает доступ к Managed Service for YDB, роль ai.languageModels.user разрешает вызывать YandexGPT и модели эмбеддингов.
  10. На панели сверху нажмите кнопку Создать новый ключ и выберите пункт Создать API-ключ.
  11. Нажмите кнопку Создать.
  12. Сохраните значение секретного ключа — он понадобится для переменной окружения YANDEX_API_KEY.
  13. Нажмите кнопку Закрыть.
  14. На панели сверху нажмите кнопку Создать новый ключ и выберите пункт Создать авторизованный ключ.
  15. Выберите алгоритм шифрования и нажмите кнопку Создать.
  16. В открывшемся окне нажмите кнопку Скачать файл с ключами и сохраните файл — он понадобится для переменной окружения YDB_SA_KEY.
  17. Нажмите кнопку Закрыть.

Разверните функциюРазверните функцию

  1. Клонируйте репозиторий ydb-serverless-webinar-ai:

    git clone https://github.com/ydb-platform/ydb-serverless-webinar-ai
    cd ydb-serverless-webinar-ai
    
  2. Упакуйте содержимое папки layers/ в архив:

    cd layers
    zip -r ../function.zip .
    cd ..
    
  3. Создайте функцию:

    Консоль управления
    1. В консоли управления выберите каталог, в котором будете создавать функцию.
    2. Перейдите в сервис Cloud Functions.
    3. Нажмите кнопку Создать функцию.
    4. Введите имя функции и нажмите кнопку Создать.
    5. Перейдите на вкладку Редактор и создайте версию функции:
      1. В поле Среда выполнения выберите Python / 3.12.

      2. В поле Источник кода выберите ZIP-архив.

      3. В поле Файл прикрепите архив function.zip. Архив содержит код функции и файл requirements-agent.txt с зависимостями, которые будут установлены автоматически.

      4. В поле Точка входа укажите index.handler.

      5. В блоке Параметры задайте переменные окружения:

        • YANDEX_API_KEY — API-ключ сервисного аккаунта функции.
        • YANDEX_FOLDER_ID — идентификатор каталога, в котором работают Managed Service for YDB и функция.
        • YDB_HOST — адрес эндпоинта Managed Service for YDB. Для режима Serverless укажите ydb.serverless.yandexcloud.net.
        • YDB_PORT — порт эндпоинта Managed Service for YDB. Для режима Serverless укажите 2135.
        • YDB_DATABASE — путь к базе данных Managed Service for YDB в формате /ru-central1/<идентификатор_каталога>/<имя_базы_данных>.
        • YDB_SA_KEY — содержимое файла с авторизованным JSON-ключом сервисного аккаунта функции, записанное одной строкой.

        Необязательные переменные MEMORY_THRESHOLD, CACHE_THRESHOLD и LLM_MODEL меняют пороги памяти и кеша и модель генерации.

      6. Нажмите кнопку Сохранить изменения.

    6. Перейдите на вкладку Обзор и сохраните значение поля Ссылка для вызова — оно понадобится для подключения локального интерфейса.

Запустите локальный интерфейсЗапустите локальный интерфейс

  1. Создайте второй сервисный аккаунт с ролью functions.functionInvoker и скачайте его авторизованный JSON-ключ. Локальный интерфейс вызывает функцию от имени этого сервисного аккаунта.

    Консоль управления
    1. В консоли управления выберите каталог, в котором находится функция.
    2. Перейдите в сервис Identity and Access Management.
    3. На панели слева выберите Сервисные аккаунты.
    4. Нажмите кнопку Создать сервисный аккаунт и создайте сервисный аккаунт с ролью functions.functionInvoker.
    5. На панели сверху нажмите кнопку Создать новый ключ и выберите пункт Создать авторизованный ключ.
    6. Выберите алгоритм шифрования и нажмите кнопку Создать.
    7. В открывшемся окне нажмите кнопку Скачать файл с ключами и сохраните файл.
    8. Нажмите кнопку Закрыть.
  2. Установите зависимости интерфейса и создайте файл .env из шаблона:

    pip install -r requirements-ui.txt
    cp .env.ui.example .env
    
  3. Укажите в файле .env значения двух переменных окружения:

    • YC_FUNCTION_URL содержит URL функции, которую вы развернули.
    • YC_SA_KEY_PATH содержит путь к JSON-ключу второго сервисного аккаунта, если функция приватная.
  4. Запустите интерфейс командой python ui.py и откройте в браузере адрес http://localhost:7860.

  5. Чтобы наполнить RAG, откройте в интерфейсе раздел Загрузить документ в базу знаний и загрузите файл data/cafe_menu.txt.

API функцииAPI функции

Функция принимает HTTP-запросы с объектом JSON в теле и обрабатывает запросы двух видов.

Сообщение агентуСообщение агенту

{"message": "Заказываю пиццу на отдел. Какие пиццы и сколько штук взять?", "user_id": "alice"}

Поле message обязательно. Поле user_id по умолчанию принимает значение demo. Функция возвращает ответ агента в поле answer и сведения об обработке в поле meta:

  • meta.cache_hit принимает значение true, если ответ пришел из семантического кеша.
  • meta.memories_used показывает, сколько фактов из памяти функция передала модели.
  • meta.docs_used показывает, сколько фрагментов документов функция передала модели.

При попадании в кеш в поле meta остается только cache_hit.

Загрузка документаЗагрузка документа

{"action": "ingest", "text": "<текст документа>", "source": "cafe_menu.txt"}

Функция возвращает число сохраненных фрагментов в поле chunks_added. Поле source по умолчанию принимает значение upload и попадает в метаданные каждого фрагмента.

Если тело запроса содержит некорректный JSON или в сообщении нет поля message, функция возвращает код 400 и описание ошибки в поле error.

Долговременная памятьДолговременная память

Библиотека mem0 вызывает языковую модель, чтобы извлечь из сообщения атомарные факты, например «в отделе четыре разработчика, любят острое». Затем mem0 сохраняет каждый факт в таблицу memories через langchain-ydb. Инструкция для mem0 требует сохранять факты на русском языке и заводить отдельную запись на каждого человека или роль в группе. Функция подключает YandexGPT к mem0 через эндпоинт https://llm.api.cloud.yandex.net/v1, совместимый с OpenAI.

Функция recall ищет восемь ближайших к сообщению фактов. Модели она передает только те факты, чья косинусная близость не ниже порога MEMORY_THRESHOLD. По умолчанию порог равен 0,15. Мы подобрали это значение для демонстрационного сценария. После ответа функция remember передает сообщение в mem0, которая извлекает и сохраняет новые факты.

Поиск фактов фильтрует записи по полю user_id, поэтому каждый пользователь получает только свои факты. Если агент запомнил состав отдела для одного пользователя, другой пользователь с тем же вопросом получит ответ без этих фактов.

Эмбеддинги для памятиЭмбеддинги для памяти

Модели эмбеддингов YandexGPT образуют асимметричную пару: text-search-query векторизует короткие запросы, text-search-doc — длинные документы. Память сравнивает между собой однородные тексты, поэтому для нее функция векторизует обе стороны моделью text-search-query. На парах из двух фактов асимметричные эмбеддинги дают косинусную близость около 0,22. Симметричные эмбеддинги поднимают ее примерно до 0,51.

RAG использует асимметричную пару, потому что сравнивает короткий запрос с фрагментами документов. Семантический кеш векторизует моделью text-search-query и сохраненные вопросы, и новые вопросы пользователя.

RAG по документамRAG по документам

Документы хранятся по тому же принципу, что и факты памяти, но функция обрабатывает их без библиотеки mem0. Функция ingest делит текст на фрагменты по пустым строкам, то есть по абзацам. Затем она записывает фрагменты в таблицу rag_documents пакетами по пять штук. Между пакетами функция ждет полторы секунды, чтобы не превысить ограничение скорости модели эмбеддингов. Каждый фрагмент получает метаданные с источником документа и номером фрагмента.

Функция retrieve ищет шестнадцать фрагментов, ближайших к запросу по косинусной близости. Перед поиском функция дополняет сообщение пользователя фактами из памяти. Если память хранит факт о непереносимости лактозы у архитектора, поиск по меню находит блюда без молока, даже когда вопрос об этом не упоминает. Таблица rag_documents общая для всех пользователей, поиск по ней не фильтрует записи по user_id.

Для проверки RAG репозиторий содержит меню выдуманного кафе «5 девяток» в файле data/cafe_menu.txt. Модель не видела этого меню при обучении, поэтому названия блюд и цены в ответах агента приходят из RAG.

Семантический кешСемантический кеш

Семантический кеш сокращает число обращений к модели, когда пользователь повторяет вопрос другими словами. Функция векторизует вопрос пользователя и сохраняет вектор вместе с текстом ответа модели в таблицу semantic_cache. Записи всех пользователей хранятся в одной таблице. Поиск фильтрует их по полю user_id.

При новом запросе функция ищет самый похожий сохраненный вопрос этого пользователя. Если косинусная близость не ниже порога CACHE_THRESHOLD, функция возвращает сохраненный ответ и не вызывает модель. По умолчанию порог равен 0,65. Кеш обрабатывает только сообщения длиннее 20 символов.

Например, пользователь задает три вопроса: «Подойдет ли этот напиток всем коллегам в нашем отделе?», «Это универсальный выбор для всей команды?» и «Нужен один напиток на всех, можно ли остановиться на нем?». На первый вопрос отвечает модель, ответы на второй и третий вопросы функция берет из кеша. Вопросы не совпадают по словам, но функция сопоставляет их по близости векторов.

Ограничения кешаОграничения кеша

Мы подобрали порог 0,65 и минимальную длину сообщения в 20 символов для демонстрационного сценария. Для вашей нагрузки их нужно подобрать заново. Семантический кеш может вернуть ответ на похожий вопрос, который отличается деталью, меняющей результат.

В продакшене подберите порог по реальному трафику, задайте время жизни записей (TTL) и сбрасывайте кеш при изменении данных. Для сценариев, в которых ошибка в ответе недопустима, отключите кеш. Демонстрационная реализация не поддерживает TTL и сброс кеша и показывает только механику кеширования.

Память для ИИ-агента через MCPПамять для ИИ-агента через MCP

MCP-сервер mcp-memory-ydb хранит долговременную память агента в Managed Service for YDB в режиме Serverless. Сервер работает с любым агентом, который поддерживает MCP-серверы, например с Claude Code или ИИ-ассистентом SourceCraft Code Assistant. Агент самостоятельно сохраняет и ищет факты, пользователь не вызывает инструменты вручную.

Сервер предоставляет агенту четыре инструмента:

  • memory_search(query, limit) ищет факты по смыслу запроса и возвращает их вместе с идентификаторами.
  • memory_save(text) передает текст в mem0, которая извлекает из него факты и сохраняет их.
  • memory_delete(memory_id) удаляет устаревший или замененный факт по его идентификатору.
  • memory_update(memory_id, text) заменяет текст факта с указанным идентификатором на новый.

Библиотека mem0 только добавляет факты и не перезаписывает старые. Чтобы исправить устаревший факт, агент находит его через memory_search и удаляет или обновляет по идентификатору.

Пространства именПространства имен

Сервер хранит все факты в пространстве имен. Его задает переменная MEMORY_NAMESPACE, значение по умолчанию — default. Агент не выбирает пространство имен, поэтому не может прочитать или записать факты другого пространства имен. Чтобы разделить память проектов, запустите для каждого проекта отдельный экземпляр сервера со своим пространством имен.

Пространство имен фильтрует запросы и не ограничивает доступ к данным. Любой, у кого есть доступ к Managed Service for YDB, может прочитать все пространства имен. Поэтому запускайте собственный экземпляр сервера на собственной СУБД.

Подключите MCP-серверПодключите MCP-сервер

  1. Создайте сервисный аккаунт с ролью ydb.editor и скачайте его авторизованный JSON-ключ.

  2. Запустите мастер настройки, который создаст файл ~/.mcp-memory-ydb.env с параметрами подключения:

    git clone https://github.com/ydb-platform/mcp-memory-ydb
    cd mcp-memory-ydb
    uvx --from . mcp-memory-ydb setup
    
  3. Подключите сервер:

    Claude Code
    SourceCraft Code Assistant

    Выполните команду, указав путь к склонированному репозиторию сервера:

    claude mcp add --scope user memory-ydb -- uvx --from /path/to/mcp-memory-ydb mcp-memory-ydb
    

    Затем выполните команду /mcp.

    Подключите MCP-сервер через настройки SourceCraft. Подробнее — в документации SourceCraft.

  4. Убедитесь, что сервер memory-ydb подключен и агенту доступны четыре инструмента.

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

Before answering, call memory_search for relevant context about the user.
After answering, call memory_save if you learned something important.
Use these tools silently — do not announce or narrate searching or saving.
Save facts in the user's own language, without translating.

Параметры сервераПараметры сервера

Мастер настройки записывает параметры в файл ~/.mcp-memory-ydb.env, сервер читает их при запуске:

  • LLM_BASE_URL — адрес провайдера модели. Для YandexGPT укажите https://llm.api.cloud.yandex.net/v1.
  • LLM_MODEL — модель, которая извлекает факты, например gpt://<идентификатор_каталога>/yandexgpt/latest.
  • LLM_API_KEY — API-ключ, с которым сервер обращается к провайдеру модели.
  • EMBEDDINGS_MODEL — модель эмбеддингов, например emb://<идентификатор_каталога>/text-search-query/latest.
  • YDB_ENDPOINT — эндпоинт Managed Service for YDB. Для режима Serverless укажите grpcs://ydb.serverless.yandexcloud.net:2135.
  • YDB_DATABASE — путь к Managed Service for YDB в формате /ru-central1/<идентификатор_каталога>/<имя_базы_данных>.
  • YDB_SA_KEY_FILE — путь к авторизованному JSON-ключу сервисного аккаунта.
  • MEMORY_NAMESPACE — пространство имен, в котором сервер хранит и ищет факты.
  • MEMORY_THRESHOLD — минимальная косинусная близость найденного факта, по умолчанию 0,15.

mem0 по умолчанию сохраняет факты на английском языке. Чтобы факты сохранялись на русском языке, задайте переменную MEMORY_FACT_INSTRUCTIONS с инструкцией на русском языке:

MEMORY_FACT_INSTRUCTIONS=Сохраняй каждый факт на языке исходного сообщения, не переводи.

Остальные параметры, включая тайм-ауты, перечислены в README сервера.

Проверьте памятьПроверьте память

  1. В первой сессии сообщите агенту решение по проекту, например что цены в демонстрационном меню намеренно указаны в токенах.
  2. Убедитесь, что агент вызвал инструмент memory_save и сохранил факт в Managed Service for YDB.
  3. Откройте новую сессию и спросите агента, стоит ли перевести цены из токенов в рубли.
  4. Убедитесь, что агент вызвал инструмент memory_search, нашел сохраненное решение и учел его в ответе.

Ответ агента зависит от наличия факта в Managed Service for YDB. Сам факт не хранится ни в коде проекта, ни в истории Git.

Просмотрите данные агентаПросмотрите данные агента

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

Вы можете прочитать данные агента SQL-запросом в консоли, через YDB CLI, из BI-инструмента или через MCP-сервер Managed Service for YDB. Так вы проверите, какие факты агент сохранил о пользователе.

Как удалить созданные ресурсыКак удалить созданные ресурсы

Если созданные ресурсы больше не нужны, удалите их:

  1. Удалите функцию.
  2. Удалите базу данных Managed Service for YDB.
  3. Удалите сервисные аккаунты, созданные для функции и локального интерфейса.

Полезные ссылкиПолезные ссылки

  • Репозиторий демонстрационного агента — код функции, интерфейс и сценарий проверки.
  • Репозиторий mcp-memory-ydb — код MCP-сервера и полный список его параметров.
  • Векторный поиск в Managed Service for YDB — подробнее о векторном поиске в документации Managed Service for YDB.

ИИ-агенты (AI Agents) — автономные системы, способные воспринимать среду, принимать решения и выполнять сложные последовательности задач (например, писать код, тестировать его и исправлять ошибки) для достижения поставленной цели. Подробнее об ИИ-агентах — в облачном глоссарии.

RAG (Retrieval-Augmented Generation) — генерация с поиском: подход, при котором языковая модель для ответа на запрос пользователя использует результаты поиска в базе данных. Подробнее о RAG-сценариях — в документации AI Studio.

MCP (Model Context Protocol) — открытый стандарт, который подключает AI-приложения к внешним системам: инструментам, источникам данных и сервисам. Подробнее о MCP — в облачном глоссарии.

Была ли статья полезна?

Предыдущая
Интеграция Yandex Cloud Postbox с внешними системами через вебхуки
Следующая
Развертывание кластера YDB во внешней инфраструктуре
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»