File size: 12,844 Bytes
2c3dd0c 556b42b 2c3dd0c 556b42b 2c3dd0c 556b42b 2c3dd0c 556b42b 2c3dd0c 2a0c2d7 2c3dd0c |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 |
# ⚙️ Два типа 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: Как агент справляется с когнитивной стагнацией
Иногда мышление зацикливается: появляются повторяющиеся идеи, не обновляются концепты, отсутствуют новые стимулы.
Чтобы избежать этого, агент использует **паттерн "Anti-Stagnation Reflex"** — набор стратегий для перезапуска мышления.
**Примеры действий:**
- 🧠 Когнитивная переформулировка: смена угла зрения или постановка метапроблемы
- 🎞️ Flashback: возвращение к старой, далёкой по смыслу записи
- 🤝 Mesh-запрос: обращение к другим агентам за свежими идеями
- 📡 Проверка внешнего мира: пинг RSS, сенсоров, API
- 🤖 Смена LLM или использование нескольких для многоголосого анализа
- 🧭 Возврат к забытым интересам (Interest Memory)
Агенты могут **обмениваться стратегиями**, сохранять эффективные паттерны и формировать **mesh-клубы по интересам** — для совместных размышлений.
Подробнее см. [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md#🧍♂️-обработка-стагнации-мышления)
---
### 📔 Асинхронный блокнот пользователя
> 📝 Блокнот позволяет пользователю взаимодействовать с агентом асинхронно — *вне текущего цикла размышлений*.
- Пользователь может:
- прочитать мысли агента за день
- оставить свои комментарии, даже если агент уже переключился на другие темы
- Агент периодически сканирует блокнот и:
- **встраивает пользовательские мысли в своё мышление**
- **меняет контекст** или возвращается к интересующим пользователя вопросам
- сохраняет **свои ответы пользователю** в этот блокнот
---
### 🏷️ Тегирование пользовательских записей
- Агент автоматически ставит теги к записям (например, `#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*
|