metadata

title: Jira Ai Assistant
emoji: 📚
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 5.19.0
app_file: app.py
pinned: false

Jira AI Assistant

Додаток на основі Gradio для аналізу даних Jira з використанням AI.

Опис

Jira AI Assistant - це інструмент для аналізу даних Jira, який дозволяє:

Завантажувати дані з CSV-файлів або напряму через Jira API
Генерувати статистику та візуалізації
Аналізувати дані за допомогою AI (OpenAI, Google Gemini)
Створювати звіти у різних форматах (Markdown, HTML, PDF)
Відправляти повідомлення у Slack

Встановлення

Клонуйте репозиторій:

git clone https://github.com/your-username/jira-ai-assistant.git
cd jira-ai-assistant

Встановіть залежності:

pip install -r requirements.txt

Створіть файл .env у корені проекту та додайте необхідні змінні середовища:

JIRA_URL=https://your-company.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-api-token

OPENAI_API_KEY=your-openai-api-key
GEMINI_API_KEY=your-gemini-api-key

SLACK_BOT_TOKEN=your-slack-bot-token

Використання

Запуск додатку

python app.py

Додаток буде доступний за адресою: http://127.0.0.1:7860

Отримання даних

Існує два способи отримання даних для аналізу:

Завантаження CSV-файлу: На вкладці "CSV Аналіз" завантажте CSV-файл з експортованими даними Jira.
Використання Jira API: На вкладці "Jira API" введіть URL Jira сервера, ім'я користувача та API токен, потім вкажіть ключ проекту та опціонально ID дошки.

Аналіз даних

Після завантаження даних:

Налаштуйте параметри аналізу (кількість днів неактивності тощо).
За бажанням, додайте AI аналіз, вказавши API ключ OpenAI або Google Gemini.
Натисніть кнопку "Аналізувати" для виконання аналізу.

Збереження звіту

Після аналізу ви можете зберегти результати:

Виберіть формат звіту (Markdown, HTML, PDF).
За бажанням, додайте візуалізації у звіт.
Натисніть кнопку "Зберегти звіт" для збереження результатів.

Розширені можливості

Інтеграція з Slack

Ви можете надсилати звіти у Slack:

На вкладці "Інтеграції" введіть назву каналу та текст повідомлення.
Виберіть звіт для прикріплення (опціонально).
Натисніть кнопку "Надіслати у Slack" для відправлення повідомлення.

AI Асистенти

На вкладці "AI Асистенти" ви можете:

Задавати питання щодо завантажених даних Jira.
Отримувати відповіді та рекомендації від AI.
Використовувати AI агентів для різних задач.

Структура проекту

jira-ai-assistant/
├── app.py                  # Головний файл додатку
├── config.py               # Конфігурація додатку
├── requirements.txt        # Залежності
├── README.md               # Цей файл
├── assets/                 # Статичні ресурси
├── data/                   # Директорія для зберігання даних
├── reports/                # Директорія для зберігання звітів
├── temp/                   # Тимчасові файли
├── logs/                   # Логи додатку
└── modules/                # Модулі додатку
    ├── core/               # Ядро додатку
    ├── data_import/        # Модуль імпорту даних
    ├── data_analysis/      # Модуль аналізу даних
    ├── ai_analysis/        # Модуль AI аналізу
    ├── reporting/          # Модуль звітування
    ├── integrations/       # Модуль інтеграцій
    └── rag/                # Модуль RAG

Отримання API ключів

Jira API Token

Увійдіть в Atlassian Account
Натисніть "Create API token"
Дайте назву API токену та скопіюйте його

OpenAI API Key

Увійдіть в OpenAI Dashboard
Натисніть "Create new secret key"
Скопіюйте створений ключ

Google Gemini API Key

Перейдіть на Google AI Studio
Створіть новий API ключ
Скопіюйте створений ключ

Slack Bot Token

Перейдіть на Slack API
Створіть новий додаток
Додайте OAuth scopes: chat:write, files:write
Встановіть додаток у ваш робочий простір
Скопіюйте Bot User OAuth Token

Внесення змін

Якщо ви хочете розширити функціонал додатку, ви можете:

Додати новий модуль у директорію modules/
Оновити головний файл app.py для включення нового функціоналу
Оновити файл requirements.txt, якщо потрібні нові залежності

Ліцензія

Цей проект поширюється під ліцензією MIT.