- TTS: xtts-v2 integration with voice cloning support
- Document: docling integration for PDF/DOCX/PPTX processing
- Memory Service: added /facts/upsert, /facts/{key}, /facts endpoints
- Added required dependencies (TTS, docling)
144 lines
4.5 KiB
Markdown
144 lines
4.5 KiB
Markdown
# 🎯 Фінальний підсумок: Helion на НОДА1
|
||
|
||
**Дата:** 2026-01-12
|
||
**Статус:** ✅ Готово до розгортання
|
||
|
||
---
|
||
|
||
## ✅ Що налаштовано
|
||
|
||
### 1. Gateway Bot
|
||
- ✅ Контейнер: `dagi-gateway-node1`
|
||
- ✅ Порт: 9300
|
||
- ✅ Токен Helion: `8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE`
|
||
- ✅ Webhook: `https://gateway.daarion.city/8112062582/telegram/webhook`
|
||
|
||
### 2. Сервіси пам'яті
|
||
- ✅ **Memory Service** (PostgreSQL) - порт 8000
|
||
- Facts, Events, Summaries
|
||
- ✅ **Qdrant** (векторна БД) - порт 6333/6334
|
||
- Векторний пошук, RAG
|
||
- ✅ **Neo4j** (графова БД) - порт 7474/7687
|
||
- Графові зв'язки між сутностями
|
||
- ✅ **Redis** (кеш) - порт 6379
|
||
- Кешування контексту (TTL: 5 сек)
|
||
|
||
### 3. Deepseek API
|
||
- ✅ Токен: `sk-0db94e8193ec4a6e9acd593ee8d898e7`
|
||
- ✅ Профіль: `cloud_deepseek` (вже в router-config.yml)
|
||
- ✅ Використання: для складних запитів
|
||
|
||
### 4. Router
|
||
- ✅ Підключення до Memory Service
|
||
- ✅ Підключення до Qdrant
|
||
- ✅ Підключення до Neo4j
|
||
- ✅ Підключення до Deepseek
|
||
|
||
---
|
||
|
||
## 🧠 Типи пам'яті для Helion
|
||
|
||
### 1. **Facts** (PostgreSQL)
|
||
- Довгострокові факти про користувача
|
||
- Структуровані дані (ключ-значення)
|
||
- Зберігаються назавжди
|
||
|
||
### 2. **Events** (PostgreSQL)
|
||
- Короткострокова пам'ять про діалоги
|
||
- Scope: `short_term` (нещодавні) / `long_term` (архівні)
|
||
- Обмежені за кількістю (limit: 10)
|
||
|
||
### 3. **Summaries** (PostgreSQL)
|
||
- Стислі підсумки довгих діалогів
|
||
- Містять теми та метадані
|
||
- Використовуються для масштабування контексту
|
||
|
||
### 4. **Vector Search** (Qdrant)
|
||
- Векторний пошук документів
|
||
- RAG (Retrieval-Augmented Generation)
|
||
- Семантичний пошук
|
||
|
||
### 5. **Graph Relations** (Neo4j)
|
||
- Графові зв'язки між сутностями
|
||
- Користувачі, команди, агенти
|
||
- Аналіз взаємозв'язків
|
||
|
||
### 6. **Context Cache** (Redis)
|
||
- Кешування контексту (TTL: 5 сек)
|
||
- Оптимізація запитів
|
||
- Швидкий доступ до нещодавніх подій
|
||
|
||
---
|
||
|
||
## 🔄 Підключення через DAGI Router
|
||
|
||
**Так, агент підключається через DAGI Router!**
|
||
|
||
Схема:
|
||
```
|
||
Telegram Message
|
||
↓
|
||
Gateway (Helion)
|
||
↓
|
||
1. Отримати контекст пам'яті:
|
||
- Facts (PostgreSQL)
|
||
- Recent Events (PostgreSQL)
|
||
- Dialog Summaries (PostgreSQL)
|
||
- Vector Search (Qdrant) - опціонально
|
||
- Graph Relations (Neo4j) - опціонально
|
||
↓
|
||
2. Передати повідомлення + контекст в Router
|
||
↓
|
||
3. Router вирішує:
|
||
- Використати локальну модель (qwen3:8b через Swapper)
|
||
- Або Deepseek API (для складних запитів)
|
||
↓
|
||
4. Router генерує відповідь з урахуванням контексту
|
||
↓
|
||
5. Gateway зберігає turn діалогу:
|
||
- Повідомлення користувача (event)
|
||
- Відповідь агента (event)
|
||
↓
|
||
6. Відправити відповідь в Telegram
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 Наступні кроки
|
||
|
||
### 1. Завантажити файли на НОДА1
|
||
```bash
|
||
scp docker-compose.node1.yml root@144.76.224.179:/opt/microdao-daarion/
|
||
scp -r gateway-bot root@144.76.224.179:/opt/microdao-daarion/
|
||
scp -r services/memory-service root@144.76.224.179:/opt/microdao-daarion/services/
|
||
```
|
||
|
||
### 2. Створити базу даних
|
||
```bash
|
||
ssh root@144.76.224.179
|
||
docker exec -it dagi-postgres psql -U postgres -c "CREATE DATABASE daarion_memory;"
|
||
```
|
||
|
||
### 3. Запустити сервіси
|
||
```bash
|
||
cd /opt/microdao-daarion
|
||
docker compose -f docker-compose.node1.yml up -d
|
||
```
|
||
|
||
### 4. Перевірити статус
|
||
```bash
|
||
docker ps | grep -E 'gateway|router|memory|qdrant|neo4j|redis'
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 Документація
|
||
|
||
- **Повне налаштування:** `HELION-COMPLETE-SETUP.md`
|
||
- **Типи пам'яті:** `HELION-MEMORY-TYPES.md`
|
||
- **Готовність до розгортання:** `HELION-READY-TO-DEPLOY.md`
|
||
|
||
---
|
||
|
||
**Оновлено:** 2026-01-12
|