Atlassian Jira Cloud Microsoft 365 Copilot 連接器讓您的組織能夠索引 Jira 問題。 在你設定 Jira 網站的連接器和索引內容後，使用者可以在 Microsoft Search 和 Microsoft 365 Copilot 體驗中搜尋這些項目。
本文說明部署與客製化 Atlassian Jira Cloud 連接器的步驟。
重要事項
Atlassian Jira Cloud Copilot 連接器僅支援 Jira 雲端託管的實例。 此連接器不支援 Jira Server 和 Jira Data Center 版本。
關於 Jira Cloud 服務的設定資訊，請參見 設定 Jira Cloud 服務以擷取連接器。
必要條件
在部署 Atlassian Jira Cloud 連接器之前，請確保您的組織已設定 Jira Cloud 環境。 下表總結了配置 Jira Cloud 環境及部署連接器的步驟。
| 工作 | 角色 |
|---|---|
| 建立 Jira Cloud 服務 | Jira Cloud 管理員 |
| 在 Microsoft 365 系統管理中心部署連接器 | Microsoft 365 系統管理員 |
| 自訂連接器設定 (可選) | Microsoft 365 系統管理員 |
在部署連接器前，請確保你符合以下先決條件：
- 您必須是貴組織 Microsoft 365 租戶的 搜尋管理員 。
- 務必知道你組織的 Jira Cloud 實例網址。 要連接你的 Jira 資料，你需要你組織的 Jira 實例網址。
- 要連接 Jira 並讓 Atlassian Jira Cloud Copilot 連接器定期更新問題，你需要一個服務帳號並獲得以下權限。
| 許可名稱 | 權限類型 | 所需條件 |
|---|---|---|
| 瀏覽專案 | 專案許可 | 爬行的 Jira 問題。 此許可是需要索引的專案 所需 。 |
| 發行層級安全權限 | 議題層級安全 | 爬行不同類型的問題。 此權限為 可選。 |
| 瀏覽使用者與群組 | 通用權限 | 根據搜尋結果的存取權限進行安全調整。 若選擇 「僅限有權限存取此資料來源 的使用者」設定，則需使用此權限;否則，這是可選的。 |
| 管理吉拉 | 通用權限 | 根據搜尋結果的存取權限進行安全調整。 若選擇 「僅限有權限存取此資料來源 的使用者」設定，則需使用此權限;否則，這是可選的。 |
展開連接器
要為您的組織新增 Atlassian Jira Cloud 連接器：
- 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
- 到「 連接器 」分頁，在左側窗格選擇 「圖庫」。
- 從可用連接器列表中，選擇 Atlassian Jira Cloud。
集合顯示名稱
顯示名稱用於識別 Copilot 回應中的參考，幫助使用者辨識相關檔案或項目。 顯示名稱同時代表受信任的內容，並用作內容來源過濾器。
你可以接受預設的 Atlassian Jira Cloud 顯示名稱，或自訂該值，使用使用者熟悉的顯示名稱。
欲了解更多關於連接器顯示名稱與描述的資訊，請參閱「以 Microsoft 365 Copilot 連接器內容強化 Copilot 發現」。
設定實例網址
要連接您的 Jira 雲端資料，您需要您組織的 Jira 實例 URL。 貴組織的 Jira 實例網址通常如下： https://<your-organization-domain>.atlassian.net。
如果你還沒有實例，請參考 Atlassian Jira 建立測試實例。
選擇認證類型
要驗證並同步來自 Jira 的問題，請選擇以下支援的認證方法之一：
基本認證 - 輸入帳號使用者名稱 (通常是電子郵件 ID) 和 API 令牌，然後用基本驗證來驗證。關於如何產生 API 代幣的資訊，請參閱 「管理您的 Atlassian 帳戶的 API 代幣」。
Atlassian Jira OAuth 2.0 (推薦) - 使用 Jira OAuth 進行認證：
- 在 Atlassian Jira 註冊一個應用程式，讓 Microsoft Search 應用程式和 Microsoft 365 Copilot 能夠存取該實例。 欲了解更多資訊，請參閱 啟用 OAuth 2.0。
- 請用你的 Atlassian Jira 管理員帳號登入 Atlassian 開發者主控台 。
- 選擇 建立 並選擇 OAuth 2.0 整合。
- 為應用程式提供適當的名稱並建立新的應用程式。
- 從左側的導覽窗格進入 權限 。 選擇 Jira API新增，然後選擇配置。 在 細緻權限下，新增所需的範圍。
- 從左側導覽面板進入 授權 頁面，加入回撥網址：
- 針對 Microsoft 365 企業版：
https://gcs.office.com/v1.0/admin/oauth/callback - 針對 Microsoft 365 政府：
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- 針對 Microsoft 365 企業版：
- 選擇 [儲存]。
- 到左側窗格的 設定 裡取得客戶端 ID 和秘密資料。 請使用 用戶端 ID 和 秘密完成連線設定步驟。
注意事項
- 欲了解更多 Jira 權限資訊，請參閱 OAuth 2.0 的 Jira 範圍。
- Jira Cloud 原本的 (經典) OAuth 權限已被棄用。 更多資訊請參閱 變更日誌公告。
推出
若要推送至有限受眾，請選擇「 推展」 旁的「有限受眾」切換，並指定要推送連接器的使用者與群組。 欲了解更多資訊，請參閱 Microsoft 365 Copilot 連接器的分階段部署。
選擇 建立 來部署連線。 Atlassian Jira Cloud Copilot 連接器會立即開始索引內容。
以下是連接器的預設值：
使用者
- 存取權限：只有擁有資料來源內容存取權的人。
- 地圖識別碼：使用 Microsoft Entra ID 映射的資料來源識別碼。
內容
- 網站專案：所有專案均有索引。
- 篩選資料：所有議題均有索引。 不使用時間濾波器或 JQL 標準。
- 管理屬性：要檢查預設屬性及其結構，請參見 「自訂內容設定」
同步處理
- 增量爬行：頻率：每15分鐘一次
- 完整爬行： 頻率：每天
建立連線後，您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。
自訂設定 (可選)
你可以自訂 Atlassian Jira Cloud 連接器設定的預設值。 要自訂設定，在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
存取權限
Atlassian Jira Cloud Copilot 連接器支援搜尋權限，對所有或只有擁有此資料來源存取權的人可見。 如果你選擇 「所有人」，索引資料會出現在所有使用者的搜尋結果中。 如果你選擇 「僅限有權限存取此資料來源的人」，索引資料會出現在有權限存取資料的使用者搜尋結果中。 在 Atlassian Jira 中，安全權限是透過包含站點層級群組與專案角色的專案權限方案來定義的。 問題層級安全性也可用議題層級權限方案來定義。
重要事項
Atlassian Jira Cloud Copilot 連接器必須能在 Jira 中讀取使用者的電子郵件 ID，以便在 Microsoft Search 和 Microsoft 365 Copilot 中適當分配安全權限。 這需要你確保以下其中一項：
- 所有使用者都應該選擇「 任何人 」選項來設定他們的個人資料可見性。 欲了解更多個人資料可見性設定，請參閱 「更新您的個人資料與可見性設定」。
- 對於使用 管理帳號的組織：
- 所有使用者必須在個人檔案可見性設定中選擇受管理帳號設定。
- 非受管理帳號的使用者 (爬取帳號) 必須在個人資料可見設定中選擇 「任何人 」。
- 連線設定時使用的爬蟲帳號必須是受管理帳號網域。
映射恆等式
將資料來源身份與 Microsoft Entra ID 對應的預設方法是將 Jira 使用者的電子郵件 ID 與 UPN () 的使用者主體名稱或 Microsoft Entra ID 中的使用者電子郵件地址相同。 如果預設的映射對你的組織不適用，你可以提供自訂的映射公式。 更多資訊請參閱「映射你的非 Azure AD 身份」。
- 如果 Jira 使用者的電子郵件 ID 與 Microsoft Entra ID 中用戶的 UPN 相同，請選擇 Microsoft Entra ID 選項。
- 如果 Jira 使用者的電子郵件 ID 與 Entra ID 中的 UPN 及使用者電子郵件不同，請選擇非 Microsoft Entra ID 選項。
注意事項
管理存取權限的群組匯報僅以完整爬取方式同步。 增量爬取不支援權限更新的處理。
自訂內容設定
選擇專案並篩選資料
- 網站專案：你可以選擇連結中索引整個 Jira 網站或僅限特定專案。
- 如果你選擇索引整個 Jira 網站，網站上所有專案的 Jira 議題都會被索引。 新專案和議題會在建立後的下一次爬取時被索引。
- 如果你選擇單一專案，只有選取專案中的 Jira 議題會被索引。
注意事項
當你授權 Browse 專案 權限給 Jira 專案時，該專案會顯示在專案選擇中，並且可以被爬取。 如果專案遺失，請檢查你帳號的權限。
- 篩選資料：你可以選擇以兩種方式篩選 Jira 議題的索引：
- 請指定 修改期限。 此選項僅索引在所選期間內根據當前爬取以 滾動方式 產生或修改的 Jira 發行。
- 使用 JQL 篩選器，僅索引特定 Jira 議題類型，方法是使用
issueType in (Bug, Improvement)。
管理物業
你可以從 Jira 資料來源新增或移除可用屬性，為屬性指派結構， (定義屬性是否可搜尋、查詢、檢索或精煉) ，更改語意標籤，並為屬性加上別名。 下表列出預設選擇的屬性。
| 源頭性質 | 標籤 | 描述 | Schema |
|---|---|---|---|
| Authors | Authors | 請列出所有參與或合作該項目的人 | 挽回 |
| 已建立 | 建立約會時間 | 資料來源中項目建立的日期與時間 | 查詢，取回 |
| 問題描述 | 內容 | 問題描述 | 搜尋 |
| 問題圖示網址 | IconUrl | 代表問題類型的圖示網址 | 挽回 |
| 問題ID | |||
| IssueKey（議題關鍵） | |||
| 問題連結 | URL | 資料來源中項目的目標網址 | 查詢，取回 |
| 問題狀態 | 查詢 | ||
| 議題摘要 | |||
| ProjectName | 查詢 | ||
| 記者電子郵件 ID | 建立者 | 挽回 | |
| 記者姓名 | 查詢，取回 | ||
| 標題 | 標題 | 你想在 Copilot 和其他搜尋體驗中顯示的物品標題 | 搜尋、查詢、檢索 |
| 已更新 | 最後修正日期時間 | 該項目在資料來源中最後修改的日期與時間 | 查詢，取回 |
注意事項
- Atlassian Jira Cloud Copilot 連接器可以索引預設的問題欄位和自訂的問題欄位。
- 如果某個 Jira 議題類型中沒有選定的自訂欄位，該欄位會以 NULL (空) 格式被收錄。
- 你選擇的屬性清單會影響使用者在 Copilot 中篩選、搜尋及查看結果的方式。
預覽資料
使用預覽結果按鈕來驗證所選屬性的樣本值及查詢篩選器。
自訂同步間隔
刷新間隔決定了你的資料在資料來源與 Atlassian Jira Cloud Copilot 連接器索引之間同步的頻率。 以下是兩種類型的刷新間隔：
- 漸進爬行：每15分鐘一次
- 全爬行：每天
你可以更改刷新間隔的預設值。 欲了解更多資訊，請參閱 同步設定指引。