Agent skill · software engineering · aiskillstore
azure-search-documents-dotnet
Azure AI Search SDK for .NET (Azure.Search.Documents). Use for building search applications with full-text, vector, semantic, and hybrid search. Covers SearchClient (queries, document CRUD), SearchIndexClient (index management), and SearchIndexerClient (indexers, skillsets). Triggers: "Azure Search .NET", "SearchClient", "SearchIndexClient", "vector search C#", "semantic search .NET", "hybrid search", "Azure.Search.Documents".
Why this skill is useful
Provides specific commands and patterns for implementing Azure AI Search capabilities in .NET that the AI wouldn't reliably generate on its own.
What it needs
Requires dotnet installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Azure.Search.Documents (.NET) Build search applications with full-text, vector, semantic, and hybrid search capabilities. Installation Current Versions: Stable v11.7.0, Preview v11.8.0-beta.1 Environment Variables Authentication DefaultAzureCredential (preferred): API Key: Client Selection Client Purpose -------- --------- SearchClient Query indexes, upload/update/delete documents SearchIndexClient Create/manage indexes, synonym maps SearchIndexerClient Manage indexers, skillsets, data sources Index Creation Using FieldBuilder (Recommended) Manual Field Definition Document Operations Search Patterns Basic Search Faceted Search Autocomplete and Suggestions Vector Search See references/vector-search.md for detailed patterns. Semantic Search See references/semantic-search.md for detailed patterns. Hybrid Search (Vector + Keyword + Semantic) Field Attributes Reference Attribute Purpose ----------- --------- SimpleField Non-searchable field (filters, sorting, facets) SearchableField Full-text searchable field VectorSearchField Vector embedding field IsKey = true Document key (required, one per index) IsFilterable = true Enable $filter expressions IsSortable = true Enable $orderby IsFacetable = true Enable faceted navigation IsHidden = true Exclude from results AnalyzerName Specify text analyzer Error Handling Best Practices 1. Use DefaultAzureCredential over API keys for production 2. Use FieldBuilder with model attributes for type-safe index definitions 3. Use CreateOrUpdateIndexAsync for idempotent index creation 4. Batch document operations for better throughput 5. Use Select to return only needed fields 6. Configure semantic search for natural language queries 7. Combine vector + keyword + semantic for best relevance Reference Files File Contents ------ ---------- references/vector-search.md Vector search, hybrid search, vectorizers references/semantic-search.md Semantic ranking, captions, answers
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/azure-search-documents-dotnet