共用方式為

Graph 連接器Microsoft Azure DevOps 工作專案

  • 發行項

Graph 連接器Microsoft Azure DevOps 工作專案可讓您的組織在其 Azure DevOps 服務實例中為工作專案編製索引。 設定連接器之後，終端使用者可以在 [搜尋] 和 [Microsoft Microsoft 365 Copilot] 中，從 Azure DevOps 搜尋工作專案。

本文適用於Microsoft 365 位系統管理員或設定、執行及監視 Azure DevOps 工作專案Microsoft圖形連接器的任何人。

重要事項

Graph 連接器Microsoft Azure DevOps 工作專案僅支援 Azure DevOps 雲端服務。 此連接器不支援 Azure DevOps Server 2019、TFS 2018、TFS 2017、TFS 2015 和 TFS 2013。

功能

  • 從 Azure DevOps 編製工作專案的索引
  • 讓終端使用者詢問與工作專案相關的問題。
  • 在 Copilot 中使用語意搜尋 ，讓用戶能夠根據關鍵詞、個人喜好設定和社交連線來尋找相關內容。

限制

  • 連接器只會為每個連線編制一個 ADO 組織的索引。

必要條件

  • 您必須是組織Microsoft 365 租使用者的 搜尋管理員 。

  • 若要允許連接器連線到您的 Azure DevOps 組織，您必須透過 OAuth 啟用第三方應用程式存取。 若要深入瞭解，請參閱 Azure DevOps 檔以 管理安全策略 。

    顯示透過 OAuth 存取第三方應用程式的螢幕快照。

  • 服務帳戶：若要連線到 Azure DevOps 並允許 Microsoft Graph 連接器定期更新工作專案，您需要一個具有下列許可權的服務帳戶。

    許可權名稱 許可權類型 的必要專案
    檢視專案層級資訊 項目許可權 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。
    檢視分析 項目許可權 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。
    檢視此節點中的工作專案 區域路徑 在區域路徑中編目工作專案。 此許可權是 選擇性的。 只有那些區域路徑會針對用戶帳戶具有許可權進行編目。

    重要事項

    服務帳戶必須具有 基本 存取層級。 若要深入瞭解 Azure DevOps 中的存取層級，請閱讀 支援的存取層級。

開始使用

顯示適用於 Azure DevOps 工作專案的 Graph 連接器Microsoft連線建立畫面的螢幕快照。

1.顯示名稱

顯示名稱可用來識別 Copilot 中的每個引文，協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也代表受信任的內容。 顯示名稱也會當做 內容來源篩選條件使用。 此欄位有預設值，但您可以將它自定義為組織中用戶可辨識的名稱。

2. ADO 組織

Azure DevOps 連接器允許針對每個連線編製一個組織的索引。 若要連線到您的 Azure DevOps 服務，請提供要編製索引的組織名稱。

3.驗證類型

若要從 Azure DevOps 驗證和同步處理工作專案，請選擇 兩個支援的方法之一 ：

重要事項

a. Microsoft Entra ID OAuth

確定您的 ADO 組織已連線到 Microsoft Entra

Azure DevOps Graph 連接器只會為與租使用者 Microsoft Entra 連線的 ADO 組織內容編制索引。 若要確保您的 ADO 組織與 Microsoft Entra 帳戶連線，請使用下列步驟。

  1. 流覽至 [Azure DevOps] ，然後選取所需的組織。
  2. 選取 Organization settings。
  3. 在左側瀏覽窗格中，選取 Microsoft Entra [一般] 標頭下方。
  4. 確定組織已連線到租使用者的 Microsoft Entra 帳戶。

