Note
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
配置您的新 Foundry IQ(Azure AI 搜尋服務)服務涉及多項工作,以優化安全性、存取權與效能。 本文提供一份第一天的檢查清單,幫助您在Azure入口網站中設定服務。
建立 Foundry IQ 服務後,我們建議您:
設定基於角色的存取
入口網站的存取是根據 角色分配來決定的。 預設情況下,新的 Foundry IQ 服務至少有一位服務管理員或擁有者。 服務管理員、共同管理員及擁有者有權建立更多管理員並指派其他角色。 他們也能存取所有入口網站頁面及預設 Foundry IQ 服務的操作。
提示
預設情況下,任何管理員或擁有者都可以建立或刪除服務。 為避免意外刪除,建議 鎖定你的資源。
每個 Foundry IQ 服務都附帶 API 金鑰 ,並預設採用基於金鑰的驗證。 不過,我們建議使用 Microsoft Entra ID 和基於角色的存取控制(RBAC)以提升安全性。 RBAC 消除了以明文儲存與傳遞 API 金鑰的需求。
當你從基於金鑰的認證切換到無金鑰認證時,服務管理員必須為自己指派資料平面角色,才能完全存取物件和資料。 這些職務包括搜尋服務貢獻者、搜尋索引資料貢獻者及搜尋索引資料閱讀員。
要配置基於角色的存取:
在您的 Foundry IQ 服務上啟用角色。 我們建議同時使用 API 金鑰和角色。
指派資料平面角色 ,以取代停用 API 金鑰時所失去的功能。 擁有者只需要搜尋索引資料閱讀器,但開發者需要 更多角色。
角色分配可能需要幾分鐘才能生效。 在此之前,用於資料平面操作的入口頁面會顯示以下訊息:
為解決方案開發人員和應用程式指派更多角色。
設定一個受管理身份
如果您計劃使用索引器進行自動索引、應用 AI 或整合向量化,應 將您的 Foundry IQ 服務設定為使用受管理身份。 接著,您可以在其他 Azure 服務上指派角色,以授權您的 Foundry IQ 服務存取資料與執行作業。
為了整合向量化,您的 Foundry IQ 服務識別碼需要具備以下角色:
- Azure 儲存體上的儲存體 Blob 資料讀者
- 微軟 Foundry 資源上的認知服務數據使用者
角色分配可能需要幾分鐘才能生效。
在你進入網路安全領域之前,建議先測試所有連線點以驗證角色分配。 執行 匯入精靈 來測試權限。
設定網路安全
預設情況下,Foundry IQ 服務會透過公共網際網路連線接受經過驗證且授權的請求。 你有兩種提升網路安全的選項:
若要了解 Foundry IQ 中的入站與出站呼叫,請參閱 「了解網路流量模式」。
檢查容量並了解帳單
預設情況下,Foundry IQ 服務會建立一個複本和一個分割區。 你可以透過新增複本和分割區 來增加容量 ,但我們建議等到磁碟區需要時再使用。 許多客戶會以最低配置執行生產工作負載。
語意排名器和代理檢索是免費方案預設的高級功能。 如果你需要付費使用,超出免費津貼的部分,請參見啟用或停用語意排名計費及啟用或停用代理檢索計費。
若要了解影響計費的其他功能,請參閱「 規劃與管理 Foundry IQ 服務的成本」。
啟用診斷日誌
啟用診斷記錄 以追蹤使用者活動。 跳過這個步驟,你仍然會自動獲得 活動日誌 和 平台指標 。 不過,如果你想要索引和查詢使用資訊,應該啟用診斷日誌並選擇記錄操作的目的地。 我們推薦 Log Analytics Workspace 作為耐用儲存,讓你能在 Azure 入口網站執行系統查詢。
在內部,Microsoft 會收集關於你服務和平台的遙測資料。 欲了解更多資料保留,請參閱 「指標保留」。
欲了解更多資料位置與隱私資訊,請參閱資料駐留。
向開發者提供連結資訊
要連接 Foundry IQ,開發人員需要:
- 從 概覽 頁面取一個端點或網址。
- 來自金鑰頁面的 API 金鑰或角色指派。 我們推薦搜尋服務貢獻者、搜尋索引資料貢獻者及搜尋索引資料閱讀器。
我們建議使用入口存取匯入資料精靈程序和搜尋探勘器。 您必須是 Contributor 或更高角色,才能執行精靈。
相關內容
關於服務管理的程式化支援,請參見以下 API 與模組:
你也可以使用Azure SDK中的管理客戶端函式庫,支援.NET、Python、Java和JavaScript。
除了預覽管理功能外,所有模式和語言的功能都相當。 一般來說,預覽管理功能會先透過管理 REST API 釋出。