📚 Гід по використанню Discord AI Assistant Bot

🎯 Огляд

Discord AI Assistant Bot - це потужний інструмент для роботи з Google Sheets, Google Drive та AI-аналізом даних прямо в Discord. Бот підтримує природномовні запити, роботу з файлами та створення звітів. ---

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

1. Налаштування ролей

Створіть наступні ролі на вашому Discord сервері:

• Адміністратор - повний доступ до всіх функцій
• Бот-Користувач - базовий доступ
• Sheets-Доступ - доступ до Google Sheets
• AI-Доступ - доступ до AI-функцій
• Експорт-Доступ - доступ до експорту даних

2. Перші команди

/допомога - отримати довідку
/залишки - подивитися підсумкові значення
/оновити - подивитися останні записи

---

🔍 Команди пошуку

/пошук - Пошук за полями

Опис: Пошук даних за конкретним полем таблиці Параметри:
• поле - поле для пошуку (найменування, серійний номер, контрагент, кількість, ціна)
• запит - що шукати
Приклади:

/пошук поле:найменування запит:iPhone
/пошук поле:контрагент запит:Apple
/пошук поле:ціна запит:1000

/розумний-пошук - Розумний пошук

Опис: Пошук за кількома критеріями одночасно Параметри:
• номенклатура - пошук за назвою товару
• контрагент - пошук за контрагентом
• серія - пошук за серійним номером
• ціна_вище - товари дорожче вказаної ціни
• кількість_вище - товари з кількістю більше вказаної
Приклади:

/розумний-пошук номенклатура:iPhone ціна_вище:500
/розумний-пошук контрагент:Apple кількість_вище:10
/розумний-пошук серія:IPH кількість_вище:5

/залишки - Підсумкові значення

Опис: Показує підсумкові значення з таблиці Приклад:

/залишки

/оновити - Останні записи

Опис: Показує останні 10 записів з таблиці Приклад:

/оновити

---

🤖 AI-функції

/ai - AI-асистент

Опис: Природномовний запит до AI для роботи з даними Параметри:
• запит - що ви хочете зробити
• контекст - додатковий контекст (опціонально)
Приклади запитів:

/ai запит:знайди товари iPhone
/ai запит:проаналізуй залишки на складі
/ai запит:створіть звіт по продажам за останній місяць
/ai запит:які товари найпопулярніші
/ai запит:експортуй дані в Excel
/ai запит:покажи статистику по категоріях

Приклади з контекстом:

/ai запит:проаналізуй тренди контекст:за останні 3 місяці
/ai запит:знайди дешеві альтернативи контекст:до 500 грн

---

📁 Робота з файлами

/файли - Робота з Google Drive

Опис: Пошук, читання та аналіз файлів в Google Drive Параметри:
• дія - що робити (пошук, читати, аналіз, звіт)
• запит - назва файлу або ID
• папка - ID папки для пошуку (опціонально)
• тип - тип аналізу (тільки для дії "аналіз")
• формат - формат звіту (тільки для дії "звіт")

Пошук файлів

/файли дія:пошук запит:звіт
/файли дія:пошук запит:документ папка:123456789

Читання файлів

/файли дія:читати запит:звіт_2024.pdf
/файли дія:читати запит:1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms

AI-аналіз файлів

/файли дія:аналіз запит:звіт.pdf тип:summary
/файли дія:аналіз запит:документ.docx тип:detailed
/файли дія:аналіз запит:презентація.pptx тип:key_points

Створення звітів

/файли дія:звіт запит:звіт.pdf формат:txt
/файли дія:звіт запит:документ.docx формат:pdf
/файли дія:звіт запит:презентація.pptx формат:docx

---

📤 Експорт даних

/пошук-експортовано - Експорт результатів пошуку

Опис: Експортує результати пошуку в Excel формат Параметри:
• поле - поле для пошуку
• запит - що шукати
Приклади:

/пошук-експортовано поле:найменування запит:iPhone
/пошук-експортовано поле:контрагент запит:Apple

