共用方式為

Bitbucket Pull Request Microsoft 365 Copilot connector (preview)

Bitbucket Pull Request Microsoft 365 Copilot連接器允許您的組織索引 Pull Request 與文件，以及儲存在 Bitbucket 中的 (.txt 和 .md 檔案) 。 在設定 Bitbucket 內容的連接器與索引後，使用者可以透過 Microsoft Search 和 Microsoft 365 Copilot 搜尋並檢索資訊。

本文針對 Microsoft 365 管理員或任何設定、執行或監控 Bitbucket Copilot 連接器的人。

功能

  • 索引 Bitbucket 資料庫、拉取請求與文件。
  • 啟用 Microsoft Search 與 Microsoft 365 Copilot，以有效取得 Bitbucket 資料。
  • 維護 Bitbucket ACL 與使用者權限。
  • 允許管理員自訂爬取頻率與索引偏好。

限制

  • 該連接器不支援對 Bitbucket CI/CD 管線進行除狀態索引以外的功能。
  • 只有資料庫、拉取請求、.md 和 .txt 檔案會被索引。
  • 目前不支援本地/自架的 Bitbucket 實例。
  • 當 Git 變更未映射到 Bitbucket 帳號時，連接器可能會將 LastModifiedBy 欄位留空。 當手動設定將 Git 變更連結到 Bitbucket 使用者帳號時，未完成在增量爬取前。

必要條件

  1. 你的 Bitbucket 實例是透過 API 存取的。
  2. 用於認證的使用者帳號可存取待索引的倉庫、拉取請求和知識檔案。
  3. 存取索引 Bitbucket 資料的使用者會擁有對應的 Microsoft Entra ID 身份，以便權限映射。
  4. 在 Bitbucket 上設置一個 OAuth 消費者
    1. 請前往 Bitbucket 上的工作區頁面。
    2. 點擊右上角的齒輪圖示，選擇 工作區設定。
    3. 在左側導覽中，選擇位於工作流程區塊下的 OAuth 消費者。
    4. 點擊 新增消費者 ，並依照以下重定向網址填寫：
    • 對於 Microsoft 365 企業版，請使用https://gcs.office.com/v1.0/admin/oauth/callback
    • 對於 Microsoft 365 政府，請使用 https://gcsgcc.office.com/v1.0/admin/oauth/callback
    1. 啟用金鑰以設定以下讀取問題的權限：
    • 帳戶
    • 資料庫
    • 拉取請求
    1. 儲存設定並複製金鑰和秘密值

我們建議每個連線使用不同的使用者帳號來進行 OAuth 認證，因為 Bitbucket 的速率限制是逐個使用者計算的。

快速入門

選擇顯示名稱

選擇一個顯示名稱，幫助使用者辨識 Copilot 回應中的合併請求或文件。

Bitbucket 實例網址

輸入你的 Bitbucket 實例網址，例如 (https://bitbucket.org/testinstance) 。

驗證類型

  1. 用 Bitbucket OAuth 消費者的金鑰輸入你的客戶 ID，並用對應的 OAuth 消費者秘密輸入你的客戶密鑰。
  2. 選擇 授權 登入並授權存取。
  3. 點擊 授權 登入並授予所需的存取權限。

推廣至有限族群

在部署連接器前，先用有限的使用者在 Copilot 和 Microsoft Search 測試連線。

自訂設定

在自訂設定中，你可以編輯使用者、內容和同步的任何預設值。

使用者

恆等映射

預設情況下，由於 Bitbucket API 的限制，連接器會使用 Bitbucket 的公開名稱來映射 Microsoft Entra ID 中的電子郵件。 如果這個映射與你的設定不符，請自訂身份映射。

為確保權限強制執行正確，請將 Bitbucket 使用者身份映射至 Microsoft Entra ID。 選項如下︰

  • 全名：將 Bitbucket 全名與 Microsoft Entra ID 使用者屬性匹配。
  • 公開名稱：用 Microsoft Entra ID 使用者屬性映射 Bitbucket 公共名稱。

若直接映射失敗，則使用 正則表達式 (正則表達式) 進行轉換。 例如：

  1. 選擇郵件作為 Microsoft Entra 使用者屬性。
  2. 選擇全名作為非 Microsoft Entra 使用者屬性。
  3. 使用正則表達 ([^@]+) 式，例如捕捉符號前 @ 一個或多個字元的序列。
  4. 建立一個公式來完成映射，例如 {0}@<your-domain>。

內容

在 內容 標籤中，你可以驗證範例資料中的屬性映射，涵蓋 內容、 標籤、 描述和 時間戳記等元資料。

同步處理

你可以設定 增量 爬行和 全 爬行。 以下是預設值：

  • 增量爬行預設 每 15 分鐘 執行一次。
  • 完整爬行 每日 執行以確保索引更新。

後續步驟

  • 請在 Microsoft 365 系統管理中心檢視連線狀態。

如果你有問題或想提供回饋，請聯絡 Microsoft Graph 客服。

  • Last updated on