Azure AI Search .NET: Full-Text, Vector & Hybrid Search

What This Skill Does

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".

When to Use It

This skill is designed for .NET/C# developers working with Azure cloud services. Reach for it when you need to:

• Integrate Azure Search Documents capabilities into your application
• Follow SDK best practices for authentication, error handling, and resource management
• Understand the correct API patterns and client initialization

Key Capabilities

Authentication

Azure SDK skills use DefaultAzureCredential for flexible authentication that works across development and production:

# Supports managed identity, CLI credentials, environment variables
# No hardcoded keys needed

Core Operations

The skill covers the primary operations for this service:

1. Client initialization — Proper setup with credential providers and configuration
2. Resource operations — Create, read, update, and delete operations specific to this service
3. Error handling — Azure-specific exception patterns and retry strategies
4. Async support — Both synchronous and asynchronous client patterns where available

Best Practices

• Use managed identity in production — Avoid storing credentials in code or config files
• Handle throttling gracefully — Azure services have rate limits; implement exponential backoff
• Log operations — Enable SDK logging for debugging without exposing sensitive data
• Pin SDK versions — Use specific versions in production to avoid breaking changes

Common Patterns

Resource Lifecycle

Most Azure SDK operations follow a consistent pattern:

1. Create a credential object
2. Initialize the service client with the credential and endpoint
3. Perform operations through the client
4. Handle responses and errors consistently

Configuration

Keep service endpoints, resource names, and other configuration in environment variables or Azure App Configuration rather than hardcoding them.

When NOT to Use

• Management plane operations — Use the Azure Resource Manager SDK for provisioning and lifecycle management
• Multi-cloud deployments — Consider cloud-agnostic abstractions if you need portability
• Simple HTTP calls — If you only need one API call, the REST API might be simpler than the full SDK

Related Resources

• Azure SDK for .NET/C# documentation
• Azure Search Documents documentation