| # 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* |
|
|
