5290287058
- 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)
141 lines
4.1 KiB
Markdown
141 lines
4.1 KiB
Markdown
# 🚀 Повне налаштування Helion на НОДА1
|
||
|
||
**Дата:** 2026-01-12
|
||
**Агент:** Helion (Energy Union)
|
||
|
||
---
|
||
|
||
## ✅ Що вже налаштовано
|
||
|
||
1. ✅ **Gateway** - додано в docker-compose.node1.yml
|
||
2. ✅ **Router** - працює на НОДА1
|
||
3. ✅ **Swapper** - працює на НОДА1
|
||
4. ✅ **NATS** - працює на НОДА1
|
||
5. ✅ **PostgreSQL** - працює на НОДА1
|
||
6. ✅ **Telegram webhook** - налаштовано
|
||
|
||
---
|
||
|
||
## 🔧 Що додано
|
||
|
||
### 1. Memory Service
|
||
- **Порт:** 8000
|
||
- **База:** PostgreSQL (`daarion_memory`)
|
||
- **Функції:** Facts, Events, Summaries
|
||
|
||
### 2. Qdrant (Векторна БД)
|
||
- **Порт:** 6333 (HTTP), 6334 (gRPC)
|
||
- **Функції:** Векторний пошук, RAG
|
||
|
||
### 3. Neo4j (Графова БД)
|
||
- **Порт:** 7474 (HTTP), 7687 (Bolt)
|
||
- **Функції:** Графові зв'язки між сутностями
|
||
|
||
### 4. Redis (Кеш)
|
||
- **Порт:** 6379
|
||
- **Функції:** Кешування контексту
|
||
|
||
### 5. Deepseek API
|
||
- **Профіль:** `cloud_deepseek` (вже в router-config.yml)
|
||
- **Змінна:** `DEEPSEEK_API_KEY` (потрібно встановити)
|
||
|
||
---
|
||
|
||
## 🔄 Підключення через DAGI Router
|
||
|
||
**Так, агент підключається через DAGI Router!**
|
||
|
||
Схема:
|
||
```
|
||
Telegram → Gateway (Helion) → Router → Memory/Qdrant/Neo4j/Deepseek
|
||
```
|
||
|
||
Router має доступ до:
|
||
- ✅ Memory Service (через `MEMORY_SERVICE_URL`)
|
||
- ✅ Qdrant (через `QDRANT_HOST`)
|
||
- ✅ Neo4j (через `NEO4J_BOLT_URL`)
|
||
- ✅ Deepseek (через `DEEPSEEK_API_KEY`)
|
||
|
||
---
|
||
|
||
## 🧠 Типи пам'яті для Helion
|
||
|
||
### 1. **Facts (Факти)** - PostgreSQL
|
||
- Довгострокові факти про користувача
|
||
- Структуровані дані (ключ-значення)
|
||
|
||
### 2. **Events (Події)** - PostgreSQL
|
||
- Короткострокова пам'ять про діалоги
|
||
- Scope: `short_term` / `long_term`
|
||
|
||
### 3. **Summaries (Підсумки)** - PostgreSQL
|
||
- Стислі підсумки довгих діалогів
|
||
|
||
### 4. **Vector Search** - Qdrant
|
||
- Векторний пошук документів
|
||
- RAG (Retrieval-Augmented Generation)
|
||
|
||
### 5. **Graph Relations** - Neo4j
|
||
- Графові зв'язки між сутностями
|
||
- Користувачі, команди, агенти
|
||
|
||
### 6. **Context Cache** - Redis
|
||
- Кешування контексту (TTL: 5 сек)
|
||
|
||
---
|
||
|
||
## 🚀 Наступні кроки
|
||
|
||
### 1. Встановити Deepseek токен
|
||
```bash
|
||
# На НОДА1
|
||
export DEEPSEEK_API_KEY="sk-..."
|
||
# Або додати в .env файл
|
||
```
|
||
|
||
### 2. Запустити нові сервіси
|
||
```bash
|
||
ssh root@144.76.224.179
|
||
cd /opt/microdao-daarion
|
||
docker compose -f docker-compose.node1.yml up -d memory-service qdrant neo4j redis
|
||
```
|
||
|
||
### 3. Перезапустити Router з новими змінними
|
||
```bash
|
||
docker compose -f docker-compose.node1.yml restart router
|
||
```
|
||
|
||
### 4. Перевірити статус
|
||
```bash
|
||
docker ps | grep -E 'memory|qdrant|neo4j|redis'
|
||
curl http://localhost:8000/health # Memory Service
|
||
curl http://localhost:6333/healthz # Qdrant
|
||
curl http://localhost:7474 # Neo4j
|
||
redis-cli PING # Redis
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 Конфігурація Router для Helion
|
||
|
||
В `router-config.yml` вже налаштовано:
|
||
- ✅ Helion агент (рядок 295-334)
|
||
- ✅ Deepseek профіль (рядок 94-102)
|
||
- ✅ Routing rules для Helion (рядок 528-534)
|
||
|
||
**Для використання Deepseek:**
|
||
- Router автоматично використовує `cloud_deepseek` для складних запитів
|
||
- Або можна вказати `metadata.provider: "cloud_deepseek"` в Gateway
|
||
|
||
---
|
||
|
||
## ⚠️ Важливо
|
||
|
||
1. **Deepseek токен** - потрібно встановити `DEEPSEEK_API_KEY`
|
||
2. **PostgreSQL база** - потрібно створити `daarion_memory` базу
|
||
3. **Neo4j пароль** - за замовчанням `neo4j/neo4j` (потрібно змінити!)
|
||
|
||
---
|
||
|
||
**Оновлено:** 2026-01-12
|