jira ticket classification

Jira 門票分類

概述

Jira Ticket Classification 是一個自動化系統，旨在使用 Amazon Bedrock 的 AI 功能對 Jira 票據進行分類。此專案可與 Jira Server 匯出一起使用，提供與 Jira Cloud 中提供的自動化功能類似的自動化功能。

架構圖

特徵

• 根據 Jira 票證的內容自動對其進行分類
• 利用 Amazon Bedrock 進行人工智慧驅動的分類
• 處理放置在 S3 的 Jira 票據導出
• 使用 AWS Glue 進行重複資料刪除
• 設計用於與 Jira Server 匯出配合使用

注意：如果您允許使用者手動上傳 Jira 匯出並執行自動拉取，則重複資料刪除非常重要。如果您可以確保增量匯入不包含重複項，則可以刪除 AWS Glue 作業。

它是如何運作的

1. 資料輸入：JIRA 票證匯出放置在已部署的 S3 儲存桶的/unprocessed資料夾中。

2. 資料處理：系統處理匯出的票據。

3. Bedrock 分類：票證資料傳送到 Amazon Bedrock，後者使用預先定義的分類提示對每張票證進行分類。

4. 重複資料刪除：AWS Glue 確保不處理重複的分類，從而保持資料完整性。

5. 結果：分類結果被存儲，可用於更新原始 Jira 票證或用於進一步分析。

成分

• Lambda 函數：處理票證處理和分類的主要邏輯。
• Amazon Bedrock ：提供票證分類的 AI 模型。
• AWS Glue ：管理重複資料刪除。
• S3 ：儲存 Jira 導出和分類結果。
• Secrets Manager ：儲存我們的 Jira API 金鑰、基本 URL 和用於提取 Jira 票證的電子郵件地址。

設定和配置

重要通知：此專案使用 Terraform 在您的 AWS 環境中部署資源。您將因使用的 AWS 資源而產生費用。請注意您的 AWS 區域中 Lambda、Bedrock、Glue 和 S3 等服務的定價。

所需權限：您需要提升權限，特別是進階使用者權限，才能部署 Terraform 堆疊。

設定項目：

1. 更新 main.tf fetch_jira_issue_lambda 的環境變數 PROJECT_IDS_COMMA_SEPARATED 以包含要拉取的 projectId
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. Secrets Manager「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. 將匯出的票證資料放置在 Terraform 腳本建立的 S3 儲存桶的/unprocessed資料夾中。
3. 系統會自動處理該資料夾中的新檔案。
4. 從 S3 中指定的輸出位置檢索分類結果。

要求

• 有權限存取 Lambda、Bedrock、Glue 和 S3 的 AWS 帳戶
• Terraform 安裝在您的本機電腦上
• 您的 AWS 帳戶中的進階使用者權限
• 能夠從 Jira Server 匯出票證（不需要 Jira Server 執行個體）

貢獻

歡迎為改進該項目做出貢獻。請隨時提交拉取請求或開放問題來討論潛在的增強功能。

執照

該項目已獲得 MIT 許可證的許可。有關詳細信息，請參閱許可證文件。

支援

如需支援或報告問題，請在專案的 GitHub 儲存庫中開啟問題。