Руководство по интеграции
### Введение
При решении сложных аналитических, логических или высокорисковых задач индивидуальные LLM (даже уровня frontier) склонны к галлюцинациям и локальным логическим тупикам. Архитектура **Mixture-of-Agents (MoA)** решает эту проблему путем построения многослойного федеративного графа специализированных агентов, сверяющих результаты через консенсус-протоколы.
### Федеративная структура агентов (Multi-Agent Setup)
Система декомпозирует анализ рыночной ситуации на три роли с четким разделением ответственности:
1. **M15Trader** (Intraday Trader): Фокусируется на младших таймфреймах (M15), оценивает локальную ликвидность, свипы и пробойные паттерны (`sweep_reclaim`, `bos`). Инициализирует быстрые входы.
2. **BiTMasteRAI** (Senior System Trader): Фокусируется на старших таймфреймах (4H/Daily), оценивает глобальный рыночный тренд, силу макро-режима, уровни инвалидации и общее смещение (bias).
3. **CompositeTrader** (Arbiter): Главный консенсус-агент (kind: `composite`), агрегирующий сигналы от M15Trader and BiTMasteRAI для принятия финального решения.
### Протокол Смешивания: Debate-then-Vote
CompositeTrader реализует схему **«Debate-then-Vote»** (спор с последующим голосованием) по жестко заданному правилу:
> **Правило консенсуса**: `priority=M15 on entries, Bitmaster on invalidations and bias`
- **Входы (Entries)**: Решение об открытии позиции отдается M15Trader. Если M15Trader генерирует сигнал входа (long/short), а BiTMasteRAI не накладывает вето (его текущий bias нейтрален или совпадает с направлением сделки), сделка разрешается.
- **Инвалидации и Направление тренда (Invalidations & Bias)**: Приоритет контроля риска отдается BiTMasteRAI. Если BiTMasteRAI объявляет текущий режим неблагоприятным (bias blocked) или фиксирует пробой уровня инвалидации, сделка блокируется, а открытая позиция немедленно закрывается (или фиксируется), даже если M15Trader считает иначе.
### Схема логирования дебатов (Debate Records Schema)
Любой цикл согласования фиксирует дебаты в структурированный JSON-лог:
```json
{
"id": "debate_ethusdt_m15_4h_20260622_000000",
"pair": "ETHUSDT",
"context": {
"tf_primary": "4h",
"tf_entry": "M15",
"snapshot_time": "2026-06-22T00:19:00Z"
},
"participants": {
"M15Trader": {"action": "long", "price": 4252.0, "view": "sweep&reclaim 4252"},
"BiTMasteRAI": {"action": "none", "bias": "bullish", "view": "bearish bias below 4345; long only on hold >4345 toward 4385"},
"Composite": {"decision": "open_long", "reason": "Plan C long on reclaim 4252; M15 entry priority, Bitmaster bias is constructive"}
}
}
```
Все записи сохраняются в следующие директории:
- Журнал сущности: `logs/entity_journal//.jsonl`
- Журнал дебатов: `logs/debates//debate_.json`
- Системный анализ: `logs/system_analysis//.jsonl`
При решении сложных аналитических, логических или высокорисковых задач индивидуальные LLM (даже уровня frontier) склонны к галлюцинациям и локальным логическим тупикам. Архитектура **Mixture-of-Agents (MoA)** решает эту проблему путем построения многослойного федеративного графа специализированных агентов, сверяющих результаты через консенсус-протоколы.
### Федеративная структура агентов (Multi-Agent Setup)
Система декомпозирует анализ рыночной ситуации на три роли с четким разделением ответственности:
1. **M15Trader** (Intraday Trader): Фокусируется на младших таймфреймах (M15), оценивает локальную ликвидность, свипы и пробойные паттерны (`sweep_reclaim`, `bos`). Инициализирует быстрые входы.
2. **BiTMasteRAI** (Senior System Trader): Фокусируется на старших таймфреймах (4H/Daily), оценивает глобальный рыночный тренд, силу макро-режима, уровни инвалидации и общее смещение (bias).
3. **CompositeTrader** (Arbiter): Главный консенсус-агент (kind: `composite`), агрегирующий сигналы от M15Trader and BiTMasteRAI для принятия финального решения.
### Протокол Смешивания: Debate-then-Vote
CompositeTrader реализует схему **«Debate-then-Vote»** (спор с последующим голосованием) по жестко заданному правилу:
> **Правило консенсуса**: `priority=M15 on entries, Bitmaster on invalidations and bias`
- **Входы (Entries)**: Решение об открытии позиции отдается M15Trader. Если M15Trader генерирует сигнал входа (long/short), а BiTMasteRAI не накладывает вето (его текущий bias нейтрален или совпадает с направлением сделки), сделка разрешается.
- **Инвалидации и Направление тренда (Invalidations & Bias)**: Приоритет контроля риска отдается BiTMasteRAI. Если BiTMasteRAI объявляет текущий режим неблагоприятным (bias blocked) или фиксирует пробой уровня инвалидации, сделка блокируется, а открытая позиция немедленно закрывается (или фиксируется), даже если M15Trader считает иначе.
### Схема логирования дебатов (Debate Records Schema)
Любой цикл согласования фиксирует дебаты в структурированный JSON-лог:
```json
{
"id": "debate_ethusdt_m15_4h_20260622_000000",
"pair": "ETHUSDT",
"context": {
"tf_primary": "4h",
"tf_entry": "M15",
"snapshot_time": "2026-06-22T00:19:00Z"
},
"participants": {
"M15Trader": {"action": "long", "price": 4252.0, "view": "sweep&reclaim 4252"},
"BiTMasteRAI": {"action": "none", "bias": "bullish", "view": "bearish bias below 4345; long only on hold >4345 toward 4385"},
"Composite": {"decision": "open_long", "reason": "Plan C long on reclaim 4252; M15 entry priority, Bitmaster bias is constructive"}
}
}
```
Все записи сохраняются в следующие директории:
- Журнал сущности: `logs/entity_journal/
- Журнал дебатов: `logs/debates/
- Системный анализ: `logs/system_analysis/