jira ticket classification

Classificação de tickets Jira

Visão geral

Jira Ticket Classification é um sistema automatizado projetado para classificar tickets Jira usando os recursos de IA do Amazon Bedrock. Este projeto pode ser usado com exportações do Jira Server, fornecendo recursos de automação semelhantes aos disponíveis no Jira Cloud.

Diagrama de Arquitetura

Características

• Classifica automaticamente os tickets do Jira com base no conteúdo
• Utiliza Amazon Bedrock para classificação baseada em IA
• Processa exportações de tickets do Jira colocadas no S3
• Usa AWS Glue para desduplicação de dados
• Projetado para funcionar com exportações do Jira Server

Observação : a desduplicação é importante se você permitir que os usuários carreguem manualmente as exportações do Jira e também executem o pull automático. Se você puder garantir que nenhuma importação incremental contenha duplicatas, poderá remover o trabalho do AWS Glue.

Como funciona

1. Entrada de dados : as exportações de tickets do Jira são colocadas na pasta /unprocessed do bucket S3 implantado.

2. Processamento de dados : O sistema processa os tickets exportados.

3. Classificação Bedrock : os dados do ticket são enviados para o Amazon Bedrock, que usa um prompt de classificação predefinido para categorizar cada ticket.

4. Desduplicação : o AWS Glue garante que nenhuma classificação duplicada seja processada, mantendo a integridade dos dados.

5. Resultados : os resultados da classificação são armazenados e podem ser usados ​​para atualizar os tickets originais do Jira ou para análises adicionais.

Componentes

• Função Lambda : Lida com a lógica principal para processamento e classificação de tickets.
• Amazon Bedrock : fornece o modelo de IA para classificação de tickets.
• AWS Glue : gerencia a desduplicação de dados.
• S3 : Armazena as exportações do Jira e os resultados da classificação.
• Gerenciador de segredos : armazena nossa chave de API do Jira, URL base e endereço de e-mail para extrair tickets do Jira.

Instalação e configuração

Aviso importante : este projeto implanta recursos em seu ambiente AWS usando Terraform. Você incorrerá em custos pelos recursos da AWS usados. Esteja ciente dos preços de serviços como Lambda, Bedrock, Glue e S3 em sua região AWS.

Permissões necessárias : você precisa de permissões elevadas, especificamente permissões de usuário avançado, para implantar a pilha do Terraform.

Para configurar o projeto:

1. Atualize a variável de ambiente PROJECT_IDS_COMMA_SEPARATED de main.tf fetch_jira_issue_lambda para incluir os projectIds que você deseja extrair
2. Navegue até a pasta infrastructure no projeto.
3. Execute terraform init para inicializar o diretório de trabalho do Terraform.
4. Execute terraform apply para criar os recursos em seu ambiente AWS.
5. Vá para o gerenciador de segredos e atualize o segredo do Jira com a configuração do Jira

Para desmontar o projeto:

1. Navegue até a pasta infrastructure .
2. Execute terraform destroy para remover todos os recursos criados por este projeto.

Segurança

Certifique-se de executar o tfsec na pasta de infra-estrutura sempre que fizer uma alteração adicional no código.

Execute o TFSec

$ tfsec .

Avisos suprimidos Certifique-se de executar o tfsec na pasta de infraestrutura sempre que fizer uma alteração adicional no código. Esses avisos de segurança foram suprimidos, mas revise-os antes de colocar a implementação desta solução em produção. Além disso, este repositório de amostra usa chaves gerenciadas pela AWS. É incentivado a utilização de chaves geridas pelo cliente (CMKs) num ambiente de produção.

1. Secrets Manager "aws-ssm-secret-use-customer-key": Este aviso exige que usemos uma chave KMS para nosso segredo.
2. S3 "aws-s3-enable-bucket-logging": remova e ative se o registro do bucket fizer sentido para seu caso de uso
3. Criptografia de bucket S3 "aws_s3_bucket_server_side_encryption_configuration": estamos usando uma chave de criptografia gerenciada pela AWS
4. Lambda "aws-lambda-enable-tracing": ative o rastreamento se isso fizer sentido para o seu projeto.

Uso

1. Exporte tickets da sua instância do Jira Server.
2. Coloque os dados do ticket exportados na pasta /unprocessed do bucket S3 criado pelo script Terraform.
3. O sistema processará automaticamente novos arquivos nesta pasta.
4. Recupere os resultados da classificação do local de saída designado no S3.

Requisitos

• Conta AWS com acesso a Lambda, Bedrock, Glue e S3
• Terraform instalado em sua máquina local
• Permissões de usuário avançado em sua conta AWS
• Capacidade de exportar tickets do Jira Server (instância do Jira Server não é necessária)

Contribuindo

Contribuições para melhorar o projeto são bem-vindas. Sinta-se à vontade para enviar solicitações pull ou problemas em aberto para discutir possíveis melhorias.

Licença

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Apoiar

Para suporte ou para relatar problemas, abra um problema no repositório GitHub do projeto.