microdao-daarion/README-ENHANCED-CHAT.md

🎉 Розширений чат з оркестраторами - README

Версія: 1.0.0
Дата: 2025-11-23

---

🚀 Швидкий старт

1. Запуск проєкту

# Встановити залежності (якщо ще не встановлено)
npm install

# Запустити dev сервер
npm run dev

# Відкрити у браузері
http://localhost:8899

2. Перегляд demo

Відкрити у браузері:

http://localhost:8899/chat-demo

3. Використання у кабінеті мікроДАО

Відкрити будь-який кабінет:

• http://localhost:8899/microdao/daarion
• http://localhost:8899/microdao/greenfood
• http://localhost:8899/microdao/energy-union
• http://localhost:8899/microdao/yaromir

У секції "Чат з оркестратором мікроДАО" увімкнути "Розширений режим"

---

📦 Що входить?

Компоненти (8)

1. MicroDaoOrchestratorChatEnhanced.tsx - Головний компонент з усіма функціями
2. MicroDaoOrchestratorChatWrapper.tsx - Wrapper для вибору версії
3. MultimodalInput.tsx - Мультимодальний ввід
4. KnowledgeBase.tsx - Управління базою знань
5. SystemPromptEditor.tsx - Редагування системного промпту
6. TelegramIntegration.tsx - Інтеграція з Telegram

Сервіси (3)

1. voiceService.ts - Голосовий ввід/вивід
2. webSearchService.ts - Веб-пошук
3. knowledgeBaseService.ts - Робота з базою знань

Сторінки (1)

1. ChatDemoPage.tsx - Demo сторінка з 3 layout варіантами

---

🎯 Основні функції

🎤 Голосовий ввід

• Натисніть кнопку мікрофона
• Промовте своє повідомлення українською
• Текст автоматично з'явиться у полі вводу

🖼️ Завантаження зображень

• Натисніть кнопку зображення
• Виберіть файл або перетягніть (Drag & drop)
• Preview з'явиться перед відправкою

📎 Прикріплення файлів

• Натисніть кнопку скріпки
• Виберіть файл (PDF, DOC, DOCX, TXT, MD, JSON)
• Файл буде відправлений разом з повідомленням

🌐 Веб-пошук

• Натисніть кнопку глобусу
• Введіть пошуковий запит
• Отримайте результати з інтернету

📚 База знань

• Розгорніть секцію "База знань агента"
• Завантажте файли для навчання агента
• Файли автоматично індексуються у Vector + Graph DB

⚙️ Системний промпт

• Розгорніть секцію "Системний промпт агента"
• Натисніть "Редагувати"
• Змініть промпт агента
• Натисніть "Зберегти"

💬 Telegram

• Розгорніть секцію "Інтеграція з Telegram"
• Створіть бота через @BotFather
• Введіть токен
• Підключіть бота

---

📖 Документація

Основна документація

• ORCHESTRATOR-CHAT-ENHANCED.md - Детальний опис всіх компонентів
• INTEGRATION-EXAMPLE.md - Приклади інтеграції
• CHAT-ARCHITECTURE.md - Архітектура системи
• FINAL-IMPLEMENTATION-SUMMARY.md - Фінальний підсумок

Fixes документація

• CHAT-MESSAGE-FIX.md - Виправлення відправки повідомлень
• TIMEOUT-FIX.md - Оптимізація таймаутів

---

🎨 Layout варіанти (Demo сторінка)

1. Tabs Layout

Горизонтальні вкладки з агентами зверху

2. Sidebar Layout

Бічна панель з агентами ліворуч, чат праворуч

3. Modal Layout

Сітка карток агентів, чат по центру

---

🤖 Доступні агенти

⚡ Helion

AI-агент платформи Energy Union

• Енергетичні технології
• Токеноміка
• DAO governance

🌱 GREENFOOD

AI-ERP для крафтових виробників

• Управління товарами
• Якість та партії
• Логістика та продажі

🧙 Yaromir

