Foundry IQ(Azure AI 搜尋服務)的 C# 範例

Note

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

了解展示 Foundry IQ 解決方案功能與工作流程的 C# 程式碼範例。 這些範例會使用適用於 Azure SDK for .NET 的 Azure AI 搜尋服務用戶端程式庫,您可以透過下列連結進行探索。

標的 連結
套件下載 nuget.org/packages/Azure.Search.Documents/
API 參考資料 Azure.Search.Documents
API 測試案例 github.com/Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/tests
原始程式碼 github.com/Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/src
變更記錄 github.com/Azure/azure-sdk-for-net/blob/main/sdk/search/Azure.Search.Documents/CHANGELOG.md

SDK 範例

Azure SDK 開發小組示範 API 使用方式的程式碼範例。 您可以在 GitHub 上的 Azure/azure-sdk-for-net/blob/main/sdk/search/Azure.Search.Documents/samples 中找到這些範例。

範例 描述
Hello world(同步) 使用同步方法建立用戶端、驗證和處理錯誤。
Hello world(非同步) 使用非同步方法建立用戶端、驗證和處理錯誤。
服務層級操作 取得服務統計資料並建立多個搜尋物件,包括索引、索引器、資料來源、技能集和同義字對應。 最後,您查詢索引。
索引操作 取得儲存在索引中的文件計數。
FieldBuilderIgnore 使用屬性來處理不支援的資料類型。
文件索引(推送模式) 透過將 JSON 承載傳送到索引中,以使用推送模型來為文件編製索引。
客戶管理的加密金鑰 使用客戶管理的加密金鑰來保護敏感內容。
向量搜尋 索引向量欄位並執行向量搜尋。
語意排序 在索引中設定語意排名器,並執行語意查詢。

文件範例

Foundry IQ 團隊的程式碼範例示範了各項功能和工作流程。 下列範例會在教學課程、快速入門和操作說明文章中參考,以詳細說明程式碼。 您可以在 GitHub 上的 Azure-Samples/azure-search-dotnet-samples 和 Azure-Samples/search-dotnet-getting-started 中找到這些範例。

範例 發行項 描述
quickstart-agentic-retrieval 快速入門:代理式檢索 將語義排名與 LLM 驅動的查詢規劃和答案生成整合。
quickstart-keyword-search 快速入門:全文搜尋 使用範例資料建立、載入及查詢索引。
quickstart-semantic-ranking 快速入門:語意排名 將語意排名新增至索引結構描述,並執行語意查詢。
quickstart-vector-search 快速入門:向量搜尋 索引和查詢向量資料。
embedding-model-migration 移轉嵌入模型 驗證基準備份,重新產生所選向量欄位,並還原至新索引。
image-serving-example 在代理擷取中顯示文件內嵌影像(預覽) 執行受控擷取和 A/B 檢索,並可獨立查詢及從 Azure Blob 儲存體下載已建立索引的映像參考。
search-website 教學:為網頁應用程式新增搜尋 建置端對端搜尋應用程式,使用推播 API 進行大量上傳,並使用豐富的用戶端來裝載應用程式和處理搜尋要求。
tutorial-ai-enrichment 教學:從 Azure Blob 產生 AI 生成的可搜尋內容 建立一個技能組,遍歷 Azure Blob 儲存體以提取資訊並推斷結構。
multiple-data-sources 教學:從多個資料來源建立索引 將兩個資料來源的內容合併到一個索引中。
optimize-data-indexing 教學:使用 push API 優化索引 使用最佳化技術將資料推送至索引。
DotNetHowTo 使用 .NET 用戶端函式庫 在瞭解 API 時建立和管理多個搜尋物件。
DotNetToIndexers 教學:索引 Azure SQL 資料 使用排程、欄位對應和參數來設定 Azure SQL 索引子。
DotNetHowToEncryptionUsingCMK 設定客戶管理的金鑰以進行資料加密 建立使用客戶管理金鑰加密的物件。

示範

示範存放庫會為示範中顯示的範例或案例,提供概念證明原始程式碼。 與加速器不同,示範解決方案並非專為適應而設計。

範例 描述
covid19search 基於 Foundry IQ 的 Covid-19 搜尋應用程式的原始碼儲存庫。

其他範例

以下範例同樣由 Foundry IQ 團隊發布,但未在文件中被引用。 相關聯的 README 檔案提供使用指示。

範例 描述
azure-search-classic-rag 單次 RAG 使用經典搜尋引擎,並以來自 Foundry IQ 的資料作為基礎,搭配 Azure OpenAI 的聊天補全模型。
檢查儲存體使用量 使用 Azure 函式排程檢查 Foundry IQ 服務儲存體用量。
export-data 使用 C# 主控台應用程式分割和匯出大型索引。
index-backup-restore 將索引從一個服務複製到另一個服務,建立包含索引結構描述和文件的 JSON 檔案。
data-lake-gen2-acl-indexing 為使用 Microsoft Entra ID 與角色型存取控制保護的 Azure Data Lake Gen2 檔案與資料夾編製索引。
multiple-search-services 查詢多個 Foundry IQ 服務,並將結果合併成單一頁面。
搜尋彙總 從索引中獲取並篩選聚合數據。
Azure-search-power-skills 將可使用的自訂技能納入您自己的解決方案中。
DotNetVectorDemo 建立、載入和查詢向量索引。
DotNetIntegratedVectorizationDemo 擴充向量工作流程,以包含以技能為基礎的資料區塊化和內嵌自動化。

秘訣

使用 範例瀏覽器 在 GitHub 上搜尋 Microsoft 程式碼範例。 您可以按產品、服務和語言過濾搜索。