daarion-admin/microdao-daarion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b79db5b2a4612feb658b0d2cb4d337b6bdcda7b0
microdao-daarion/README-ENHANCED-CHAT.md

9.3 KiB
Raw Blame History

🎉 Розширений чат з оркестраторами - 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
Reference in New Issue View Git Blame Copy Permalink