技能 Azure.Search.Documents (.NET)
📦

Azure.Search.Documents (.NET)

安全

使用 .NET 建置 Azure AI Search 應用程式

開發者需要將強大的搜尋功能整合到 .NET 應用程式中，但面臨 Azure Search SDK 的複雜性。此技能提供使用 Azure.Search.Documents 套件實作全文、向量、語意和混合搜尋的程式碼範例和最佳實務。

支援: Claude Codex Code(CC)
🥉 73 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「Azure.Search.Documents (.NET)」。 如何將文件上傳到 Azure Search 索引？

預期結果:

對新文件使用 SearchClient.UploadDocumentsAsync()，對更新使用 MergeDocumentsAsync()，或對 upsert 操作使用 MergeOrUploadDocumentsAsync()。建立 IndexDocumentsBatch 以進行多項操作。

正在使用「Azure.Search.Documents (.NET)」。 有哪些可用的身份驗證選項？

預期結果:

DefaultAzureCredential（推薦用於生產環境）使用受控識別、服務主體或 VS 憑證。AzureKeyCredential 可用但不推薦用於生產環境，因為有金鑰管理的顧慮。

安全審計

安全
v1 • 2/25/2026

This is a documentation-only skill containing SKILL.md with code examples. No executable code is present. Static analysis found 0 files scanned, 0 potential security issues, and a risk score of 0/100. The skill provides informational content about Azure Search SDK usage without any network, filesystem, or command execution capabilities.

0
已掃描檔案
0
分析行數
0
發現項
1
審計總數
未發現安全問題
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
100
安全
83
規範符合性

你能建構什麼

全文搜尋實作

使用 SearchClient 和 SearchOptions 為 .NET 應用程式新增關鍵字搜尋功能，包含篩選、排序、分面和分頁。

向量搜尋整合

使用嵌入和 VectorizedQuery API 在 .NET 應用程式中實作語意向量搜尋，實現 AI 驅動的相關性。

混合搜尋應用程式

結合全文、向量和語意搜尋，在 .NET 應用程式中實現最大相關性。

試試這些提示

基本搜尋設定 
展示如何在 .NET 應用程式中使用 DefaultAzureCredential 設定 SearchClient，並使用 Azure.Search.Documents 執行帶有篩選器的基本搜尋查詢。
建立搜尋索引 
產生程式碼以使用 FieldBuilder 和模型屬性為 Hotel 類別建立搜尋索引，包含 key、filterable、sortable 和 searchable 欄位（使用 C#）。
向量搜尋查詢 
編寫 C# 程式碼以使用 VectorizedQuery 和 HNSW 演算法設定執行向量搜尋，並回傳結果及其相似度分數。
帶答案的語意搜尋 
展示如何設定帶有 QueryCaption 和 QueryAnswer 的語意搜尋，以從 Azure AI Search 獲取提取的答案和高亮標題。

最佳實務

  • 在生產環境中使用 DefaultAzureCredential 而非 API 金鑰，以利用受控識別
  • 對型別安全的索引定義和自動結構描述產生，使用帶有模型屬性的 FieldBuilder
  • 使用 IndexDocumentsBatch 批次化文件操作以獲得更好的吞吐量並減少 API 呼叫

避免

  • 在生產程式碼中使用 API 金鑰而非帶有受控識別的 DefaultAzureCredential
  • 當只需要特定欄位時使用 Select 載入所有欄位
  • 未處理 RequestFailedException 以進行適當的錯誤處理和除錯

常見問題

SearchClient、SearchIndexClient 和 SearchIndexerClient 之間有什麼區別？
SearchClient 用於查詢索引和文件的 CRUD 操作。SearchIndexClient 建立和管理索引及同義詞對應。SearchIndexerClient 管理索引器、技能集和資料來源。
如何在開發和生產環境中處理身份驗證？
使用 DefaultAzureCredential，它會自動選擇最佳的身份驗證方法。在開發環境中，它使用 Visual Studio 憑證。在生產環境的 Azure 上，它使用受控識別。
我可以使用此技能建立 Azure Search 服務嗎？
不，此技能提供 SDK 的程式碼範例。您需要透過 Azure Portal、CLI 或 ARM 模板另外建立 Azure AI Search 服務。
什麼是混合搜尋？
混合搜尋結合關鍵字搜尋、向量搜尋和語意排名，以提供最相關的結果。它使用倒數排名融合（Reciprocal Rank Fusion）來結合不同搜尋方法的結果。
如何為索引新增向量搜尋？
新增帶有 VectorSearchField 屬性的欄位，使用 HnswAlgorithmConfiguration 設定 VectorSearchProfile，並使用 VectorizedQuery 以嵌入進行搜尋。
v11 和早期版本之間的主要區別是什麼？
版本 11 引入了改進的異步模式、使用 RequestFailedException 的更好錯誤處理，以及更新的欄位建構器語法。早期版本使用不同的用戶端初始化模式。

開發者詳情

作者

sickn33

授權

MIT

儲存庫

https://github.com/sickn33/antigravity-awesome_skills/tree/main/skills/azure-search-documents-dotnet

引用

main

檔案結構

📄 SKILL.md