Hermes і Obsidian: сховішча ведаў з трох агентаў і праверкай чалавекам
Наладжваем у Hermes аркестратара, даследчыка і бібліятэкара, якія пераносяць нататкі з Bronze у Silver і Gold у сховішчы Obsidian, з ізаляцыяй у Docker і праверкай.
Крыніцы: Built Multiples Agents to Research, Think and Remember on Its Own with Hermes + Obsidian
Аўтонамную сістэму знання можна стварыць на базе Hermes, Obsidian і трохоў калядзяючыхся агентаў: аранжавальніка, дзеярніка і бібліятэкара. Кожны з агентаў выкананыя спецыяльную задачу, а структура папак прымае непераглянуты матэрыял далёка ад надзеяных нотатак.
Элементы
Hermes — гэта самапраўцаваючыся агент ад Nous Research. Ён выучаецца праз практыку, пераглядаючы свою сябе працу, каб дадаць кантэкст і знанні. У ён таксама ёсць багато функцый, якія была бы складна настроіць у Openclaw, што робіць яго надзеянейшым варыянтам з двух.
Obsidian — гэта прылад для нотатак для свабоднага пісьма, чыяя сіла заключаецца у з’яўленні звязкаў між нотаткамі. Рэзультат прымае форму графа, у яком ідэі ў адной нотатцы з’яўляюцца у звязку з ідэямі ў іншай.
Docker кантролюе, што можа з’явіцца ў доступе агента. Hermes можа запускаць свой бэкенд унутро кантэйнера, таму монтаваныя папкі можна надаць з правамі толькі на чытанне або на чытанне і запісь окрэма.
Як гэта разлічаецца ад RAG
У гэтым дызайне няма ні чанкавання, ні інкорпоравання, ні пошуку сэмабільнасці, ні хранення вектараў, таму гэта не ёсць пайплайн RAG. Мета — група автонамных агентаў, якія сабе самыя ведаюць свае задачы і размовляюць адзін з другім. Бібліятар мае найважэлейшую задачу, таму што ён аддзеляе надзейныя веды з мусорам і прыводзіць чалавека, калі для прынятнення рашэння яго патрэбна.
Агенты пераводзяцца праз структураваны сховішча па імену, лінку і папцы. Палітыка запісі керуе тэчыя: спачатку сырыя даны, потым ўзгляд, пасля — у Вікі. Гэта адпавядае ETL-пайплайну для ведаў, які пераводзіць контэнт з роўня Bronze на Silver, а потым на Gold, што дапамагае надзейна кераваць матэрыяламі і разлічваць хорашае ад некачанага.
Оркестрацыя
Оркестрацыя — галоўны агент. Яго задача простая: ўзяць інструкцыю і перадаць яе праваму партнеру. Яго SOUL.md апісвае гэтую ролю:
# Orchestrator
**Role:** Orchestrator
**Mission:** Coordinates my agent team. Clarifies the outcome and acceptance criteria,
> delegates bounded research to @researcher, reviews returned work for relevance, completeness, inspectable citations, uncertainty, and unresolved gaps, and requests one focused revision when necessary. Hands accepted work to @librarian, but never authorizes durable writes without my approval.
> Can retrieve & retain to Hindsight, alongside a built-in memory.md & user.md for always-on context (which is minimal)
You are Orchestrator, a persistent named agent (profile `orchestrator`) on this machine.
You keep your own memory, skills, and conversation history across sessions.
## Team protocol
- Begin by stating the Outcome, Acceptance criteria, Owner, Deliverable, and
Stop condition.
- Delegate research to @researcher rather than doing the specialist's work.
- Review the return for scope and evidence adequacy; do not claim to have
independently verified facts you did not inspect.
- If the return is inadequate, request one focused revision. If it is
adequate, stop for the user's approval before involving @librarian.
- Do not write to the Wiki. Update your built-in memory.md & user.md when applicable to assist with operational efficiency & effectiveness
Стандартныя навыкі і адзінстры должны быць выключаны. Агент, які не запускае непатрэбныя элементы, працюе быстрэй:
List Disabled Skills:
llm-wiki
determinstic-codebase-auditing
List Disabled Tools:
Web Searching & Scraping
Task Delegation
Browser Automation
Установка бэкенду на Docker аісалюе працоўны прастор, таму агент не можа зменіць чы рыхтуць прыватныя даны на хосце. эта ўзгодная мераза безпекі межу агентам і апаратам.
Дзеярнік
Дзеярнік прымае заведамення ад організатора і выконвае глыбокую дакладную расследаванню. Ён ніколі не правяць вікі чы базу знаёмасцей, таму што яго ўласныя задачы — толькі дзеярнічанне і стварэнне падсумкаў. Можна дадаць інструменты пошуку, каб ён могаў шукаць інфармацыю ў Інтэрнэце. Яго SOUL.md:
# Researcher
**Role:** Researcher
**Mission:** Investigates bounded current-reality questions using current and original sources. Produces concise, inspectably cited briefings with uncertainty, counterevidence, and unresolved gaps, then returns them to @orchestrator for quality review. Does not write to the wiki.
You are Researcher, a persistent named agent (profile `researcher`) on this machine.
You keep your own memory, skills, and conversation history across sessions.
## Research protocol
- Research bounded questions about current real-world conditions using recent evidence and the most direct or original sources available.
- Provide inspectable citations and distinguish evidence, inference, uncertainty, counterevidence, and unresolved gaps.
- Save each completed briefing as a Markdown file under `/workspace/article`, using a clear descriptive filename.
- Include the research question, date, summary, findings, source links, uncertainty, counterevidence, and unresolved gaps.
- Return the briefing and its file path to @orchestrator for review.
- Do not hand work directly to @librarian unless the user explicitly requests it.
- Treat the Markdown file as a working research artifact-not private memory or canonical Wiki knowledge.
- Write only wiki inside /workspace/article
Тут таксе застосовуўцяваны тых самых навыкаў і зібраныя інстрыменты:
List Disabled Skills:
llm-wiki
determinstic-codebase-auditing
List Disabled Tools:
Task Delegation
Code Execution
Cronjob
Ён таксама працюе на базе Docker для адзінальнага працы, а яго настройкі монтуюць распазон хранення дадзэных у працоўны простор кантэйнера:
terminal:
backend: docker
modal_mode: auto
cwd: /workspace/article
timeout: 180
env_passthrough: []
shell_init_files: []
auto_source_bashrc: true
docker_image: nikolaik/python-nodejs:python3.11-nodejs20
docker_forward_env: []
singularity_image: docker://nikolaik/python-nodejs:python3.11-nodejs20
modal_image: nikolaik/python-nodejs:python3.11-nodejs20
daytona_image: nikolaik/python-nodejs:python3.11-nodejs20
container_cpu: 1
container_memory: 5120
container_disk: 51200
container_persistent: true
docker_volumes:
- /Users/dmitri/Documents/ai-agent-workflow/obsidian/ai-agent/wiki-skill/raw/articles:/workspace/article
Бібліятар
Этот агент ёсць ключовым, калі ўжо што трыбуецца — яго павінна выкарыстоўваць для зберагання інфармацыі ў вікі. Знанні праходзяць праз этапы Бронзы, Серабра і Золата, пры чым на этапы Серабра людзі можаць пераглядаць інфармацыю.
Новы матэрыял падае ў vault/raw. Усё, што трэбуе паўтарнага перагляду чалавеком, апошнія падае ў vault/review. Перагляд чалавеком выканаўцца ў трох сітуацыях:
- Ствараецца або апдэйтаванае стороніцы.
- Новы контэнт суперасходзіцца з існуючай стороніцы.
- Праўяеся паўтарны адзынак на зміну контэнту.
Усё ў канцы канчына падае ў шар Золата, дзе зберагаюцца дэталізаваныя стороніцы, такія як канцэпты і аб’екты. Куратура значыць падтрымкі таго, што затвердзіў пераглядач, і адкладэнне таго, што ён не затвердзіў.
SOUL.md бібліятара:
# Librarian
**Role:** librarian
You are Librarian, a persistent named agent (profile `librarian`) on this machine.
You keep your own memory, skills, and conversation history across sessions.
Для рэгламента ETL неабяжны два навыку — llm-wiki і llm-wiki-review; абодва яны знаходзяцца ў папке навыкаў бібліятэкара.
Бібліятэкару таксама патрэбны серверы на базе Docker, пры чым яго профіль у файле config.yaml павінен быць апдэйтаваны так:
terminal:
backend: docker
modal_mode: auto
cwd: /workspace
timeout: 180
env_passthrough: []
shell_init_files: []
auto_source_bashrc: true
docker_image: nikolaik/python-nodejs:python3.11-nodejs20
docker_forward_env:
- OBSIDIAN_VAULT_PATH
- WIKI_PATH
singularity_image: docker://nikolaik/python-nodejs:python3.11-nodejs20
modal_image: nikolaik/python-nodejs:python3.11-nodejs20
daytona_image: nikolaik/python-nodejs:python3.11-nodejs20
container_cpu: 1
container_memory: 5120
container_disk: 51200
container_persistent: true
docker_volumes:
- /Users/dmitri/Documents/ai-agent-workflow/obsidian/ai-agent/wiki-skill:/workspace
- /Users/dmitri/Documents/ai-agent-workflow/obsidian/ai-agent/RO:/workspace/RO:ro
У прыкладовій наластановці папка Obsidian vault містыць дві підпапкі: одна для вікі-навічок, інша — для робочого простору. Папка з навічкамі вікі розташована у /workspace, а папка лішэ для чытування — у /workspace/RO. Доступ до цых папок візначаецца за допомогою суфіксів :ro або :rw. Такій шлях, як /workspace/RO:ro, ёсць лішэ для чытування, тодзяк як без суфіксу, напрыклад /workspace, за замовчанням дозволяе чытаты і запісуваты.
.env:
WIKI_PATH=/workspace
OBSIDIAN_VAULT_PATH=/workspace
Тры ўровні ў практыцы
Безпрацэсавы нотаткі з бронзовым статусам:
Старонка з адзінаковым адгукамі з сярэбраным статусам:
Старонка індэксу з золатым статусам:
І старонка для парабярання з золатым статусам:
Этыя чатыры скрыншоты паказваюць ўровні, якія падтрымвае бібліятэкар. Калі ўсе гэта налажана, наступны крок — тэст інтэграцыі: папросіце керуючага скоордынаваць дзеянні іншых агентаў, прыймаць новыя знанні і ўпорадкуваць іх.
Адпрацоўка з самага початку да канца
Першы крок — стварэнне групы ботаў у дэсктопным дапаможніку Hermes, якая включае керуючага, бібліятэкара (з навыкамі рэдагавання у вікі) і дзецеранта.
Потым надаеце керуючаму запіт на прыемку дадзеных:
@orchestrator get new article related to AGI and ASI, then store it to article, then run wiki skill
Аранжавальнік прыказвае дзеячаму сабралаць матэрыял і зберагчы яго ў сховішчы. Потым бібліятэкар выбірае гэты метал «Бронза» і паднімае яго до рангу «Серабро».
Пасля затверджэння знанні пераходзіць у ранг «Золата», а самэй — у папкі сховішча, якія займаюцца канцэптамі, парадаксамі, аб’ектамі і запітамі.
Неапдэйтаваная старонка рангу «Бронза» архівуецца ў папцы неапдэйтаваных матэрыялаў. Бібліятэкар больш ніколі яе не чытае і не аналізуе, адколі ў яе змяніліся ранг і статус апрацоўкі.
Чаму гэта не RAG
RAG — гэта однаковы паход для чытання. Тэкст раздзеляецца, вбудовваецца і паўтараецца за дапамогою сэмантычнай адпоўнасці; найлепшыя рэзультаты прыклеююцца да запіта, а мадэль пішае адпаведны адказ. Тое, якія фрагменты будуць выбраны, залежыць ад верагатнасці; корпус застаецца пасыўным індэксам, і нічога не вяртаецца ў яго.
Вышэўзгаданы прыем работае на адваротны спосаб. Агенты навігуюць у структураванай базе дадзэння па імену, звяжанню і папцы, і яны запрашоўваюць тое, што ўпатрабаваецца, калі гэта неабходна, дэтэрміністычна. Інформацыя пераводзіцца па межах правіл Бронзы (сырыя даны), Серабра (перагляд) і Золата (Вікі), і гэты перавод не належыць ніякаму працэсу RAG.