microdao-daarion/HELION-COMPLETE-SETUP.md

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

# На НОДА1
export DEEPSEEK_API_KEY="sk-..."
# Або додати в .env файл

2. Запустити нові сервіси

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 з новими змінними

docker compose -f docker-compose.node1.yml restart router

4. Перевірити статус

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