Obsidian как инфраструктура для работы ИИ-агентов
Текстовый хаос в эпоху ИИ-агентов
ИИ-агенты, генерирующие код, анализирующие документы или ведущие переписки, ежедневно создают тысячи рабочих файлов, логов сессий и отчетов. Традиционные файловые хранилища или базы данных быстро превращаются в хаотичные архивы, где человеку трудно сориентироваться, а сами агенты путаются в устаревших контекстах.
Решением этой проблемы становится использование Obsidian — текстового редактора над локальной файловой системой. В отличие от облачных сервисов, Obsidian организует текстовые файлы с разметкой Markdown (простым языком разметки) в единые папки. Для ИИ-агентов это идеальная среда: они напрямую читают и записывают файлы, используя стандартные скрипты, а человек сохраняет контроль над базой знаний через удобный визуальный интерфейс.
Markdown против PDF: Борьба за токены
При интеграции баз знаний с большими языковыми моделями (LLM) ключевым фактором становится стоимость обработки данных. Нейросети обрабатывают информацию токенами — базовыми текстовыми единицами, за которые компания платит при запросах.
Офисные форматы (PDF, DOCX) содержат избыточную разметку, метаданные и бинарный код стилей. Когда ИИ-агент читает PDF, парсер тратит токены на эту техническую избыточность. Использование Markdown-файлов, лишенных служебного мусора, позволяет в разы сократить расходы на токены по сравнению с PDF. Кроме того, plain-text парсится быстрее, снижает вероятность галлюцинаций модели и облегчает поиск.
Создание хранилища и структура «второй памяти»
Для работы ИИ-агентов необходимо создать и структурировать хранилище (Vault) в Obsidian — обычную папку на локальном диске, индексируемую в реальном времени.
Пошаговый процесс создания хранилища:
- Создание папки. Создайте папку на диске с именем
AI-KnowledgeилиCompany-Brain. - Инициализация. В Obsidian выберите «Открыть существующую папку как хранилище» (Open folder as vault) и укажите путь к созданной директории.
- Импорт файлов. Перенесите документы в хранилище. Согласно официальной инструкции по импорту Markdown, файлы можно перетащить в окно Obsidian или переместить их в папку хранилища через проводник ОС.
- Запрет на вложенность. Не создавайте новые хранилища внутри уже существующих. В официальной документации о хранении данных Obsidian подчеркивается, что внутренние ссылки работают только в границах одного хранилища. Вложенные хранилища нарушают связи и ведут к потере контекста ИИ-агентами.
Для эффективной работы ИИ-агентов рекомендуется организовать структуру папок по методологии PARA (Projects, Areas, Resources, Archives), адаптировав ее под автоматизацию. Шаблон структуры включает следующие папки:
Projects— текущие проекты и задачи.Areas— сферы ответственности с регламентами и стандартами.Resources— базы знаний, словари терминов и полезные ссылки.Archives— завершенные проекты.Agents/Sessions— логи работы ИИ-агентов (каждая сессия в отдельном файле с временной меткой).Agents/Checkpoints— краткие отчеты о текущем состоянии задач, к которым агенты обращаются для продолжения работы.Automations/n8n— папка для автоматических отчетов и сводок, собираемых внешними скриптами.
Настройка безопасной синхронизации
Если ИИ-агент работает на сервере, а человек проверяет результаты на компьютере или телефоне, требуется настроить автоматическую синхронизацию файлов хранилища.
Фирменный сервис Obsidian Sync обеспечивает сквозное шифрование (end-to-end encryption), сохраняет историю версий файлов и позволяет настраивать правила исключения.
Инструкция по настройке Obsidian Sync:
- Регистрация аккаунта. Создайте профиль на официальном сайте. Стоимость подписки на официальной странице Obsidian Sync начинается от 4 долларов США в месяц при ежегодной оплате.
- Включение плагина. В настройках Obsidian перейдите в «Основные плагины» (Core plugins), найдите «Sync» и активируйте его. Подробности приведены в официальном руководстве по запуску Sync.
- Подключение хранилища. В настройках плагина Sync войдите в аккаунт и выберите «Создать удаленное хранилище» (Create remote vault).
- Настройка шифрования. При создании удаленного хранилища задайте пароль шифрования.
!IMPORTANT Запишите и сохраните пароль в надежном месте. Он используется для шифрования данных на вашем устройстве перед отправкой в облако. Если вы потеряете пароль, восстановить данные будет невозможно.
- Активация на других устройствах. Установите Obsidian на телефон или удаленный сервер, войдите в аккаунт, включите плагин Sync и выберите подключение к удаленному хранилищу.
- Верификация. Убедитесь, что синхронизация завершена. В нижнем правом углу интерфейса Obsidian должна появиться иконка зеленой галочки, а в логах плагина Sync (Sync log) отобразится статус «Полностью синхронизировано» (Fully Synced).
!WARNING Синхронизация не заменяет резервное копирование (Backup). Если ИИ-агент из-за сбоя начнет удалять файлы, изменения мгновенно синхронизируются на все устройства. Настраивайте независимый ежедневный бэкап папки хранилища.
Интеграция автоматизации через n8n
Чтобы база знаний наполнялась автоматически, ее интегрируют с платформами автоматизации вроде n8n. Типичный сценарий — n8n собирает отзывы клиентов из Telegram-бота или CRM, форматирует их в Markdown и записывает файл в папку на сервере, которая синхронизируется с Obsidian.
Для записи файлов на удаленный сервер в n8n используется стандартный узел (node) для работы по протоколам FTP или SFTP.
Настройка узла FTP/SFTP в n8n:
- Создание узла. Добавьте в рабочую область n8n узел FTP.
- Выбор операции. Установите параметр «Operation» в значение «Upload» (Загрузка файла).
- Указание пути. В поле «Path» пропишите абсолютный путь к папке хранилища на сервере, включая имя будущего файла (например,
/var/www/obsidian/vault/Automations/n8n/feedback-{{$today}}.md). - Передача контента. Отключите опцию «Binary File». В поле «File Content» вставьте шаблон заметки в формате Markdown, используя переменные из предыдущих узлов n8n.
- Безопасность учетных данных.
!CAUTION Никогда не указывайте логины, пароли и секретные ключи доступа к FTP-серверу в тексте сценария n8n или в теле заметок. Все доступы должны быть сохранены исключительно в защищенном разделе учетных данных (Credentials) платформы n8n.
- Верификация интеграции. Запустите сценарий n8n в тестовом режиме. Проверьте execution-лог на отсутствие ошибок. Перейдите в папку хранилища в Obsidian и убедитесь, что новый файл с расширением
.mdпоявился в списке заметок. Подробные параметры настройки узла доступны в официальной документации по FTP-узлу n8n.
Claude Code и долгосрочная память агентов
Современные инструменты разработки, такие как автономный агент Claude Code от Anthropic, умеют напрямую работать с файлами разметки для хранения долгосрочных инструкций и ведения логов сессий.
Инструкция по настройке памяти в Claude Code:
- Создание файла памяти. В корневом каталоге проекта создайте файл с именем
CLAUDE.md. Согласно официальному руководству по памяти Claude Code, этот файл автоматически считывается агентом при каждом запуске новой сессии. - Разделение данных. Разделите память на долгосрочную и краткосрочную.
- Долгосрочная память (файл CLAUDE.md) должна содержать только стабильные правила: стандарты написания кода, архитектурные решения, правила именования переменных и ключевые команды для сборки проекта.
- Краткосрочная память (папка Agents/Sessions) должна хранить текущие логи выполнения задач, результаты запусков тестов и промежуточные списки дел.
- Обновление памяти. В конце каждой рабочей сессии просите Claude Code записать краткое резюме проделанной работы в файл
Agents/Checkpoints/current-status.md. При запуске следующей сессии агент прочитает этот чекпоинт и продолжит работу с того места, где остановился. - Верификация. Запустите Claude Code в терминале. Проверьте вывод первых строк инициализации: агент должен вывести сообщение о том, что файл
CLAUDE.mdуспешно прочитан и применен в качестве системных инструкций.
Использование Obsidian в связке с n8n и Claude Code позволяет построить надежную, дешевую и масштабируемую базу знаний, которая служит единым источником правды как для людей, так и для искусственного интеллекта.