jira ticket classification

Классификация билетов Jira

Обзор

Классификация билетов Jira — это автоматизированная система, предназначенная для классификации билетов Jira с использованием возможностей искусственного интеллекта Amazon Bedrock. Этот проект можно использовать с экспортом Jira Server, предоставляя возможности автоматизации, аналогичные тем, которые доступны в Jira Cloud.

Схема архитектуры

Функции

• Автоматически классифицирует заявки Jira на основе их содержания.
• Использует Amazon Bedrock для классификации на основе искусственного интеллекта
• Обрабатывает экспорт билетов Jira, помещенный в S3.
• Использует AWS Glue для дедупликации данных
• Предназначен для работы с экспортом Jira Server.

Примечание . Дедупликация важна, если вы разрешаете пользователям вручную загружать экспортированные файлы Jira, а также запускать автоматическое получение. Если вы можете гарантировать, что добавочный импорт не содержит дубликатов, вы можете удалить задание AWS Glue.

Как это работает

1. Ввод данных : экспорт билетов Jira помещается в папку /unprocessed развернутой корзины S3.

2. Обработка данных : система обрабатывает экспортированные билеты.

3. Классификация Bedrock : данные о билетах отправляются в Amazon Bedrock, который использует заранее заданную подсказку классификации для категоризации каждого билета.

4. Дедупликация : AWS Glue гарантирует отсутствие дублирующихся классификаций, сохраняя целостность данных.

5. Результаты : результаты классификации сохраняются и могут использоваться для обновления исходных заявок Jira или для дальнейшего анализа.

Компоненты

• Лямбда-функция : обрабатывает основную логику обработки и классификации билетов.
• Amazon Bedrock : предоставляет модель искусственного интеллекта для классификации билетов.
• AWS Glue : управляет дедупликацией данных.
• S3 : сохраняет результаты экспорта и классификации Jira.
• Менеджер секретов : хранит наш ключ API Jira, базовый URL-адрес и адрес электронной почты для получения билетов Jira.

Настройка и конфигурация

Важное примечание . Этот проект развертывает ресурсы в вашей среде AWS с помощью Terraform. Вы понесете расходы за используемые ресурсы AWS. Обратите внимание на цены на такие сервисы, как Lambda, Bedrock, Glue и S3, в вашем регионе AWS.

Требуемые разрешения : для развертывания стека Terraform вам потребуются повышенные разрешения, в частности разрешения опытного пользователя.

Чтобы настроить проект:

1. Обновите переменную среды main.tf fetch_jira_issue_lambda PROJECT_IDS_COMMA_SEPARATED, включив в нее идентификаторы проектов, которые вы хотите получить.
2. Перейдите в папку infrastructure в проекте.
3. Запустите terraform init , чтобы инициализировать рабочий каталог Terraform.
4. Запустите terraform apply , чтобы создать ресурсы в вашей среде AWS.
5. Перейдите в диспетчер секретов и обновите секрет Jira с помощью вашей конфигурации Jira.

Чтобы снести проект:

1. Перейдите в папку infrastructure .
2. Запустите terraform destroy , чтобы удалить все ресурсы, созданные этим проектом.

Безопасность

Обязательно запускайте tfsec для папки инфраструктуры каждый раз, когда вносите дополнительные изменения в код.

Запустите TFSec

$ tfsec .

Подавленные предупреждения Обязательно запускайте tfsec для папки инфраструктуры каждый раз, когда вы вносите дополнительные изменения в код. Эти предупреждения безопасности были скрыты, но просмотрите их перед внедрением этого решения в производство. Кроме того, в этом образце репозитория используются управляемые ключи AWS. В рабочей среде рекомендуется использовать ключи, управляемые клиентом (CMK).

1. Менеджер секретов «aws-ssm-secret-use-customer-key»: это предупреждение требует от нас использования ключа KMS для нашего секрета.
2. S3 «aws-s3-enable-bucket-logging»: удалите и включите, если ведение журнала сегментов имеет смысл для вашего варианта использования.
3. Шифрование сегмента S3 «aws_s3_bucket_server_side_encryption_configuration»: мы используем ключ шифрования, управляемый AWS.
4. Lambda «aws-lambda-enable-tracing»: включите трассировку, если это имеет смысл для вашего проекта.

Использование

1. Экспортируйте билеты из вашего экземпляра Jira Server.
2. Поместите экспортированные данные заявки в папку /unprocessed корзины S3, созданной скриптом Terraform.
3. Система автоматически будет обрабатывать новые файлы в этой папке.
4. Получите результаты классификации из назначенного выходного места в S3.

Требования

• Учетная запись AWS с доступом к Lambda, Bedrock, Glue и S3.
• Terraform установлен на вашем локальном компьютере
• Разрешения опытного пользователя в вашей учетной записи AWS
• Возможность экспорта заявок с Jira Server (экземпляр Jira Server не требуется)

Содействие

Вклад в улучшение проекта приветствуется. Пожалуйста, не стесняйтесь отправлять запросы на включение или открывать вопросы для обсуждения потенциальных улучшений.

Лицензия

Этот проект лицензируется по лицензии MIT. Подробности смотрите в файле ЛИЦЕНЗИИ.

Поддерживать

Чтобы получить поддержку или сообщить о проблемах, откройте проблему в репозитории проекта на GitHub.