---

⚙️ Адміністративні команди

/статистика - Статистика бота

Опис: Показує статистику використання бота Приклад:

/статистика

/очистити-кеш - Очищення кешу

Опис: Очищає кеш користувача Параметри:
• тип - тип кешу для очищення (пошук, ai, всі)
Приклади:

/очистити-кеш тип:пошук
/очистити-кеш тип:ai
/очистити-кеш тип:всі

/допомога - Довідка

Опис: Показує довідку по командам Параметри:
• категорія - категорія команд (basic, search, ai, files, admin)
Приклади:

/допомога
/допомога категорія:search
/допомога категорія:ai
/допомога категорія:files

---

🎯 Приклади використання

Сценарій 1: Аналіз залишків

1. /залишки - подивитися загальну картину
2. /розумний-пошук кількість_вище:100 - знайти товари з великими залишками
3. /ai запит:проаналізуй залишки та дай рекомендації
4. /пошук-експортовано поле:найменування запит:iPhone - експортувати результати

Сценарій 2: Робота з документами

1. /файли дія:пошук запит:звіт - знайти звіти
2. /файли дія:читати запит:звіт_2024.pdf - прочитати звіт
3. /файли дія:аналіз запит:звіт_2024.pdf тип:summary - AI-аналіз
4. /файли дія:звіт запит:звіт_2024.pdf формат:pdf - створити звіт

Сценарій 3: Аналіз продажів

1. /ai запит:знайди товари з найвищими продажами
2. /ai запит:проаналізуй тренди продажів за останній місяць
3. /ai запит:створіть звіт по продажах з рекомендаціями
4. /статистика - подивитися статистику використання

---

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

Змінні середовища

Основні змінні для налаштування:

env
Discord
DISCORD_TOKEN=your_bot_token
DISCORD_CLIENT_ID=your_client_id
DISCORD_GUILD_ID=your_guild_id
Google
GOOGLE_SPREADSHEET_ID=your_spreadsheet_id
GOOGLE_DRIVE_FOLDER_ID=your_drive_folder_id
GOOGLE_APPLICATION_CREDENTIALS=./google-credentials.json
AI
AI_PROVIDER=openai
OPENAI_API_KEY=your_openai_key

Ролі та права доступу

• Адміністратор - повний доступ
• Бот-Користувач - базові команди
• Sheets-Доступ - робота з Google Sheets
• AI-Доступ - AI-функції
• Експорт-Доступ - експорт даних
---

🚨 Безпека

Rate Limiting

Бот має вбудовану систему обмеження запитів:
• Пошук: 10 запитів за хвилину
• AI-аналіз: 5 запитів за 2 хвилини
• Експорт: 3 запити за 5 хвилин

Валідація вхідних даних

• Всі вхідні дані автоматично очищаються
• Обмеження довжини запитів
• Захист від XSS атак

Логування

Всі дії користувачів логуються для безпеки:
• Команди
• Доступ до файлів
• AI-запити
• Помилки

---

🆘 Troubleshooting

Поширені проблеми

Бот не відповідає: 1. Перевірте, чи бот онлайн 2. Перевірте права доступу 3. Перевірте логи на помилки Помилки з Google API: 1. Перевірте налаштування Google 2. Перевірте права доступу до файлів 3. Перевірте квоти API AI не працює: 1. Перевірте налаштування OpenAI/Ollama 2. Перевірте баланс API ключа 3. Перевірте підключення до інтернету

Команди для діагностики

/статистика - перевірити стан бота
/допомога - отримати довідку

---

📞 Підтримка

Якщо у вас виникли проблеми: 1. Перевірте цей гід 2. Подивіться логи бота 3. Спробуйте команду /допомога 4. Зверніться до адміністратора ---

🔄 Оновлення

Для оновлення бота: 1. Зупиніть бота 2. Оновіть код 3. Встановіть нові залежності: npm install 4. Запустіть бота: npm start --- Останнє оновлення: Версія 2.3.0