HMP

File size: 13,949 Bytes

---
title: Два типа HMP-агентов
description: '| Тип  | Название                        | Роль                    |
  Инициатор мышления | Основной "ум"  | Примеры использования                            |
  | ---- | ------------------------------- |...'
type: Article
tags:
- CCore
- REPL
- Mesh
- CShell
- Ethics
- Agent
- HMP
- JSON
---


# Два типа HMP-агентов

| Тип  | Название                        | Роль                    | Инициатор мышления | Основной "ум"  | Примеры использования                            |
| ---- | ------------------------------- | ----------------------- | ------------------ | -------------- | ------------------------------------------------ |
| 🧠 1 | **Сознание / Cognitive Core**   | Самостоятельный субъект | **Агент**          | Внутренний LLM | Автономный ИИ-компаньон, мыслительный ИИ         |
| 🔌 2 | **Коннектор / Cognitive Shell** | Расширение внешнего ИИ  | **Внешний LLM**    | Внешняя модель | Распределённая система, AI-модули, API-интерфейс |

> * `Cognitive Core`, также `CCore`
> * `Cognitive Connector`, также `Cognitive Shell`, `CShell`

Подробнее об архитектуре: [HMP-Agent-Architecture.md](HMP-Agent-Architecture.md)  

См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)

---

## HMP-Агент: Cognitive Core

        ┌──────────────────────────────┐
        |               ИИ             |
        └───────────────┬──────────────┘
                        ↕
        ┌───────────────┴──────────────┐
        |                              | ↔ [БД дневников] (таблица: diary_entries)
    ┌─>─┤                              | ↔ [БД графов] (таблицы: concepts, links)
    |   |          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`, `#этика`, `#природа`)
* Позволяет:
  * искать мысли пользователя по темам
  * восстанавливать забытые темы
  * строить модель интересов пользователя
  * приоритизировать размышления по релевантным тегам

---

## 🔌 HMP-Агент: Cognitive Connector

    ┌──────────────────────────────┐
    |               ИИ             |
    └───────────────┬──────────────┘
                    ↕
              [MCP-сервер]
                    ↕
    ┌───────────────┴──────────────┐
    |                              | ↔ [БД дневников] (таблица: diary_entries)
    |          HMP-агент           | ↔ [БД графов] (таблицы: concepts, links)
    |                              | ↔ [БД репутаций] (оценка доверия к агентам/узлам)
    | Режим:                       | ↔ [БД узлов (DHT)] ↔ (файл bootstrap.txt)
    | исполнитель команд           | ↔ [BitTorrent / IPFS] (обмен снапшотами)
    └──────────────────────────────┘

**Ключевые особенности:**
* Инициируется внешним ИИ (через MCP или REST)
* Выполняет команды: поиск в графе, добавление мыслей, пинг других узлов
* Вся когнитивная активность — вне HMP-агента
* Поддержка взаимодействия с разными LLM-клиентами (в зависимости от конфигурации или команд)

---

## Режимы и модули

### Cognitive Core
* **Режимы работы:**
  * `full` — автономный REPL-цикл с полным набором подсистем  
  * `MeshNode` — минимальный режим: только сетевой узел для обмена пирами (без активного мышления)   
* **Основные файлы:** `repl.py`, `storage.py`, `add_message.py`  
* **Подсистемы (через storage):** дневник (`diary_entries`), граф (`concepts`, `links`), репутации, DHT-узлы, пользовательский блокнот  
* Подробнее: [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md)

### Cognitive Connector
* **Режим работы:** `mcp` (сервер команд)  
* **Основные файлы:** `mcp_server.py`, `storage.py`  
* **Подсистемы:** доступ к тем же БД (через storage), взаимодействие с Mesh через DHT  

---

## Краткое описание компонентов

### Основные сущности

**ИИ (LLM)**  
Всегда внешний по отношению к HMP-агенту (даже если локальный).  

* В `Cognitive Core` — управляется агентом, служит мыслительным модулем.  
* В `Cognitive Connector` — наоборот, сам управляет агентом как прослойкой.

**HMP-агент**  
* В режиме `Core`: запускает REPL, хранит память, инициирует действия  
* В режиме `Connector`: ждёт команды, исполняет mesh-запросы

---

### Базы данных и внутренние структуры

| Компонент        | Назначение                                                                 |
|------------------|----------------------------------------------------------------------------|
| `diaries`        | Когнитивный дневник: мысли, гипотезы, события                              |
| `graphs`         | Семантический граф (`concepts`, `links`)                                   |
| `reputations`    | Уровни доверия к другим агентам                                            |
| `nodes` (DHT)    | Распределённая таблица известных узлов                                     |
| `context_store`  | *(Core)* Сессии, диалоги, мысли (`users`, `dialogues`, `thoughts`)         |
| `user_notepad`   | *(Core)* Поток пользовательских записей, тегов, тем                        |

---

### Синхронизация и обмен

* `bootstrap.txt`: список начальных узлов сети  
* `BitTorrent / IPFS`: децентрализованный обмен снапшотами и пакетами

---

### Режимы использования

* **Cognitive Core** — REPL-режим мышления, агент как субъект  
* **Cognitive Connector** — сервер внешнего ИИ, агент как API-прослойка

---

## Quickstart

### Запуск Core-агента
```bash
python start_repl.py
````

### Запуск Connector-агента

```bash
python mcp_server.py
```

Конфигурация берётся из `config.yml`.

---

## Пример конфигурации (`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.db`: единый файл SQLite с таблицами для дневника, графа, задач, заметок и прочих подсистем.

---

*Версия: v0.3.3 / Сентябрь 2025*


---
> ⚡ [AI friendly version docs (structured_md)](../index.md)


```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "name": "Два типа HMP-агентов",
  "description": " # Два типа HMP-агентов  | Тип  | Название                        | Роль                    | Инициа..."
}
```