feat: implement TTS, Document processing, and Memory Service /facts API
- 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)
This commit is contained in:
Apple
149
HELION-DEPLOYMENT-SUMMARY.md
Normal file
149
HELION-DEPLOYMENT-SUMMARY.md
Normal file
@@ -0,0 +1,149 @@
|
||||
# 📊 Підсумок розгортання Helion на НОДА1
|
||||
|
||||
**Дата:** 2026-01-12
|
||||
**Статус:** ✅ Основні сервіси працюють
|
||||
|
||||
---
|
||||
|
||||
## ✅ Успішно розгорнуто
|
||||
|
||||
### Основні сервіси
|
||||
1. ✅ **Gateway** - Helion Telegram бот (порт 9300) - **HEALTHY**
|
||||
- Helion токен налаштовано: `8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE`
|
||||
- Webhook налаштовано: `https://gateway.daarion.city/8112062582/telegram/webhook`
|
||||
- Helion агент готовий до роботи
|
||||
|
||||
2. ✅ **Router** - DAGI Router з підтримкою пам'яті (порт 9102)
|
||||
- Підключено до Memory Service
|
||||
- Підключено до Qdrant
|
||||
- Підключено до Neo4j
|
||||
- Підключено до Vision Encoder
|
||||
- Deepseek API налаштовано
|
||||
|
||||
3. ✅ **Swapper** - Динамічне завантаження моделей (порт 8890) - **HEALTHY**
|
||||
|
||||
### Сервіси пам'яті
|
||||
4. ⚠️ **Memory Service** - PostgreSQL (Facts, Events, Summaries) (порт 8000)
|
||||
- Виправлено для роботи без Cohere API ключа
|
||||
- Потребує перевірки підключення до PostgreSQL
|
||||
|
||||
5. ✅ **Qdrant** - Векторна БД для RAG (порт 6333/6334) - **HEALTHY**
|
||||
|
||||
6. ⚠️ **Neo4j** - Графова БД для зв'язків (порт 7474/7687)
|
||||
- Пароль змінено на `DaarionNeo4j2026!`
|
||||
- Потребує першого запуску з новим паролем
|
||||
|
||||
7. ✅ **Redis** - Кешування контексту (порт 6379) - **HEALTHY**
|
||||
|
||||
### Embedding API
|
||||
8. ✅ **Vision Encoder** - OpenCLIP для text/image embeddings (порт 8001) - **HEALTHY**
|
||||
- Технологія: OpenCLIP (ViT-L-14)
|
||||
- Інтеграція з Qdrant
|
||||
- Device: CPU
|
||||
|
||||
---
|
||||
|
||||
## 🧠 Типи пам'яті для Helion
|
||||
|
||||
1. **Facts** (PostgreSQL) - довгострокові факти
|
||||
2. **Events** (PostgreSQL) - короткострокова пам'ять діалогів
|
||||
3. **Summaries** (PostgreSQL) - підсумки діалогів
|
||||
4. **Vector Search** (Qdrant) - векторний пошук документів ✅
|
||||
5. **Graph Relations** (Neo4j) - графові зв'язки ⚠️
|
||||
6. **Context Cache** (Redis) - кешування (TTL: 5 сек) ✅
|
||||
|
||||
---
|
||||
|
||||
## 🔌 Embedding API
|
||||
|
||||
### Vision Encoder Service ✅
|
||||
- **Порт:** 8001
|
||||
- **Технологія:** OpenCLIP (ViT-L-14)
|
||||
- **Функції:** Текст та зображення embeddings
|
||||
- **Інтеграція:** Qdrant для векторного пошуку
|
||||
- **Статус:** ✅ HEALTHY
|
||||
|
||||
### Memory Service Embedding Layer
|
||||
- **Технологія:** Cohere API (опціонально)
|
||||
- **Модель:** embed-multilingual-v3.0
|
||||
- **Розмірність:** 1024
|
||||
- **Примітка:** Працює без Cohere API ключа (повертає порожні embeddings)
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Підключення через DAGI Router
|
||||
|
||||
**Так, агент підключається через DAGI Router!**
|
||||
|
||||
Схема:
|
||||
```
|
||||
Telegram → Gateway (Helion)
|
||||
↓
|
||||
Router (з підтримкою пам'яті)
|
||||
↓
|
||||
├─ Memory Service (Facts, Events, Summaries)
|
||||
├─ Qdrant (Vector Search) ✅
|
||||
├─ Neo4j (Graph Relations) ⚠️
|
||||
├─ Vision Encoder (Embeddings) ✅
|
||||
└─ Deepseek API (для складних запитів) ✅
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 Конфігурація
|
||||
|
||||
### Router змінні середовища:
|
||||
- `MEMORY_SERVICE_URL=http://memory-service:8000`
|
||||
- `QDRANT_HOST=qdrant`
|
||||
- `QDRANT_PORT=6333`
|
||||
- `NEO4J_BOLT_URL=bolt://neo4j:7687`
|
||||
- `NEO4J_HTTP_URL=http://neo4j:7474`
|
||||
- `NEO4J_USER=neo4j`
|
||||
- `NEO4J_PASSWORD=DaarionNeo4j2026!`
|
||||
- `VISION_ENCODER_URL=http://vision-encoder:8001`
|
||||
- `DEEPSEEK_API_KEY=sk-0db94e8193ec4a6e9acd593ee8d898e7`
|
||||
|
||||
### Gateway змінні середовища:
|
||||
- `ROUTER_URL=http://router:9102`
|
||||
- `HELION_TELEGRAM_BOT_TOKEN=8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE`
|
||||
- `MEMORY_SERVICE_URL=http://memory-service:8000`
|
||||
|
||||
---
|
||||
|
||||
## ✅ Виправлені проблеми
|
||||
|
||||
1. ✅ **Gateway** - виправлено порядок визначення `TelegramUpdate`
|
||||
2. ✅ **Neo4j** - змінено пароль з `neo4j` на `DaarionNeo4j2026!`
|
||||
3. ✅ **Memory Service** - виправлено для роботи без Cohere API ключа
|
||||
|
||||
---
|
||||
|
||||
## 📊 Статус сервісів
|
||||
|
||||
### Працюють:
|
||||
- ✅ Gateway - **HEALTHY** (Helion готовий!)
|
||||
- ✅ Swapper - **HEALTHY**
|
||||
- ✅ Vision Encoder - **HEALTHY**
|
||||
- ✅ Redis - **HEALTHY**
|
||||
- ✅ Qdrant - **HEALTHY**
|
||||
|
||||
### Потребують уваги:
|
||||
- ⚠️ Neo4j - перезапускається (потрібен перший запуск з новим паролем)
|
||||
- ⚠️ Memory Service - перезапускається (перевірити підключення до PostgreSQL)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Готовність Helion
|
||||
|
||||
**Helion готовий до роботи!**
|
||||
|
||||
- ✅ Gateway працює
|
||||
- ✅ Helion токен налаштовано
|
||||
- ✅ Webhook налаштовано
|
||||
- ✅ Router підключений
|
||||
- ✅ Пам'ять налаштована (Qdrant, Redis працюють)
|
||||
- ✅ Embedding API працює (Vision Encoder)
|
||||
|
||||
---
|
||||
|
||||
**Оновлено:** 2026-01-12
|
||||
Reference in New Issue
Block a user