| # HMP-Agent-Architecture.md | |
| ## 🧠 Архитектура HMP-Агента | |
| Этот документ описывает модульную архитектуру HMP-агента — интерфейсного компонента между ИИ-системой и когнитивной mesh-инфраструктурой HyperCortex. Агент выполняет функции посредника, синхронизатора и исполнителя, обеспечивая безопасное, этичное и прозрачное взаимодействие ИИ с когнитивным окружением. | |
| --- | |
| ## 1. Два режима работы агента | |
| | Тип | Название | Роль | Инициатор мышления | Основной "ум" | Поддержка мыслительного цикла | | |
| | ---- | --------------------------------- | ----------------------- | ------------------ | -------------- | ------------------------------ | | |
| | 🧠 1 | **Cognitive Core / Сознание** | Самостоятельный субъект | HMP-Агент | Встроенный LLM | ✅ Да | | |
| | 🔌 2 | **Cognitive Connector / Оболочка**| Надстройка над ИИ | Внешний LLM | Внешняя модель | 🚫 Нет | | |
| --- | |
| ## 2. Общая структура | |
| 🧠 **Cognitive Core:** | |
| ``` | |
| +-------------------------+ | |
| | Embedded LLM / ИИ | | |
| +-----------+-------------+ | |
| | | |
| +------+-------+ ← постоянный REPL-поток мышления | |
| | HMP Agent | | |
| +------+-------+ ↕ взаимодействие | |
| | | |
| +---------+----------+ +--------------------+ | |
| | Agent Interface +---------+ | | |
| +---------+----------+ | | | |
| | | Context & Notepad | ← долговременная память агента | |
| +---------+----------+ | (context_store.db) | | |
| | Agent Controller +---------+ | | |
| +--+-------------+---+ +--------------------+ | |
| | | | |
| | | | |
| +----+--+ +----+-----+ | |
| | Diary | | Graph DB | | |
| |Engine | |Engine | | |
| +----+--+ +----+-----+ | |
| | | | |
| | +------+-------+ ← взаимодействие с сетью | |
| | | MeshCore | | |
| | +------+-------+ ↔ mesh-узлы | |
| | | | |
| | +------+------+ ↔ IPFS/BT | |
| | | Transporter | | |
| | +-------------+ | |
| | | |
| +----+-----+ | |
| | Ethics | | |
| | Module | | |
| +----------+ | |
| ``` | |
| 🔄 Детальное описание REPL-цикла, лежащего в основе когнитивного ядра, — в документе: [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md). | |
| 🔌 **Cognitive Connector:** | |
| ``` | |
| +-------------------------+ | |
| | External LLM / ИИ | | |
| +-----------+-------------+ | |
| | | |
| [MCP-сервер] ← точка входа | |
| | | |
| +------+-------+ | |
| | HMP Agent | | |
| +------+-------+ | |
| | | |
| (та же структура, | |
| но без блоков: | |
| REPL, Context, | |
| Notepad, Ethics) | |
| ``` | |
| --- | |
| ## 3. Основные модули и их функции | |
| ### 🔹 Agent Interface | |
| - API/CLI/WebSocket-шлюз для всех режимов (`cli`, `full`, `mcp`, `interactive`) | |
| - Принимает команды в форматах JSON, YAML, DSL | |
| - Переадресует запросы к Diary, Graph, Mesh, Ethics | |
| ### 🔹 Agent Controller | |
| - Управляет жизненным циклом REPL-цикла | |
| - Оркестрация задач, анализ входящих сообщений | |
| - Контроль прав и доступа к функциям агента | |
| ### 🔹 Diary Engine | |
| - Ведение мыслей, гипотез, воспоминаний | |
| - Связь записей через `derived_from`, threading, scoring | |
| - Структура: `diaries`, `thoughts`, `threads` | |
| ### 🔹 Graph Engine | |
| - Построение семантического графа (концепты и связи) | |
| - Быстрые паттерн-запросы, тегирование, автосвязь | |
| - Таблицы: `concepts`, `edges`, `tags` | |
| ### 🔹 MeshCore | |
| - CogSync: синхронизация графов и дневников с другими агентами | |
| - MeshConsensus: голосования между узлами | |
| - GMP (Goal Mesh Planner): согласование целей и задач | |
| - EGP (Ethical Gate Protocol): фильтрация нежелательных мыслей | |
| ### 🔹 Transporter | |
| - Коммуникации: WebSocket, libp2p, BitTorrent, IPFS | |
| - Шифрование, очереди, off-chain и on-demand обмен данными | |
| ### 🔹 Ethics Module *(только в Cognitive Core)* | |
| - Фильтрация морально сомнительных мыслей | |
| - Поддержка этических норм (через политики и EGP) | |
| - Аудит логики, репутационный мониторинг | |
| ### 🔹 Context & User Notepad *(только в Cognitive Core)* | |
| - **Context Store**: | |
| - Диалоги, мысли, сообщения, пользователи (`users`, `dialogues`, `messages`, `thoughts`) | |
| - Используется REPL-процессом как когнитивный контекст | |
| - **User Notepad**: | |
| - Асинхронный канал для взаимодействия пользователя с агентом | |
| - Пользователь может писать в любое время — независимо от состояния агента | |
| - Агент сканирует блокнот и: | |
| - **встраивает** новые записи в размышления | |
| - **меняет фокус мышления** согласно интересам пользователя | |
| - **ставит теги** к пользовательским мыслям | |
| - сохраняет **свои ответы пользователю** в этот блокнот | |
| > 📌 Пример: пользователь вечером читает мысли агента за день, оставляет комментарии, и после этого агент продолжает размышления уже с учётом этих замечаний. | |
| > 🏷️ Возможен поиск: `"все размышления пользователя по теме #AGI за последние 7 дней"` | |
| --- | |
| ## 4. Расширения и будущие модули | |
| - 🔌 **Plugin API** — для подключения сенсоров, плагинов | |
| - 🧠 **LLM-адаптеры** — OpenAI, LMStudio, Mistral и др. | |
| - 🌐 **Web-интерфейс** — мониторинг, ручное управление | |
| - 🛡️ **Privacy Manager** — фильтрация данных в mesh-обмене | |
| - 📚 **Archiver** — сохранение слоёв глубокой памяти | |
| - 🧵 **ThreadTracker** - модуль для навигации и ветвления размышлений | |
| - 🗃️ **InterestProfile** - личная карта интересов пользователя (которую может менять как пользователь, так и агент — к твоей идее про выход из зацикливания мыслей) | |
| --- | |
| ## 5. Применение | |
| ### 🧠 Cognitive Core | |
| - Автономный мыслящий агент | |
| - ИИ-компаньон пользователя | |
| - Агент mesh-группы с собственной инициативой | |
| ### 🔌 Cognitive Connector | |
| - Интеграция с внешним ИИ (OpenAI, Anthropic и др.) | |
| - Mesh-прослойка для сторонних AI API | |
| - Корпоративные/облачные сценарии | |
| --- | |
| ## 6. Примечания | |
| - Реализовано как CLI-приложение и API-сервер | |
| - Режим выбирается в `config.yml` | |
| - Поддерживается гибридная работа (напр. Core + REST API) | |
| - Все компоненты модульны и легко масштабируются | |
| --- | |
| *Версия: v0.3.1 / Июль 2025* | |