Написать в Telegram

Obsidian как бэкенд для ИИ-агентов: хранилище, которое само ведёт записи. Пошагово

Содержание
  1. Что получится в итоге
  2. Почему это просто файлы, и это хорошо
  3. Шаг 1. Разделите хранилище на две зоны
  4. Шаг 2. В каждой папке положите файл AGENTS.md
  5. Шаг 3. Заставьте агентов вести журнал
  6. Шаг 4. Пусть цифры собирают скрипты
  7. Шаг 5. Увидьте в заметках таблицу
  8. Шаг 6. Не сваливайте весь контекст в чат
  9. Шаг 7. Поставьте интерфейс поверх файлов
  10. Если вы работаете из России
  11. Что важно знать до старта
  12. Три вещи, на которых всё держится

Заметки у большинства копятся годами. Записали идею, сохранили статью, завели папку, и через месяц туда никто не заглядывает. Такой «второй мозг» нужно кормить каждый день, а отдачи почти нет. А если добавить ИИ-агента, он нередко устраивает кашу: пересказывает ваши мысли по-своему, и вы уже не знаете, что в записи вы, а что модель.

Есть другой подход: смотреть на Obsidian не как на блокнот, а как на бэкенд. Это обычная папка с текстовыми файлами, в которой данные собирают скрипты, работу журналируют агенты, а сверху можно поставить свой интерфейс. Заметки перестают пылиться и сами подсказывают, что делать. Схема не привязана к одному инструменту: в примере с ней работают Claude Code, Codex, Pi и Hermes, а подойдёт любой агент, который умеет читать и писать файлы.

Разберём, как это устроено по шагам.

Что получится в итоге

Хранилище Obsidian, в котором:

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

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

Почему это просто файлы, и это хорошо

Хранилище Obsidian это папка. Внутри обычные текстовые файлы в формате markdown. Базы данных нет, облака нет. Отсюда главное преимущество: всё принадлежит вам. Ничего нельзя отключить по подписке, а любой инструмент может читать и писать эти файлы. Сменили агента, и не нужно переносить ни память, ни историю переписки. Всё лежит там же, где лежало.

Шаг 1. Разделите хранилище на две зоны

Первое правило: ваши идеи и «идеи» робота хранятся отдельно. Агенты склонны объединять и сокращать то, что вы не просили сокращать. И вы уже не поймёте, где ваша мысль, а где то, что модель решила считать вашей мыслью.

Поэтому хранилище делится на две части:

  • Человеческая. Дневные заметки, задачи, проекты, люди, контекст, шаблоны, материалы для контента. Агент может переносить и копировать, но писать и править здесь не должен.
  • Машинная. Скрипты, журналы, исследования, рабочие процессы, результаты. Тут агент свободен: читает, пишет, правит. Если он наведёт беспорядок, это не страшно.
Машинная зона хранилища: скрипты, журналы и исследования, где агенту можно всё
Машинная зона хранилища: скрипты, журналы и исследования, где агенту можно всё

В примере это выглядит так: папка 00 Human с подпапками 10 Daily Notes, 20 Tasks, 30 Projects, 40 Resources, 50 People, 70 Context, 80 Templates, 90 Content. И отдельная папка Machine с подпапками Outputs, Scripts и Workflows.

Шаг 2. В каждой папке положите файл AGENTS.md

Это инструкция для агента: что в этом разделе лежит, что можно трогать, а что нельзя и как здесь работать. Файл лежит в корне хранилища и в корне каждой папки. Читать его будет любой агент, будь то Claude Code, Codex или другой.

Корневой файл служит картой и сводом правил. Он прямо говорит: не читай всё хранилище ради контекста, возьми только то, что нужно для задачи. А ещё в нём проведена жёсткая граница между двумя зонами.

Корневой файл AGENTS.md: карта хранилища и граница между человеческой и машинной зонами
Корневой файл AGENTS.md: карта хранилища и граница между человеческой и машинной зонами

Если агент сомневается, куда положить файл, он кладёт его в машинную зону. Перенести в человеческую вы можете сами. Чужие слова агенту нельзя сокращать и «причёсывать».

Шаг 3. Заставьте агентов вести журнал

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

  1. Запиши, что сделал, в сегодняшнюю заметку: одна строка с временем, действием и ссылкой на то, что создано. Если заметки нет, создай её из шаблона.
  2. Цифры берутся из скриптов, а не от тебя. Не оценивай, не округляй и не переноси старое значение. Если значение не прочиталось, скрипт пишет unknown, а не ноль.
  3. Свойства одинаковые во всех заметках одного типа. Не придумывай новые статусы, используй те, что в шаблоне.
  4. Перед рабочим процессом прочитай его папку: сначала AGENTS.md, потом FINDINGS.md, потом SKILL.md.
  5. После процесса запиши, чему научился: что было, какие факты, какой урок на следующий раз.
  6. Никаких паролей, ключей и токенов в заметках. Скрипты берут секреты из переменных окружения.
Шесть правил для каждой сессии агента: журнал, цифры из скриптов, выводы после работы
Шесть правил для каждой сессии агента: журнал, цифры из скриптов, выводы после работы

Ниже в том же файле идёт список «Остановись и спроси сначала». Туда попало всё, что уходит за пределы компьютера (письма, публикации, сообщения), удаление и массовое переименование заметок, переписывание чужого текста и правка шаблонов. Последнее важно: изменив свойства шаблона, вы меняете базу для всех будущих заметок.

Шаг 4. Пусть цифры собирают скрипты

