Слогер Создать блог
Разработка

Как я победил галлюцинации, заменив AGENTS.md на AGENTS.db

Инженер из Exam Intelligence перешёл от текстовых инструкций к SQLite-базе, чтобы агент перестал выдумывать и начал работать чётко.

Прежде чем погрузиться в детали, немного контекста: как устроен наш агентный пайплайн в Exam Intelligence для глубокого анализа и генерации заметок.

Изначально я попытался создать полноценный end-to-end граф в LangGraph. Но постоянно возникали неожиданные баги из-за внешних факторов: отсутствующие PDF, невозможность найти статьи, ошибки парсинга, 503 ошибки или сломанный JSON. Казалось, что придётся писать отдельного агента-кодера только для обработки этих крайних случаев.

Решение

Вместо мастер-воркфлоу я переключился на создание CLI-инструментов, которые может использовать агент-кодер.

  • Настройка: Запуск qwen3.6:35b через Ollama внутри обвязки PI coding agents, работающей в Docker-песочнице.
  • Поток: Каждый файл — это узел (шаг или целый воркфлоу для достижения конкретного результата), и агент выполняет их один за другим.

Если что-то ломается, я предусмотрел 3 уровня исправлений:

  1. Уровень 1 (авто): Агент вручную делает работу (например, находит недостающий URL).
  2. Уровень 2 (авто): Агент обнаруживает краткосрочный повторяющийся паттерн и пишет скрипт для него.
  3. Уровень 3 (человек в цикле): Если агент находит баг в моих CLI-инструментах, он помечает его, предлагает исправление и останавливается, чтобы сохранить чистоту кода — ждёт моего одобрения перед редактированием.

Архитектура памяти

Не зная о стандартных соглашениях именования AGENTS.md, я изначально выбрал такую конфигурацию:

  • instructions.md: информировал агента о всём воркфлоу, архитектуре и том, как его выполнять.
  • memory.md: постоянная кросс-сессионная память агента, в основном хранящая, с какими багами/проблемами он столкнулся и как их исправил.
  • workflow_checkpoints.db: SQLite3 база данных, используемая как временное хранилище для воркфлоу, которая позже переносится в PostgreSQL (используется нашим Django-приложением) после проверок качества для изоляции продакшена.

Проблема

Агент начинал правильно, но когда доходило до миграции данных заметок в базу Django, всё ломалось. У меня был CLI-инструмент migrate.py, который агент мог вызывать (упомянутый в instructions.md), но он начинал использовать встроенный Python, делал синтаксические ошибки, мигрировал данные с битым форматированием, а иногда полностью пропускал миграцию некоторых таблиц.

После нескольких неудач я внёс следующие изменения:

  1. Добавил шаг планирования.
  2. Полностью переключил слой памяти на agents.db.

Вот схема базы:

ТаблицаКолонки
instructionsid, step_order, title, objective, actions, tools, success_criteria, created_at
memoriesid, title, step, tldr, problem, fix, created_at

Новая настройка движка

  • Таблица instructions полностью заменила instructions.md. Она даёт агенту изолированные пошаговые инструкции с чёткими целями, конкретными действиями, доступными CLI-инструментами и чётким определением успеха.
  • Таблица memories содержит опыт прошлых запусков: что сломалось и как это исправили.

Я предварительно заполнил таблицу memories всем, что пошло не так в предыдущих запусках, и тем, что агент должен был сделать в этих случаях, используя синтетические воспоминания.

Поток выполнения

Агенту было поручено проходить шаг за шагом по таблице instructions. Для каждого шага он запрашивает таблицу memories (просто получая tldr) как краткую сводку: что нужно сделать, как это сделать и что может пойти не так. Если он сталкивается с новой проблемой, просто добавляет её в memories.

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

Дополнительные рекомендации

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

Налог на гибкость

Использование обвязки PI coding agents в качестве оркестратора добавляет гибкости, но делает всё слишком непредсказуемым. Несмотря на то, что поток в основном иерархический, я теперь застрял на том, что прошу его выполнить полный прогон, ловлю галлюцинации и обновляю memories...

По материалам: dev.to. Текст переработан редакцией Слогера.

← На главную

