744c149300
Some checks failed
Build and Deploy Docs / build-and-deploy (push) Has been cancelled
- Created logs/ structure (sessions, operations, incidents) - Added session-start/log/end scripts - Installed Git hooks for auto-logging commits/pushes - Added shell integration for zsh - Created CHANGELOG.md - Documented today's session (2026-01-10)
336 lines
9.4 KiB
Markdown
336 lines
9.4 KiB
Markdown
# 🎉 Розширений чат з оркестраторами - README
|
||
|
||
**Версія:** 1.0.0
|
||
**Дата:** 2025-11-23
|
||
|
||
---
|
||
|
||
## 🚀 Швидкий старт
|
||
|
||
### 1. Запуск проєкту
|
||
|
||
```bash
|
||
# Встановити залежності (якщо ще не встановлено)
|
||
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
|
||
|
||
```bash
|
||
# .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:
|
||
```bash
|
||
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`
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|