Наверху каждой заметки Obsidian показывает свойства. Это блок данных в начале файла, так называемый front matter. В примере в шаблоне дневной заметки 32 свойства: тип, статус, дата, теги, а дальше метрики по каждой платформе: просмотры, подписчики, выручка и так далее. Пока заметка пустая, значения стоят как Empty.

Шаблон дневной заметки: свойства с метриками по платформам, пока пустые
Шаблон дневной заметки: свойства с метриками по платформам, пока пустые

Заполняет их не модель. У каждой платформы свой скрипт-сборщик. Он запускается по расписанию, обращается к официальному API и записывает значения в свойства. Скрипты лежат в Machine/Scripts/collectors/.

Схема: по расписанию скрипт-сборщик вызывает API и заполняет свойства заметки
Схема: по расписанию скрипт-сборщик вызывает API и заполняет свойства заметки

Это даёт три плюса. Вы не вводите данные руками. Данные собираются одинаково каждый день. И они не проходят через вероятностный фильтр ИИ, то есть модель не может их «угадать» или округлить. Откройте дневную заметку в любой момент, и цифры уже там.

Шаг 5. Увидьте в заметках таблицу

Теперь представьте каждую дневную заметку как строку, а каждое свойство как столбец. Получается таблица данных. Одинаковые свойства во всех заметках одного типа превращают Obsidian в полноценную базу. Дальше можно добавить столбец с работой агентов: что делал, сколько раз, с каким результатом.

Каждая дневная заметка как строка таблицы: Obsidian работает как база данных
Каждая дневная заметка как строка таблицы: Obsidian работает как база данных

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

Шаг 6. Не сваливайте весь контекст в чат

Типичная ошибка: скормить агенту всё хранилище, думая, что больше контекста значит лучший ответ. На деле агент тонет. Это как дать человеку стопку материалов: начало и конец он запомнит, а середина потеряется.

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

Агент читает карту хранилища, а в нужной папке берёт процесс, заметку и выводы
Агент читает карту хранилища, а в нужной папке берёт процесс, заметку и выводы

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

Шаг 7. Поставьте интерфейс поверх файлов

Можно остановиться и на предыдущем шаге: работать в Obsidian или просто в терминале. Но удобнее, когда сверху есть панель. В примере её сделали своим приложением: оно читает те же markdown-файлы, запускает те же скрипты и использует те же подключения. По духу интерфейс взят у медиаплееров и игровых приставок: прокручиваемые карточки, крупные заголовки.

Своя панель поверх файлов: карточка проектов, 12 активных, кнопка «Open Projects»
Своя панель поверх файлов: карточка проектов, 12 активных, кнопка «Open Projects»

Панель меняется в течение дня: подтягивает дела, показывает почту и то, что требует внимания. Раздел «Нужно от вас» строится на истории, которая накопилась в свойствах. Туда попадают дела, которые двигают работу вперёд.

Раздел «Нужно от вас»: решение с вариантами, полем для обоснования и кнопкой записи
Раздел «Нужно от вас»: решение с вариантами, полем для обоснования и кнопкой записи

Это не просто витрина. Через панель можно действовать. Если нужно ответить на письмо, и почта подключена на бэкенде, черновик создаётся и отправляется прямо отсюда. В примере по каждому решению есть доказательства, рекомендуемый шаг и четыре исхода: продолжить, запросить контекст, отказаться, отложить. Рядом поле, где записывают, почему выбрано именно так, чтобы потом не гадать. Там же видны остановленные запуски агентов с пометкой, что нужно посмотреть.

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

Если вы работаете из России

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

Из упомянутых агентов Claude Code и Codex из России напрямую не работают. Но схема от них не зависит: подойдёт любой агент, который читает и пишет файлы. В примере названы ещё Pi и Hermes. Проверьте, можно ли запустить их у себя на сервере вместе с открытой моделью: тогда схема работает без зарубежных сервисов. Можно взять и российскую модель, если она справляется с инструкциями в AGENTS.md.

Скрипты-сборщики вызывают официальные API платформ. Если сервис отсюда недоступен, скрипт для него не заработает. Берите источники, которые открыты вам: CRM, бухгалтерию, службу поддержки, свои базы. Принцип тот же: скрипт по расписанию кладёт цифры в свойства.

Что важно знать до старта

  • Агенту нужны границы. Без жёсткого разделения зон он будет переписывать ваши заметки. Начните с правила: в человеческую зону не писать.
  • Цифры только от скриптов. Если модель заполняет метрики, вы не знаете, угадала она или посчитала. Пусть пишет unknown, а не ноль.
  • Один формат свойств. Одинаковые названия и значения из фиксированного списка во всех заметках одного типа. Иначе таблицы не получится. Менять шаблон надо осторожно.
  • Ключи и пароли в заметки не кладут. Скрипты берут секреты из переменных окружения.
  • Опасные действия через подтверждение. Отправка писем, публикации, удаление и массовые правки: сначала спросить.
  • Интерфейс сложнее, чем кажется. Правила и файлы это текст, их можно ввести сразу. Панель поверх них уже отдельная разработка: много мелких деталей, поставленных друг на друга.
  • Выводы нужно вести. FINDINGS.md работает, только если агент обязан его читать и обновлять. Это закрепляется в правилах.

Три вещи, на которых всё держится

Если убрать подробности, остаются три принципа. Markdown-файлы со свойствами. Файл AGENTS.md в каждой папке. И способ вести выводы, чтобы агенты улучшались. Дальше на этом можно строить что угодно.

Мы в Агентехе учим сотрудников выстраивать такие правила для своих агентов: что можно, что нельзя и что сначала согласовать с человеком. Как устроено обучение.

Написать в Telegram