註
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
Important
本文中標示為(預覽)的功能或特性目前處於公開預覽狀態,並受 Microsoft Azure 預覽版補充使用條款的約束。
如需瞭解 Foundry IQ(Azure AI 搜尋服務)特定的預覽版條款,請參閱預覽功能。
Foundry IQ(Azure AI 搜尋服務)內建的 AI 強化技能包括每日每個索引最多可處理 20 筆交易的免費許可。 檢查每項技能的需求,並在需要時將可計費的 Microsoft Foundry 資源連結至您的技能集。
Foundry 資源提供 Foundry 工具內多項服務的存取。 當你在技能集中指定時,Microsoft 能夠收取你使用以下服務的費用:
- Foundry Tools 中的 Azure Vision用於影像分析、光學字元辨識(OCR)及多模態嵌入。
- Foundry Tools 中的 Azure 語言用於語言偵測、實體辨識、情感分析及關鍵片語擷取。
- Azure 翻譯工具 in Foundry Tools 用於機器文字翻譯。
技能的處理會計入每項技能的基礎服務。 Foundry IQ 將 Foundry Tools 的收費整合到單一的 Foundry 資源中。 例如,如果你使用 影像分析 和 語言偵測技能,Azure視覺與Azure語言的費用會在同一張帳單上顯示你的 Foundry 資源。 其他所有資源則獨立計費。
若要附上 Foundry 資源,請在技能集中提供連結資訊。 你可以使用基於密鑰或無密鑰的方式。
先決條件
除非您的 Foundry IQ 服務符合建立日期、層級及區域對 Foundry 資源私 有連線 的要求,否則只能透過公開端點進行連線。
具有 API 種類的
AIServices。 你可以在 Azure 入口網站的Overview頁面上查看資源的 API 類型:
註
如果您的 Foundry 資源設定為使用私有端點,Foundry IQ 可 透過共用私有連結進行連線。 欲了解更多資訊,請參閱 共享私有連結資源限制。 或者,將 Foundry IQ 服務與 Foundry 資源置於同一 網路安全邊界,以讓對 Foundry 資源的對外呼叫透過私人通道傳送。
從 2025-11-01-preview 開始,技能集支援
AIServicesAPI 種類。 先前的CognitiveServices與經典 Azure AI 多服務帳戶仍可使用,但對於新技能組,我們建議使用AIServices與 Foundry 資源。
透過無鑰匙連接進行收費
你可以使用管理身份和權限來附加 Foundry 資源。 這種方式的優點是計費是無密鑰的,且沒有區域限制。
透過無鑰匙連接計費:
在您的 Foundry IQ 服務上,設定受控識別。 同時支援系統指派與使用者指派的身份。
在您的 Foundry 資源上,將 Cognitive Services 使用者角色指派給您的 Foundry IQ 服務的管理識別碼。
設定一個技能組來使用受管理身份。 你可以使用 Azure 入口網站、最新穩定版的 Skillsets - Create Or Update(REST API),或是提供語法的 Azure SDK 套件。
@odata.type永遠都是#Microsoft.Azure.Search.AIServicesByIdentity。subdomainUrl是您 Foundry 資源的端點。 你可以使用https://<resource-name>.services.ai.azure.com或https://<resource-name>.cognitiveservices.azure.com格式,這兩者都可以在 Azure 入口網站的 Keys 和 Endpoint 頁面取得。其他屬性則是特定於受管理身份類型,如以下 REST API 範例所示。
這裡有一個系統指派的托管身份技能設定範例。 在這種情況下,你必須設定
identity為null。POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-10-01 api-key: [admin-key] Content-Type: application/json { "name": "my-skillset", "skills": [ // Skills definition goes here ], "cognitiveServices": { "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity", "description": "A sample configuration for a system-assigned managed identity.", "subdomainUrl": "https://[resource-name].services.ai.azure.com", "identity": null } }
透過資源金鑰計費
預設情況下,Foundry IQ 會對使用 Foundry 資源金鑰進行交易收費。 這種方法普遍可行。 你可以使用 Azure 入口網站、穩定的 REST API 版本,或等效的 Azure SDK 來新增技能組的金鑰。
支援兩種金鑰類型:
-
#Microsoft.Azure.Search.CognitiveServicesByKey呼叫區域端點。 -
#Microsoft.Azure.Search.AIServicesByKey呼叫子網域。 我們推薦此類型,因為它支援共享私有連結,且相較於 Foundry IQ 服務沒有區域性要求。
您的 Foundry 資源必須與您的 Foundry IQ 服務位於同一區域。 選擇 提供 Foundry Tools 整合的 Foundry IQ 區域,其是否提供此整合會由 AI 擴充 欄指出。 欲了解更多關於同區域要求的資訊,請參閱 「如何使用金鑰」。
如果您未指定 cognitiveServices 屬性,您的 Foundry IQ 服務會嘗試使用索引器每日可用的免費豐富功能。 可計費技能會在每個索引子引動過程達到 20 筆交易時停止執行,並在索引子執行歷程記錄中顯示「逾時」訊息。
登入 Azure 入口網站。
在與您的 Foundry IQ 服務相同區域建立一個 Foundry 資源。
從左側窗格選擇 資源管理>鍵與端點。
複製其中一把鑰匙。
將關鍵要素加入技能組定義中。
如果你正在使用 匯入資料 精靈,請選擇 Foundry 資源。 巫師會把資源鑰匙加入你的技能組定義中。
對於新技能或現有技能,請提供技能組定義中的關鍵。
註
入口會自動附加類型為 #Microsoft.Azure.Search.CognitiveServicesByKey 的鑰匙。
把鑰匙拿出來
擴充是可計費作業。 如果您不再需要呼叫 Foundry Tools,請依照以下指示移除金鑰並避免使用 Foundry 資源。
如果沒有金鑰,技能會還原為每個索引子每天 20 筆免費交易的預設配置。 可計費技能會在達到 20 筆交易時停止執行,用完配置時,會在索引子執行歷程記錄中顯示「逾時」訊息。
前往 Azure 入口網站中的 Foundry IQ 服務。
在 搜尋管理 > 技能組中,從列表中選擇一項技能組。
捲動到檔案中的該
"cognitiveServices"區塊。刪除 JSON 中的鍵值。
儲存技能。
鑰匙的使用方式
對於有免費津貼的技能,當 Foundry 資源的 API 呼叫超過 20 次時,帳單就會開始。 你可以 重置索引器 來重置 API 數量。
對於在 Foundry IQ 內部配置資源上執行豐富化操作的技能,無金鑰與基於金鑰的連接連接至附加的 Foundry 資源負責計費,而非豐富處理。 Azure 內容理解技能使用附帶的 Foundry 資源進行處理與計費。 檢視其支援的區域以及與 Foundry 資源連線的需求。
對於僅以金鑰計費的連線,Foundry IQ 服務會透過內部網路連接到位於同一物理區域內的 Foundry 資源。 大多數提供 Foundry IQ 的區域也提供其他 Azure 服務。 如果你在沒有同時提供這兩種服務的區域嘗試 AI 豐富化,你會看到這則訊息:「提供的金鑰不是您 Foundry IQ 服務所在區域的有效 CognitiveServices 類型金鑰。」
對於無金鑰連線,Foundry IQ 服務會使用其身分與角色指派進行驗證,並以 Foundry 資源為目標。 該資源被指定為完全合格的 URI,且該 URI 包含唯一的子網域。
您可以將索引器設定為在 私有執行環境中 執行,以進行專用處理,僅使用您自己的 Foundry IQ 服務中的搜尋節點。 此設定不會讓所有技能處理都在您的搜尋節點上執行。 部分技能使用 Foundry IQ 內部配置的資源,而 Azure 內容理解、Azure OpenAI 嵌入及 GenAI 提示詞等技能則呼叫客戶配置的資源或模型端點。
註
部分內建技能,如 文字翻譯技能,則是基於非區域性的 Foundry 工具服務。 如果您使用的是非區域技能,您的請求可能會在與 Foundry IQ 區域不同的區域處理。 欲了解更多非區域服務資訊,請參閱產品 區域供應 頁面。
公共連接要求
根據您的 Foundry IQ 服務建立時間、價格層級及地區不同,為 內建技能 計費可能需要 Foundry IQ 與您的 Foundry 資源進行公開連線。 在某些情況下,關閉公共網路存取會破壞計費。 請檢視 透過共用私有連結進行連線 的需求,以判斷您的 Foundry IQ 服務是否需要公開連線。
如果你無法使用公共網路,你可以設定一個
關鍵需求,特殊情況
自訂實體查詢 由 Foundry IQ 計量,但若要解鎖每日超過 20 筆的交易,需要 Foundry 資源金鑰。 針對此技能,資源金鑰僅解鎖交易數量,而與計費無關。
免費增益功能
AI 擴充可讓您免費處理少量計費的擴充,讓您毋須附加外部資源即可完成簡短的練習。 免費增益是每位索引者每天 20 份文件。 如果你想重複練習,可以 重置索引器 來重置計數器。
有些豐富內容總是免費的:
從 PDF 文件及其他應用程式檔案擷取文字不會產生費用。 文字擷取發生在 文件破解期間,並非 AI 豐富化,但它在 AI 豐富過程中發生,因此在此處特別說明。
可計費擴充
在 AI 強化過程中,Foundry IQ 會呼叫基於 Azure Vision、Azure Language 與 Azure 翻譯工具 的內建技能 API。
可計費的內建技能,用於向外部服務進行後端通話,包括:
由 Azure Vision 多模態嵌入模型支持的 查詢時間向量化器 也是一種收費的增強功能。
影像擷取是 Foundry IQ 的一項操作,當文件在豐富化前被解析時發生。 影像擷取在所有計價方案中都會收費,只有在免費方案中每天可免費提取 20 次。 影像擷取費用適用於 blob 內的影像檔案、其他檔案中嵌入的影像(PDF 及其他應用程式檔案),以及使用 文件擷取擷取的影像。 有關影像擷取定價,請參閱 Foundry IQ 定價頁面。
提示
為降低技能集處理成本,啟用 增量豐富(預覽) 以快取並重用未受技能組變更影響的豐富內容。 快取需要 Azure 儲存體 (請參閱定價),但如果可以重複使用現有擴充,技能集執行的累計成本會較低,尤其是使用影像擷取和分析的技能集。
範例:估算成本
本節所示價格為假設性,用以說明估算過程。 您的成本可能較低。 關於實際交易價格,請參見 Foundry Tools 定價。
要估算 Foundry IQ 索引相關的成本,先從一份平均文件長什麼樣子開始,這樣你才能做一些數字運算。 例如,你可以大致描述:
- 1,000 份 PDF
- 每頁六頁
- 每頁一張圖片(6,000 張圖片)
- 每頁3,000字元
假設一條流程包含每份 PDF 的文件破解、圖片與文字擷取、圖片的 OCR,以及組織的實體識別。
對於文字和圖片內容的破解文件,目前文字擷取是免費的。 對於 6,000 張影像,假設每擷取 1,000 張影像需支付 1 美元。 這一步總共花費6美元。
對於6,000張英文影像的OCR,OCR認知技能使用最佳演算法(DescribeText)。 假設每分析 1,000 個影像的費用為美金 $2.50 元,則在此步驟中您需支付美金 $15.00 元。
當進行實體擷取時,每頁會有總共三筆文字記錄。 每條紀錄有1,000個字元。 每頁三筆文字記錄乘以 6,000 頁,等於 18,000 筆文字記錄。 假設每 1,000 筆文字記錄需支付 2.00 美元,此步驟成本為 36.00 美元。
綜合來看,根據上述技能,你要花大約 $57.00 才能匯入 1,000 份這類 PDF 文件。