在 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 中。
新增市集。
/plugin marketplace add microsoft/azure-skills安裝外掛程式。
/plugin install foundry-iq-skills@azure-skills
若要更新已安裝的外掛程式,請在 Copilot CLI 中執行此指令:
/plugin update foundry-iq-skills@azure-skills
查詢現有知識庫
這項技能從只讀檢查開始。 識別現有資源,以將探索範圍限制在這些資源內。 選擇資源並不等於同意去改變它們。
在 Copilot CLI 中,識別您現有的 Foundry IQ 服務與知識庫。 問:「查詢這個知識庫並附上引文。」
如果技能詢問是否使用現有服務、尋找相容服務或建立服務,請選擇 「使用現有項目」。 提供它所要求的現有資源詳細資訊。
就知識庫中的內容提出問題。
檢視檢索出來的答案及其引用,確認是否包含知識庫中的相關內容。
檢視變更與清理邊界
查詢現有知識庫是讀取操作,不需要寫入核准。 其他任務可能會變更 Azure 資源。
在核准變更前,請先檢視技能所顯示的計畫。 建立服務、知識來源或知識庫、將知識庫連接至代理程式,或進行其他計畫中的資源變更,都需要核准。 核准僅適用於未變更的計畫;如果計畫改變,技能會再次詢問。
將清理工作視為獨立的規劃工作流程。 允許刪除由工作流程建立的資源需要另外的核准。 不要把建立和清理核准合併在一起。
辨識支援的工作流程
除了擷取之外,這項技能還支援本地檔案與 Azure Blob 儲存體 或 Azure Data Lake Storage 的知識來源、知識庫建立與檢索驗證、現有代理程式連線、診斷及清理規劃。 關於來源概念,請參閱 「知識來源概覽」。
此技能支援將現有的多來源知識庫與現有代理人連結,且不需更改知識庫。
Troubleshooting
如果市集註冊、安裝或更新指令回報錯誤,請勿繼續執行知識庫程序。 確認你正在 GitHub Copilot CLI 中執行 slash 指令,且 Git 可用。 如需安裝指引,請參閱 Foundry IQ 外掛安裝說明。