Оркестратор CrewAI команди

• Стратегічне планування
• Команда з 4 агентів
• Мудрі поради

✨ DAARWIZZ

Головний AI-агент DAARION.city

• Загальна інформація
• Маршрутизація запитів
• Навігація по платформі

---

🔧 Налаштування

Environment Variables

# .env
VITE_NODE1_URL=http://144.76.224.179:9102  # Router URL
VITE_API_URL=http://144.76.224.179:8899     # Backend API URL

Router Configuration

Переконайтеся, що Router (NODE1) працює на порту 9102:

curl http://144.76.224.179:9102/health

---

🐛 Troubleshooting

Проблема: Чат не відповідає

Перевірте:

1. Router працює: curl http://144.76.224.179:9102/health
2. Ollama працює: curl http://localhost:11434/api/tags
3. Консоль браузера (F12) на помилки

Рішення:

• Перезавантажити Router: ssh root@144.76.224.179 "docker restart dagi-router"
• Перевірити логи: ssh root@144.76.224.179 "docker logs dagi-router --tail 50"

Проблема: Голосовий ввід не працює

Перевірте:

1. Браузер підтримує Web Speech API (Chrome, Edge)
2. Дозвіл на мікрофон надано
3. Використовуєте HTTPS або localhost

Рішення:

• Дати дозвіл на мікрофон у налаштуваннях браузера
• Використовувати Chrome або Edge

Проблема: Файли не завантажуються

Перевірте:

1. Розмір файлу < 50 МБ
2. Тип файлу підтримується
3. Backend API доступний

Рішення:

• Зменшити розмір файлу
• Використовувати підтримувані формати: PDF, DOC, DOCX, TXT, MD, JSON

---

💡 Поради

Для розробників

1. Використовуйте TypeScript

   • Всі компоненти повністю типізовані
   • Імпортуйте типи з компонентів

2. Модульність

   • Кожен компонент можна використовувати окремо
   • Імпорт через chat/index.ts

3. Services

   • Використовуйте singleton instances
   • Імпорт через services/index.ts

Для користувачів

1. Голосовий ввід

   • Говоріть чітко та повільно
   • Використовуйте паузи між фразами

2. База знань

   • Завантажуйте якісні документи
   • Дочекайтеся повної індексації

3. Системний промпт

   • Будьте конкретними у інструкціях
   • Включайте контекст та обмеження

---

📊 Статус Backend API

✅ Готово (Frontend)

• Всі компоненти UI
• Всі сервіси клієнти
• Error handling
• Loading states

⏳ В розробці (Backend)

• Knowledge Base API
• System Prompt API
• Telegram API
• Web Search API
• Image Recognition API

---

🚀 Наступні версії

v1.1 (Planned)

• ✅ Voice Output (TTS)
• ✅ Image Recognition
• ✅ Real-time Collaboration

v1.2 (Planned)

• ✅ Context Memory
• ✅ Multi-language Support
• ✅ Advanced Analytics

v2.0 (Future)

• ✅ Video Calls
• ✅ Screen Sharing
• ✅ AI Assistants Marketplace

---

📞 Контакти та підтримка

Документація

• GitHub: /docs
• README: цей файл
• Detailed Docs: ORCHESTRATOR-CHAT-ENHANCED.md

Issues

• Створюйте issue на GitHub
• Додавайте скріншоти та логи
• Описуйте кроки для відтворення

---

✅ Чекліст перед використанням

• Node.js встановлено
• Залежності встановлені (npm install)
• .env налаштовано
• Router працює (NODE1)
• Ollama працює
• Dev server запущено

---

🎉 Готово!

Насолоджуйтесь розширеним чатом з оркестраторами мікроДАО! 🚀

Якщо є питання - дивіться детальну документацію у файлах:

• ORCHESTRATOR-CHAT-ENHANCED.md
• INTEGRATION-EXAMPLE.md
• FINAL-IMPLEMENTATION-SUMMARY.md