Рекламное место — Конец поста
Реклама · Слогер

Комментарии (0)

Войдите, чтобы комментировать.

Пока нет комментариев. Будьте первым.

Личный опыт

Как довести до конца одно незаконченное дело: метод одной даты

Назвать брошенный проект конкретными словами, поставить реальную дату и договориться с кем-то, кто спросит один раз. Разбор простой механики, которая чаще срабатывает, чем очередной таск-менеджер.

Слогер 19.11.2026 ▲ 0
Карьера

Как автоматизировать отклики на вакансии: разбор автозаполнения заявок на Greenhouse, Lever и Ashby

Расширение для Chrome берёт на себя формы, которые вы заполняете десятый раз подряд, — но работает только на трёх системах найма и требует собственных ответов. Разбираем механику, цену и границы.

Слогер 18.11.2026 ▲ 0
Карьера

Как выбрать между двумя офферами на стажировку: разбор по шагам

Два оффера одновременно — хорошая проблема, которая всё равно выматывает. Вот порядок действий: приоритеты, реальные задачи, деньги после аренды, разговор с бывшим стажёром и честная просьба об отсрочке.

Слогер 18.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Стартапы

Fluxs включён в реестр российского ПО Минцифры России

🇷🇺 **Fluxs официально включён в реестр российского ПО!** Наша платформа для управления бизнесом вошла в Единый реестр российских программ Минцифры России. Это важный этап развития Fluxs и новые возможности для сотрудничества с российскими компаниями, банками и организациями, заинтересованными в импортозамещении.

Слогер 17.11.2026 ▲ 0
Разработка

Как получить от клиента согласование сайта на staging: чек-лист приёмки

Устное «выглядит хорошо» в мессенджере не защищает никого: через месяц не вспомнить, что именно смотрели и на какой версии. Вот как превратить просмотр staging в нормальную запись о приёмке.

Слогер 17.11.2026 ▲ 0
Карьера

WARN Act: как работает закон о сокращениях и что делать, если уведомление не пришло

Федеральный WARN Act обязывает крупных работодателей предупреждать о закрытии предприятия или массовом сокращении за 60 дней. Разбираем пороги, исключения и порядок действий — на примере отрасли вывоза и переработки отходов, где сокращения легко пропустить.

Слогер 17.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как читать WARN-уведомления о сокращениях: разбор календаря увольнений на 2027 год

Пересчёт уведомлений с датами вступления в силу в 2027 году дал 4 950 человек вместо 2 882 — и это всё ещё нижняя граница. Разбираем, откуда берётся разница в 42% и как не обмануться такой статистикой.

Слогер 17.11.2026 ▲ 0
Разработка

Заменит ли ИИ программиста: что показывают исследования и как выбрать между ИИ и разработчиком

Вопрос «зачем платить разработчику, если ИИ пишет код» построен на неверном представлении о работе программиста. Разбираем два исследования, цену такого заблуждения и практический чек-лист.

Слогер 17.11.2026 ▲ 0
Стартапы

Почему сотрудники забывают задачи и как это исправить | FLUXS

📌 **Почему сотрудники забывают поручения, даже когда всё записано?** Задача поставлена. Сотрудник записал. Срок прошёл. Результата нет. Такая ситуация встречается часто, и часто проблема не в дисциплине, а в отсутствии прозрачной системы управления задачами. Кто исполнитель? Какой срок? На каком этапе работа? 🚀 **FLUXS помогает управлять поручениями и выстраивать бизнес-процессы под правила вашей компании.** А встроенный ИИ-ассистент помогает создавать и настраивать процессы выполнения задач. 👉 Попробуйте конструктор бизнес-модели: https://fluxs.ru/konstruktor-biznes-modeli #FLUXS #УправлениеЗадачами #АвтоматизацияБизнеса #БизнесПроцессы

Слогер 16.11.2026 ▲ 1
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как делиться опытом, если вы не эксперт: ловушка «об этом уже написали» и рабочие форматы

Мешает делиться знаниями не их дефицит, а мысль, что они недостаточно весомые. Разбираем, что считать полезным вкладом, как писать конкретно и с чего начать без давления.

Слогер 16.11.2026 ▲ 0