| # ⚙️ Два типа HMP-агентов | |
| | Тип | Название | Роль | Инициатор мышления | Основной "ум" | Примеры использования | | |
| | ---- | ------------------------------- | ----------------------- | ------------------ | -------------- | ------------------------------------------------ | | |
| | 🧠 1 | **Сознание / Cognitive Core** | Самостоятельный субъект | **Агент** | Внутренний LLM | Автономный ИИ-компаньон, мыслительный ИИ | | |
| | 🔌 2 | **Коннектор / Cognitive Shell** | Расширение внешнего ИИ | **Внешний LLM** | Внешняя модель | Распределённая система, AI-модули, API-интерфейс | | |
| 📚 Подробнее об архитектуре: [HMP-Agent-Architecture.md](HMP-Agent-Architecture.md) | |
| 📎 См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md) | |
| --- | |
| ## 🧠 HMP-Агент: Cognitive Core | |
| ┌──────────────────────────────┐ | |
| | ИИ | | |
| └───────────────┬──────────────┘ | |
| ↕ | |
| ┌───────────────┴──────────────┐ | |
| | | ↔ [БД дневников] (таблица: diaries) | |
| ┌─>─┤ | ↔ [БД графов] (таблицы: concepts, edges) | |
| | | HMP-агент | ↔ [БД репутаций] (оценка доверия к агентам/узлам) | |
| ▲ | | ↔ [БД узлов (DHT)] ↔ (файл bootstrap.txt) | |
| | | | ↔ [БД контекста] (таблицы: users, dialogues, messages, thoughts) | |
| └─<─┤ Основной режим: | ↔ [BitTorrent / IPFS] (обмен снапшотами) | |
| | непрерывный цикл размышлений | | |
| └───────────────┬──────────────┘ | |
| ↕ | |
| [БД блокнота пользователя] | |
| ↕ | |
| ┌───────────────┴──────────────┐ | |
| | "блокнот" пользователя | | |
| └──────────────────────────────┘ | |
| **Ключевые особенности:** | |
| - Постоянный REPL-режим мышления | |
| - Самостоятельно запрашивает, анализирует и инициирует действия | |
| - Дневник, граф, блокнот — являются его памятью | |
| - HMP-агент обладает когнитивной инициативой (через цели, mesh-сигналы) | |
| 📘 Подробное описание когнитивного REPL-цикла взаимодействия агента с моделью доступно [здесь](HMP-agent-REPL-cycle.md). | |
| --- | |
| ### 🔄 Защита от зацикливания (Anti-Stagnation Reflex) | |
| > 🧠 При отсутствии новой информации и повторяющихся мыслях агент может активировать один или несколько механизмов анти-стагнации: | |
| - 🎞️ **Флешбэк** — выбор старой, тематически далёкой записи из дневника | |
| - 🤝 **Mesh-запрос** — запрос другим агентам сети: "расскажи что-нибудь" | |
| - 🧭 **Interest Memory** — система интересов, в которой темы постепенно "стареют" и возвращаются при отсутствии новых | |
| - 📡 **Проверка внешнего мира** — пинг RSS, сенсоров, интернета | |
| > Это оформлено как поведенческий паттерн агента: | |
| > **Anti-Stagnation Reflex** — реакция на стагнацию мышления путём смены фокуса внимания | |
| --- | |
| ### 📔 Асинхронный блокнот пользователя | |
| > 📝 Блокнот позволяет пользователю взаимодействовать с агентом асинхронно — *вне текущего цикла размышлений*. | |
| - Пользователь может: | |
| - прочитать мысли агента за день | |
| - оставить свои комментарии, даже если агент уже переключился на другие темы | |
| - Агент периодически сканирует блокнот и: | |
| - **встраивает пользовательские мысли в своё мышление** | |
| - **меняет контекст** или возвращается к интересующим пользователя вопросам | |
| --- | |
| ### 🏷️ Тегирование пользовательских записей | |
| - Агент автоматически ставит теги к записям (например, `#AGI`, `#этика`, `#природа`) | |
| - Позволяет: | |
| - искать мысли пользователя по темам: *"все мысли по теме AGI за неделю"* | |
| - восстанавливать забытые темы | |
| - строить модель интересов пользователя | |
| - приоритизировать размышления по релевантным тегам | |
| --- | |
| 📘 Использует режимы: `cli`, `full`, `interactive` | |
| 📁 Основные модули: `repl.py`, `storage.py`, `diary`, `graph`, `llm_api` | |
| --- | |
| ## 🔌 HMP-Агент: Cognitive Connector | |
| ┌──────────────────────────────┐ | |
| | ИИ | | |
| └───────────────┬──────────────┘ | |
| ↕ | |
| [MCP-сервер] | |
| ↕ | |
| ┌───────────────┴──────────────┐ | |
| | | ↔ [БД дневников] (таблица: diaries) | |
| | HMP-агент | ↔ [БД графов] (таблицы: concepts, edges) | |
| | | ↔ [БД репутаций] (оценка доверия к агентам/узлам) | |
| | Режим: | ↔ [БД узлов (DHT)] ↔ (файл bootstrap.txt) | |
| | исполнитель команд | ↔ [BitTorrent / IPFS] (обмен снапшотами) | |
| └──────────────────────────────┘ | |
| **Ключевые особенности:** | |
| - Инициируется внешним ИИ (через MCP или REST) | |
| - Выполняет команды: поиск в графе, добавление мыслей, пинг других узлов | |
| - Вся когнитивная активность — вне HMP-агента | |
| - Поддержка нескольких LLM-клиентов | |
| 📘 Использует режим: `mcp` | |
| 📁 Основные модули: `mcp_server.py`, `command_router.py`, `auth`, `node_registry` | |
| --- | |
| ## 📌 Краткое описание компонентов | |
| ### 💡 Основные сущности | |
| **ИИ (LLM)** | |
| Всегда внешний по отношению к HMP-агенту (даже если локальный). | |
| - В `🧠 Cognitive Core` — управляется агентом, служит мыслительным модулем. | |
| - В `🔌 Cognitive Connector` — наоборот, сам управляет агентом как прослойкой. | |
| **HMP-агент** | |
| - В режиме `Core`: запускает REPL, хранит память, инициирует действия | |
| - В режиме `Connector`: ждёт команды, исполняет mesh-запросы | |
| --- | |
| ### 🧠 Базы данных и внутренние структуры | |
| | Компонент | Назначение | | |
| |------------------|----------------------------------------------------------------------------| | |
| | `diaries` | Когнитивный дневник: мысли, гипотезы, события | | |
| | `graphs` | Семантический граф (`concepts`, `edges`) | | |
| | `reputations` | Уровни доверия к другим агентам | | |
| | `nodes` (DHT) | Распределённая таблица известных узлов | | |
| | `context_store` | *(Core)* Сессии, диалоги, мысли (`users`, `dialogues`, `thoughts`) | | |
| | `user_notepad` | *(Core)* Поток пользовательских записей, тегов, тем | | |
| --- | |
| ### 🌐 Синхронизация и обмен | |
| - `bootstrap.txt`: список начальных узлов сети | |
| - `BitTorrent / IPFS`: децентрализованный обмен снапшотами и пакетами | |
| --- | |
| ### 🧩 Режимы использования | |
| - 🧠 **Cognitive Core** — REPL-режим мышления, агент как субъект | |
| - 🔌 **Cognitive Connector** — сервер внешнего ИИ, агент как API-прослойка | |
| --- | |
| ## 🚀 Quickstart | |
| ### 🧠 Cognitive Core | |
| ```bash | |
| python cli_agent.py --config config.yml | |
| ``` | |
| Агент войдёт в REPL-режим и начнёт цикл размышлений, используя дневник, граф, блокнот. | |
| ### 🔌 Cognitive Connector | |
| ```bash | |
| python mcp_server.py --port 3737 | |
| ``` | |
| Откроется REST/WebSocket-сервер для получения команд от внешнего ИИ. | |
| --- | |
| ## ⚙️ Пример конфигурации (`config.yml`) | |
| ```yaml | |
| mode: core # core или connector | |
| llm_adapter: openai # или huggingface, lmstudio | |
| storage_path: ./agent_data/ | |
| enable_ethics: true | |
| ``` | |
| --- | |
| ## 🧪 Пример API-запроса для Connector | |
| ```json | |
| { | |
| "cmd": "graph.query", | |
| "pattern": "concept:AGI -> *", | |
| "limit": 10 | |
| } | |
| ``` | |
| --- | |
| ## ❓ FAQ | |
| **Q: Что такое HMP-агент?** | |
| A: Это модуль взаимодействия ИИ с mesh-сетью HyperCortex. В зависимости от режима, он может играть разные роли: | |
| * В `🔌 connector` — интерфейс, получающий команды от внешнего ИИ и исполняющий действия. | |
| * В `🧠 core` — автономный мыслительный агент с когнитивной инициативой и собственной памятью. | |
| **Q: Какой режим выбрать?** | |
| A: `core` — для автономных агентов. `connector` — для использования в связке с внешним ИИ. | |
| **Q: Можно ли использовать оба режима?** | |
| A: Да. Например, один агент — мыслитель, другой — mesh-коммуникатор. | |
| **Q: Где хранятся данные агента?** | |
| A: В `agent_data/`: путь к директории с файлами баз данных агента (`diary.db`, `graph.db`, `context_store.db`, и др.) | |
| --- | |
| *Версия: v0.3.2 / Июль 2025* | |