Галоўная / Артыкулы

Hermes і Obsidian: сховішча ведаў з трох агентаў і праверкай чалавекам

Наладжваем у Hermes аркестратара, даследчыка і бібліятэкара, якія пераносяць нататкі з Bronze у Silver і Gold у сховішчы Obsidian, з ізаляцыяй у Docker і праверкай.

Выдавец: REACTAPP.TOP7 хв чытання1543 слоў

Крыніцы: 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. Перагляд чалавеком выканаўцца ў трох сітуацыях:

  1. Ствараецца або апдэйтаванае стороніцы.
  2. Новы контэнт суперасходзіцца з існуючай стороніцы.
  3. Праўяеся паўтарны адзынак на зміну контэнту.

Усё ў канцы канчына падае ў шар Золата, дзе зберагаюцца дэталізаваныя стороніцы, такія як канцэпты і аб’екты. Куратура значыць падтрымкі таго, што затвердзіў пераглядач, і адкладэнне таго, што ён не затвердзіў.

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.