在 Microsoft Entra ID 上建立應用程式

  1. 移至 Azure 入口網站，並使用租用戶的系統管理員認證登入。
  2. 從瀏覽窗格流覽至 [Microsoft Entra ID ->Manage ->應用程式註冊]，然後選取 [新增註冊]。
  3. 提供應用程式的名稱，然後選取 [ 註冊]。
  4. 記下應用程式 (用戶端) 識別碼。 此標識碼可用來將 Microsoft Entra 應用程式存取權授與 ADO 組織中的專案。
  5. 從瀏覽窗格開啟 API 許可權，然後選取 [ 新增許可權]。
  6. 選 取 [Azure DevOps] ，然後選取 [ 委派的許可權]。
  7. 搜尋下列許可權，然後選取 [新增許可權]。
    a. 身分識別 (讀取)
    b. 讀取) (工作專案
    c. 可變 群組 (讀取)
    d. 專案和小組 (讀取)
    e. 圖表 (讀取)
    f. 分析 (讀取)
  8. 選 取 [TenantName] 的 [授與系統管理員同意] ，然後選取 [ 是] 來確認。
  9. 檢查許可權是否處於「已授與」狀態。
  10. 從瀏覽窗格開啟 [驗證 ]。 選取 Add a platform 並選擇 Web。 在 [重新導向 URI] 下新增下列其中一個 URI：
    • 針對 M365 Enterprise：https:// gcs.office。com/v1.0/admin/oauth/callback
    • 針對 M365 Government：https:// gcsgcc.office。com/v1.0/admin/oauth/callback
  11. 在 [隱含授與和混合式流程] 下，核取 的選項 ID tokens (used for implicit and hybrid flows) ，然後按兩下 [ 設定]。
  12. 從瀏覽窗格中，選取 [管理] 底下的 [憑證和秘密]。
  13. 選 取 [新增客戶端密碼 ]，然後選取秘密的到期期間。 複製產生的秘密 (值) 並儲存它，因為它不會再次顯示。
  14. 使用此客戶端密碼和應用程式識別碼來設定連接器。

將 Microsoft Entra 應用程式存取權授與 ADO 組織中的專案

您必須使用下列步驟，為 Microsoft Entra 應用程式提供需要編製索引之專案的必要存取權：

  1. 流覽至 [Azure DevOps] ，然後選取所需的組織。
  2. 選取 Organization settings。
  3. 在左側瀏覽窗格中，選取 Users [一般] 標頭下方。
  4. 選取 Add users。
  5. 將從應用程式取得的應用程式 (用戶端) 識別碼複製到「用戶或服務主體」。
  6. 授與存 Basic 取層級，然後選取專案以允許存取索引。 同時將 新增至 Project Reader Azure DevOps 群組 (或對等) ，以確保存取權。 取消選取將電子郵件邀請傳送給用戶的選項。

b. Azure DevOps OAuth

若要連線到您的 Azure DevOps 實例，您需要 Azure DevOps 組織 名稱、其應用程式識別碼，以及 OAuth 驗證的客戶端密碼。

註冊應用程式

在 Azure DevOps 中註冊應用程式，讓Microsoft搜尋應用程式和 Microsoft 365 Copilot 可以存取實例。 若要深入瞭解，請參閱 Azure DevOps 檔，以瞭解如何 註冊應用程式。

下表提供如何填寫應用程式註冊窗體的指引：

必要欄位 描述 建議值
公司名稱 您的公司名稱。 使用適當的值
應用程式名稱 識別您正在授權之應用程式的唯一值。 Microsoft 搜尋
應用程式網站 在連接器設定期間要求存取 Azure DevOps 實例的應用程式 URL。 (必要) 。 針對 M365 Enterprise：https:// gcs.office。com/，
For M365 Government： https:// gcsgcc.office.com/
授權回呼 URL 授權伺服器重新導向的必要回呼 URL。 針對 M365 Enterprise：https:// gcs.office。com/v1.0/admin/oauth/callback，
適用於 M365 Government：https:// gcsgcc.office。com/v1.0/admin/oauth/callback
授權的範圍 應用程式的存取範圍 選取下列範圍：身分識別 (讀取) 、工作專案 (讀取) 、變數 群組 (讀取) 、專案和小組 (讀取) 、Graph (讀取) 、分析 (讀取)

重要事項

您為應用程式選取的授權範圍應該與上面所列的範圍完全相符。 如果您省略清單中的其中一個授權範圍或新增另一個範圍，授權將會失敗。

註冊應用程式時，您會取得用來設定連接器的 應用程式識別 碼和 客戶端密碼 。

注意事項

若要撤銷在 Azure DevOps 中註冊之任何應用程式的存取權，請移至 Azure DevOps 實例右上方的 [用戶設定]。 選 取 [配置檔 ]，然後在側邊窗格的 [安全性] 區段中選取 [ 授權 ]。 將滑鼠停留在授權的 OAuth 應用程式上，以查看應用程式詳細數據角落的 [ 撤銷 ] 按鈕。

4.向有限的物件推出

如果您想要先在 Copilot 和其他搜尋介面中驗證此連線，再將推出擴充至更廣泛的物件，請將此連線部署至有限的使用者基底。 若要深入瞭解有限的推出，請參閱 分段推出。

此時，您已準備好建立 Azure DevOps 工作項目的連線。 您可以按兩下 [建立] ，從 Azure DevOps 組織發佈連線並編制工作專案的索引。

對於其他設定，例如 訪問許可權、 數據包含規則、 架構、 編目頻率等，我們會根據最適合 ADO 資料的設定來設定預設值。 您可以在下方看到預設值：

使用者 描述
訪問許可權 只有具有數據源中內容存取權的人員。
對應身分識別 使用 Microsoft Entra標識碼對應的數據源身分識別。
內容 描述
專案 所有項目都會編製索引。
管理屬性 若要檢查預設屬性及其架構，請參閱 內容
同步處理 描述
累加編目 頻率：每 15 分鐘
完整編目 頻率：每天

如果您要編輯其中任何一個值，您必須選擇 「自訂安裝程式」

自訂安裝程式

自訂設定適用於想要編輯上表所列設定之預設值的系統管理員。 按兩下 [自定義安裝] 選項之後，您會看到另外三個索引標籤 - [使用者]、[內容] 和 [同步]。

使用者

顯示 [使用者] 索引標籤的螢幕快照，您可以在其中設定訪問許可權。

訪問許可權

Azure DevOps 工作專案連接器支援 「所有人 」或 「僅限具有此數據源存取權的人員」可看見的搜尋許可權。 如果您選擇 [ 所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員]，則已編製索引的數據會出現在具有此數據源存取權之使用者的搜尋結果中。

注意事項

匯報 管理訪問許可權的群組只會以完整編目同步處理。 累加編目不支援處理許可權的更新。

內容

顯示 [內容] 索引標籤的螢幕快照，您可以在其中設定項目和連線架構。

選擇專案

在此步驟中，您會使用 Azure DevOps 工作專案Microsoft Graph 連接器，指定要編制索引的數據範圍。 然後，您可以選擇連線來為整個組織或所選組織內的特定項目編製索引。

如果您選擇為整個組織編製索引，則會編製組織中所有專案的工作專案索引。 新專案和工作專案會在建立之後的下一個編目期間編製索引。

如果您選擇為個別項目編製索引，則只會編製所選專案中的工作專案索引。

注意事項

在授與 檢視專案層級資訊 和 檢視分析 許可權之後，可以編目 Azure DevOps 專案。

管理屬性

在這裡，您可以從 Azure DevOps 數據源新增或移除可用的屬性、將架構指派給屬性， (定義屬性是可搜尋、可查詢、可擷取或可精簡的) 、變更語意標籤，並將別名新增至 屬性。 以下列出預設選取的屬性。

Source 屬性 標籤 描述 Schema
AreaPath 工作項目的區域路徑 查詢、擷取、搜尋
AssignedTo 工作專案指派給的人員名稱 查詢、擷取、搜尋
Authors Authors 取回
ChangedBy 上次修改者 上次修改工作項目的人員名稱 查詢、擷取
ChangedDate 上次修改日期時間 查詢、擷取
CreatedBy 建立者 建立工作項目的人員名稱 查詢、擷取、搜尋
CreatedDate 建立日期時間 建立工作項目時的時間戳 查詢、擷取
描述 內容 工作專案的描述 搜尋
IconUrl IconUrl 取回
識別碼 工作項目識別碼 查詢、擷取、搜尋
優先順序 工作專案的優先順序 查詢、擷取
ReproSteps 重現工作專案中所述條件的步驟
狀態 工作專案的目前狀態 查詢、擷取、搜尋
標記 查詢、擷取、搜尋
TeamProject 取回
標題 標題 工作項目的標題 擷取、搜尋
URL URL 工作專案的 URL 取回
WorkItemType 查詢、擷取、搜尋

預覽數據

使用 [預覽結果] 按鈕來驗證所選屬性的範例值。

同步處理

顯示 [同步] 索引標籤的螢幕快照，您可以在其中設定編目頻率。

重新整理間隔會決定數據源與 Graph 連接器索引之間同步處理資料的頻率。 重新整理間隔有兩種類型 ： 完整編目和累加編目。 如需詳細資訊，請參閱 重新整理設定。

您可以視需要從這裏變更重新整理間隔的預設值。

提示

默認結果類型

  • Azure DevOps 工作專案Microsoft圖形連接器會在連接器發佈后自動註冊 結果類型 。 結果類型會根據步驟 3 中選取的欄位，使用動態產生 的結果配置 。
  • 您可以瀏覽至 Microsoft 365 系統管理中心 中的結果類型來管理結果類型。 默認結果類型命名為 「ConnectionIdDefault」。 例如，如果您的聯機標識符是 AzureDevOps，則結果配置會命名為：“AzureDevOpsDefault”
  • 此外，您可以視需要選擇建立自己的結果類型。

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。 您可以 在這裡找到常見問題的疑難解答步驟。

如果您有問題或想要提供意見反應，請 連絡 Microsoft Graph |支援。