# 🚀 Повне налаштування 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