共用方式為

GitHub Microsoft Graph 連接器 (預覽)

  • 發行項

GitHub Graph 連接器可讓您從 GitHub 存放庫為內容編製索引，使其可在Microsoft 365 生態系統中輕鬆搜尋。 此連接器適用於使用 GitHub 進行檔、專案檔或內容管理的組織。 藉由整合 GitHub 數據與Microsoft搜尋，使用者可以直接存取Microsoft 365 應用程式內的相關內容、簡化工作流程，並減少在平臺之間切換的需求。

本文適用於Microsoft 365 位系統管理員或設定、執行及監視 GitHub Graph 連接器的任何人。

注意事項

GitHub Graph 連接器處於預覽狀態。 如果您想要搶先存取以試用，請使用 此窗體註冊。

功能

  • 為 GitHub 存放庫和 Markdown 檔案編制索引，讓項目檔可在 Microsoft 365 中存取。
  • 讓使用者在 Copilot 中詢問與專案文件和技術指南相關的問題。
    • 如何? 設定 Alpha 專案？
    • 哪裡可以找到部署指示？
    • 此項目的架構概觀為何？
    • 摘要說明項目檔中的重要章節以供快速參考
  • 在 Copilot 中使用語意搜尋 ，讓用戶能夠根據關鍵詞、個人喜好設定和社交連線來尋找相關內容。

限制

  • 只會編製存放庫元數據和 Markdown 檔案的索引。 問題、提取要求和批注等其他 GitHub 實體不會編製索引。
  • 僅支援大小上限為 1 MB 的 Markdown 檔案。 大型檔案不會編製索引。

必要條件

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

  • 您必須擁有作用中的 GitHub 帳戶，您可以在其中存取您想要編制索引的所有存放庫。

    a. 針對個人存放庫，您必須是下列其中一個：

    • 存放庫擁有者
    • 存放庫共同作業者

    b. 對於組織擁有的存放庫，您必須是下列其中一個：

    • 外部共同作業者
    • 作為直接共同作業者的組織成員
    • 可透過小組成員資格存取的組織成員
    • 具有透過預設組織許可權存取權的組織成員
    • 組織擁有者。

  • 您必須擁有 PAT) (個人存取令牌。 若要深入瞭解個人存取令牌，請 參閱管理您的個人存取令牌 - GitHub Docs。

  • 您的個人存取令牌必須能夠存取您想要編製索引的所有存放庫，而且必須獲得下列許可權。

    針對傳統令牌：

    類別 權限 註解
    回購 全部 完全控制私人存放庫
    使用者 read：user 讀取所有使用者配置檔數據
    使用者 read：email 存取唯讀) (用戶電子郵件位址

    針對更細緻的令牌：

    類別 權限 許可權等級
    存放庫許可權 內容 唯讀
    存放庫許可權 中繼資料 唯讀
    帳戶許可權 電子郵件地址 唯讀

  • 如果您有組織擁有的存放庫，請遵循下列額外步驟：

開始使用

顯示 Microsoft Graph Connector for GitHub 連線建立畫面的螢幕快照。

1.顯示名稱

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

2.驗證類型

若要從 GitHub 驗證和同步處理內容：

  1. 驗證類型
    選擇 [基本] 選項

  2. PAT) (個人存取令牌

顯示 GitHub PAT 畫面的螢幕快照。

使用您的個人存取令牌來取代密碼。 可用來編製索引的存放庫取決於令牌所授與的存取權。

自訂安裝程式

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

使用者

訪問許可權

GitHub 連接器支援 可供具有 此數據源存取權的所有人看見的搜尋許可權。 針對 [所有人]，索引數據會出現在所有使用者的搜尋結果中。 如需身分識別轉換，請參閱對應您的非 Azure AD 身分識別 |Microsoft Learn。

內容

選擇存放庫和文件類型 (一開始 markdown 檔案和其他非程式代碼檔) 您想要讓搜尋。

管理屬性

顯示適用於 GitHub 的 Graph 連接器Microsoft管理屬性畫面的螢幕快照。

在這裡，您可以從 GitHub 數據源新增或移除可用的屬性、將架構指派給屬性， (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 、變更語意卷標，以及將別名新增至 屬性。

同步處理

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

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

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

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。

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