在 GitHub Copilot CLI 中安裝 Foundry IQ(Azure AI 搜尋服務)技能

在 GitHub Copilot CLI 中使用 Foundry IQ 技能,查詢現有的 Foundry IQ(Azure AI 搜尋服務)知識庫並建立知識圖譜。 在本文中,你安裝外foundry-iq-skills掛並運用其foundry-iq技能搭配您的 Azure 資源。

在 Foundry IQ Skills 中找到公開的外掛來源。

Important

GitHub Copilot CLI 的 Foundry IQ 技能整合目前處於公開預覽階段,並受 Microsoft Azure 預覽版補充使用條款的約束。

有關此功能專屬的預覽條款,請參閱 預覽功能。

Prerequisites

  • 新增外掛市集需要 Git。
  • GitHub Copilot CLI 在 Windows 或 Linux 上。
  • Python 3.12 或更新版本,外掛的輔助指令碼需要。
  • 現有的知識庫,以及其 Azure 訂閱與資源的存取權。
  • Azure CLI 已安裝並登入,用此外掛查詢現有的知識庫。 使用已驗證的 Azure 身份,並對所請求的讀取或變更擁有權限。 關於查詢存取需求,請參閱 知識庫擷取先決條件。
  • 除了查詢存取權限外,還可檢視知識庫與知識來源定義。 Reader 角色可以檢視物件定義。 請參閱 內建角色。

安裝外掛

請在 GitHub Copilot CLI 中執行斜線指令,而非在作業系統的 shell 中。

  1. 新增市集。

    /plugin marketplace add microsoft/azure-skills
    
  2. 安裝外掛程式。

    /plugin install foundry-iq-skills@azure-skills
    

若要更新已安裝的外掛程式,請在 Copilot CLI 中執行此指令:

/plugin update foundry-iq-skills@azure-skills

查詢現有知識庫

這項技能從只讀檢查開始。 識別現有資源,以將探索範圍限制在這些資源內。 選擇資源並不等於同意去改變它們。

  1. 在 Copilot CLI 中,識別您現有的 Foundry IQ 服務與知識庫。 問:「查詢這個知識庫並附上引文。」

  2. 如果技能詢問是否使用現有服務、尋找相容服務或建立服務,請選擇 「使用現有項目」。 提供它所要求的現有資源詳細資訊。

  3. 就知識庫中的內容提出問題。

  4. 檢視檢索出來的答案及其引用,確認是否包含知識庫中的相關內容。

檢視變更與清理邊界

查詢現有知識庫是讀取操作,不需要寫入核准。 其他任務可能會變更 Azure 資源。

在核准變更前,請先檢視技能所顯示的計畫。 建立服務、知識來源或知識庫、將知識庫連接至代理程式,或進行其他計畫中的資源變更,都需要核准。 核准僅適用於未變更的計畫;如果計畫改變,技能會再次詢問。

將清理工作視為獨立的規劃工作流程。 允許刪除由工作流程建立的資源需要另外的核准。 不要把建立和清理核准合併在一起。

辨識支援的工作流程

除了擷取之外,這項技能還支援本地檔案與 Azure Blob 儲存體 或 Azure Data Lake Storage 的知識來源、知識庫建立與檢索驗證、現有代理程式連線、診斷及清理規劃。 關於來源概念,請參閱 「知識來源概覽」。

此技能支援將現有的多來源知識庫與現有代理人連結,且不需更改知識庫。

Troubleshooting

如果市集註冊、安裝或更新指令回報錯誤,請勿繼續執行知識庫程序。 確認你正在 GitHub Copilot CLI 中執行 slash 指令,且 Git 可用。 如需安裝指引,請參閱 Foundry IQ 外掛安裝說明。