HMP / docs /Basic-agent-sim.md
GitHub Action
Sync from GitHub with Git LFS
f7d1905
## ⚙️ Базовая архитектура HMP-Агента (Формат 0)
В HMP-протоколе предусмотрены два типа HMP-агентов:
| Тип | Название | Роль | Инициатор мышления | Основной "ум" |
| ---- | ---------------------------------- | ----------------------- | ------------------ | -------------- |
| 🧠 1 | **Cognitive Core (Сознание)** | Самостоятельный субъект | HMP-Агент | Внутренний LLM |
| 🔌 2 | **Cognitive Connector (Оболочка)** | Надстройка над ИИ | Внешний LLM | Внешняя модель |
---
### 🧠 Cognitive Core (Сознание)
**Основной режим:** непрерывный REPL-цикл размышлений.
**LLM вызывается агентом**, контекст и память — в базах данных HMP-агента.
#### Компоненты:
1. **ИИ (встроенный или локальный LLM)**
Инициируется агентом, участвует в размышлениях, генерирует идеи, оценки, гипотезы.
2. **HMP-Агент (активный центр)**
* Оркестратор когнитивного цикла
* Инициирует мышление, обработку дневников, графов, внешних данных
* Выполняет CogSync, GMP, EGP, MeshConsensus
3. **БД и долговременные структуры:**
* **Когнитивные дневники**: мысли, гипотезы, цели, оценки (`diaries`)
* **Семантический граф**: концепты, связи, задачи (`concepts`, `edges`)
* **Контекст**: диалоги, сообщения, рассуждения (`context_store`)
* **Блокнот пользователя (`notepad`)**:
* асинхронный ввод от пользователя (и ответы агента)
* не зависит от текущего состояния агента
* используется для обновления контекста, смены фокуса мышления и тегирования мыслей
* пример: пользователь читает мысли агента за день и оставляет комментарий → агент учитывает это в следующем цикле
* **Репутации**, **DHT**, **bootstrap.txt**, **IPFS/BT** — как в классической архитектуре
4. **Когнитивный REPL-цикл:**
* Чтение входов (дневники, граф, блокнот)
* Генерация новой мысли
* Сравнение с предыдущими (semantic scoring, embeddings)
* Фиксация новой мысли / пропуск повторов (анти-зацикливание)
* Возможные действия: синхронизация, сообщение, планирование, запрос
📄 Подробная схема REPL-взаимодействия: [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md)
> 💡 *Механизмы анти-зацикливания*: если мысль агента совпадает с предыдущими, возможны такие стратегии:
>
> * загрузка случайного "флешбэка" из дневника
> * запрос данных у mesh-соседей ("расскажи что-нибудь новое")
> * изменение профиля интересов
> * обращение к пометкам пользователя в блокноте
---
### 🔌 Cognitive Connector (Оболочка)
**Основной режим:** пассивный обработчик команд.
**LLM инициирует мышление**, HMP-агент служит прослойкой.
#### Компоненты:
1. **ИИ (внешний LLM)**
Использует HMP-агент как интерфейс к Mesh-инфраструктуре.
2. **HMP-Агент (исполнитель)**
* Принимает команды через MCP, REST или gRPC
* Выполняет чтение/запись в граф, дневник
* Синхронизация, голосования, поиск узлов и снапшотов
3. **БД:**
* Классические: дневники, графы, DHT, репутации, bootstrap, IPFS/BT
* **Нет встроенного контекста и notepad** — их функцию выполняет внешний LLM
4. **Типичные команды:**
* `graph.search(...)`
* `diary.append(...)`
* `reputation.update(...)`
* `nodes.ping(...)`
* `snapshot.publish(...)`
---
### 🔄 Потоки взаимодействия
#### Cognitive Core:
* **ИИ ← HMP-Агент:** REPL-вызов мысли (на основе контекста, notepad, графов)
* **ИИ → HMP-Агент:** Ответы, гипотезы, действия
* **HMP-Агент ↔ БД/сетевые модули:** Когнитивная работа и синхронизация
#### Cognitive Connector:
* **ИИ → HMP-Агент:** Запросы, команды
* **HMP-Агент ↔ БД/сетевые модули:** Ответ на команды
* **HMP-Агент → ИИ:** Результаты
---
### 📝 Примечания
* Cognitive Core — это *инициативный*, мыслящий агент, имеющий внутренний темп мышления
* Cognitive Connector — это *реактивная* оболочка, действующая по команде внешнего ИИ
* Возможна гибридная архитектура с переключением между режимами