SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-cognitive-search

MicrosoftDocs

azure-cognitive-search

Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring indexes/skillsets, indexers, vectors/semantic ranker, private endpoints, or RAG/agent retrieval flows, and other Azure AI Search related development tasks. Not for Azure Cosmos DB (use azure-cosmos-db), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics), Azure Data Explorer (use azure-data-explorer).

globalRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
generated_at:2026-06-21
generator:docs2skills/1.0.0
New~9.7k
v1.0Saved Jun 26, 2026

Azure AI Search Skill

This skill provides expert guidance for Azure AI Search. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category Lines Description
Troubleshooting L37-L48 Diagnosing and fixing Azure AI Search indexer and skillset issues, including debug sessions, OData filter errors, private link problems, and storage metric discrepancies.
Best Practices L49-L68 Guidance on designing, scaling, and troubleshooting indexing/enrichment pipelines, modeling data, optimizing performance/costs, and tuning vector/GenAI behavior in Azure AI Search.
Decision Making L69-L83 Guidance on planning and migrating Azure AI Search: API/SDK upgrades, capacity and region choices, data connectors, pricing models, and cost management.
Architecture & Design Patterns L84-L89 Architectural guidance for Azure AI Search: RAG patterns, knowledge store design, multitenancy and tenant isolation, and multi-region/high-availability deployment designs.
Limits & Quotas L90-L99 Limits, quotas, and scheduling for Azure AI Search: billing/free enrichment, indexer run windows and runtime caps, service/index/vector size limits by tier and platform.
Security L100-L137 Securing Azure AI Search: RBAC/keyless auth, API keys, encryption/CMK, network isolation (private endpoints, firewalls), indexer access to data sources, and query-time ACL/labels.
Configuration L138-L237 Configuring Azure AI Search: data sources, indexers, skillsets, analyzers, vectors, semantic ranker, logging/monitoring, and agentic retrieval/answer synthesis settings.
Integrations & Coding Patterns L238-L304 Patterns and code for integrating Azure AI Search with data sources, vectorization, query syntaxes (OData/Lucene), custom skills/vectorizers, knowledge stores, and app/agent retrieval flows
Deployment L305-L311 Deploying and moving Azure AI Search services with ARM/Bicep/Terraform, plus guidance on cross-region moves and checking regional feature and SKU availability.

Troubleshooting

Topic URL
Troubleshoot Azure AI Search indexer errors and warnings https://learn.microsoft.com/en-us/azure/search/cognitive-search-common-errors-warnings
Understand Debug Sessions for skillset troubleshooting https://learn.microsoft.com/en-us/azure/search/cognitive-search-debug-session
Debug and troubleshoot Azure AI Search skillsets https://learn.microsoft.com/en-us/azure/search/cognitive-search-how-to-debug-skillset
Debug Azure AI Search skillsets using portal sessions https://learn.microsoft.com/en-us/azure/search/cognitive-search-tutorial-debug-sessions
Troubleshoot Azure AI Search indexer issues without errors https://learn.microsoft.com/en-us/azure/search/search-indexer-troubleshooting
Troubleshoot OData collection filter errors in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-troubleshoot-collection-filters
Troubleshoot shared private link resource issues in Azure AI Search https://learn.microsoft.com/en-us/azure/search/troubleshoot-shared-private-link-resources
Diagnose Azure AI Search storage metric discrepancies https://learn.microsoft.com/en-us/azure/search/troubleshoot-storage-metrics

Best Practices

Topic URL
Design tips and troubleshooting for AI enrichment pipelines https://learn.microsoft.com/en-us/azure/search/cognitive-search-concept-troubleshooting
Scale and manage custom skills in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-custom-skill-scale
Model SQL relational data for Azure AI Search indexing https://learn.microsoft.com/en-us/azure/search/index-sql-relational-data
Apply responsible AI best practices for GenAI Prompt skill https://learn.microsoft.com/en-us/azure/search/responsible-ai-best-practices-genai-prompt-skill
Handle changed and deleted blobs in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-changed-deleted
Optimize Azure Blob plaintext indexing with parsing modes https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-plaintext
Optimize large-scale indexing in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-large-index
Apply optimistic concurrency for Azure AI Search resources https://learn.microsoft.com/en-us/azure/search/search-howto-concurrency
Update or rebuild Azure AI Search indexes safely https://learn.microsoft.com/en-us/azure/search/search-howto-reindex
Analyze Azure AI Search query and indexing performance https://learn.microsoft.com/en-us/azure/search/search-performance-analysis
Optimize Azure AI Search query and indexing performance https://learn.microsoft.com/en-us/azure/search/search-performance-tips
Optimize Azure AI Search Serverless costs https://learn.microsoft.com/en-us/azure/search/serverless-cost-optimization
Efficient C# indexing with Azure AI Search Push API https://learn.microsoft.com/en-us/azure/search/tutorial-optimize-indexing-push-api
Chunk documents for Azure AI Search vector retrieval https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-chunk-documents
Choose vector optimization and compression in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-configure-compression-storage
Truncate embedding dimensions with MRL in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-truncate-dimensions

Decision Making

Topic URL
Migrate from deprecated Azure AI Search skills https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-deprecated
Migrate Azure AI Search REST API versions safely https://learn.microsoft.com/en-us/azure/search/search-api-migration
Estimate Azure AI Search capacity needs https://learn.microsoft.com/en-us/azure/search/search-capacity-planning
Choose appropriate data source connectors for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-data-sources-gallery
Choose and use Azure AI Search management SDKs https://learn.microsoft.com/en-us/azure/search/search-dotnet-mgmt-sdk-migration
Upgrade Azure AI Search .NET apps to SDK v11 https://learn.microsoft.com/en-us/azure/search/search-dotnet-sdk-migration-version-11
Compare Azure AI Search features by tier and region https://learn.microsoft.com/en-us/azure/search/search-features-list
Upgrade Azure AI Search service capacity in portal https://learn.microsoft.com/en-us/azure/search/search-how-to-upgrade
Choose alternative regions for Azure AI Search capacity https://learn.microsoft.com/en-us/azure/search/search-region-capacity
Plan and manage Azure AI Search costs https://learn.microsoft.com/en-us/azure/search/search-sku-manage-costs
Choose Azure AI Search pricing model and tier https://learn.microsoft.com/en-us/azure/search/search-sku-tier

Architecture & Design Patterns

Topic URL
Implement multitenancy and content isolation in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-modeling-multitenant-saas-applications
Design multi-region architectures for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-multi-region

Limits & Quotas

Topic URL
Billing limits and free quotas for Azure AI Search enrichment https://learn.microsoft.com/en-us/azure/search/cognitive-search-attach-cognitive-services
Schedule Azure AI Search indexers and understand run windows https://learn.microsoft.com/en-us/azure/search/search-howto-schedule-indexers
Understand indexer runtime quotas on Serverless and S3 HD https://learn.microsoft.com/en-us/azure/search/search-indexer-high-density-serverless-overview
Azure AI Search service limits by tier https://learn.microsoft.com/en-us/azure/search/search-limits-quotas-capacity
Understand index count limits for Azure AI Search tiers in .NET tutorial https://learn.microsoft.com/en-us/azure/search/tutorial-csharp-create-load-index
Understand Azure AI Search vector index size limits https://learn.microsoft.com/en-us/azure/search/vector-search-index-size

Security

Topic URL
Enable or disable Web Knowledge Source access in Azure https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-web-manage
Use built-in Azure Policy definitions for Azure AI Search https://learn.microsoft.com/en-us/azure/search/policy-reference
Configure document-level access control in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-document-level-access-overview
Configure keyless RBAC access to Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-get-started-rbac
Secure Azure OpenAI skills via API Management https://learn.microsoft.com/en-us/azure/search/search-how-to-configure-azure-openai-api-management
Enable AI Search indexer access to SQL Managed Instance https://learn.microsoft.com/en-us/azure/search/search-how-to-index-sql-managed-instance
Configure managed identity access to SQL Managed Instance https://learn.microsoft.com/en-us/azure/search/search-how-to-index-sql-managed-instance-with-managed-identity
Secure AI Search indexer connections to SQL Server VMs https://learn.microsoft.com/en-us/azure/search/search-how-to-index-sql-server
Configure managed identities and RBAC for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-managed-identities
Secure Azure Functions indexer calls with Easy Auth https://learn.microsoft.com/en-us/azure/search/search-howto-managed-identities-azure-functions
Secure Cosmos DB indexer connections with managed identity https://learn.microsoft.com/en-us/azure/search/search-howto-managed-identities-cosmos-db
Connect Azure AI Search indexers to Azure SQL securely https://learn.microsoft.com/en-us/azure/search/search-howto-managed-identities-sql
Configure managed identity access from Azure AI Search to Storage https://learn.microsoft.com/en-us/azure/search/search-howto-managed-identities-storage
Connect Azure AI Search indexers to SQL Managed Instance privately https://learn.microsoft.com/en-us/azure/search/search-indexer-how-to-access-private-sql
Configure Azure AI Search indexer access through IP firewalls https://learn.microsoft.com/en-us/azure/search/search-indexer-howto-access-ip-restricted
Configure shared private link access for Azure AI Search indexers https://learn.microsoft.com/en-us/azure/search/search-indexer-howto-access-private
Configure trusted service exception for Azure AI Search indexers https://learn.microsoft.com/en-us/azure/search/search-indexer-howto-access-trusted-service-exception
Secure indexer access to network-protected resources in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-indexer-securing-resources
Configure security and access for Azure AI Search services https://learn.microsoft.com/en-us/azure/search/search-manage
Enforce query-time ACL and RBAC in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-access-control-rbac-enforcement
Enforce Purview sensitivity labels at query time in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-sensitivity-labels
Manage Azure AI Search admin and query API keys https://learn.microsoft.com/en-us/azure/search/search-security-api-keys
Apply security best practices to Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-security-best-practices
Enable RBAC for Azure AI Search data plane operations https://learn.microsoft.com/en-us/azure/search/search-security-enable-roles
Retrieve Azure AI Search encryption key metadata https://learn.microsoft.com/en-us/azure/search/search-security-get-encryption-keys
Configure customer-managed encryption keys for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-security-manage-encryption-keys
Set up cross-tenant CMK encryption for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-security-managed-encryption-cross-tenant
Join Azure AI Search to a network security perimeter https://learn.microsoft.com/en-us/azure/search/search-security-network-security-perimeter
Assign Azure RBAC roles for Azure AI Search access https://learn.microsoft.com/en-us/azure/search/search-security-rbac
Configure client applications for keyless RBAC access to Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-security-rbac-client-code
Implement document-level security filters in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-security-trimming-for-azure-search
Use Azure Policy compliance controls for Azure AI Search https://learn.microsoft.com/en-us/azure/search/security-controls-policy
Configure IP firewall and trusted service access for Azure AI Search https://learn.microsoft.com/en-us/azure/search/service-configure-firewall
Configure Azure AI Search private endpoints https://learn.microsoft.com/en-us/azure/search/service-create-private-endpoint

Configuration

Topic URL
Configure Azure SQL knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-azure-sql
Configure blob knowledge source for Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-blob
Configure Fabric Data Agent knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-fabric-data-agent
Configure Fabric Ontology knowledge source for Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-fabric-ontology
Configure file-based knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-file
Configure MCP server knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-mcp-server
Configure OneLake indexed knowledge source for Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-onelake
Configure search index knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-search-index
Configure indexed SharePoint knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-sharepoint-indexed
Configure remote SharePoint knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-sharepoint-remote
Configure web knowledge source for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-web
Configure Work IQ knowledge source for Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-knowledge-source-how-to-work-iq
Configure answer synthesis for Azure AI Search knowledge bases https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-answer-synthesis
Configure freshness-aware retrieval for Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-configure-freshness
Define Azure AI Search index for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-create-index
Create and configure knowledge bases for agentic retrieval https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-create-knowledge-base
Configure agentic retrieval billing in Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-enable-disable
Configure image serving for agentic retrieval answer synthesis https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-image-serving
Set retrieval reasoning effort for agentic Azure AI Search https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-set-retrieval-reasoning-effort
Use annotation syntax to reference enriched nodes in skillsets https://learn.microsoft.com/en-us/azure/search/cognitive-search-concept-annotations-syntax
Create skillsets with Azure AI Search REST APIs https://learn.microsoft.com/en-us/azure/search/cognitive-search-defining-skillset
Configure output field mappings for Azure AI Search skillsets https://learn.microsoft.com/en-us/azure/search/cognitive-search-output-field-mapping
Configure built-in skills in Azure AI Search enrichment pipelines https://learn.microsoft.com/en-us/azure/search/cognitive-search-predefined-skills
Use skill context and annotation language in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-annotation-language
Configure Azure OpenAI Embedding skill for AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-azure-openai-embedding
Configure Conditional skill in AI Search skillsets https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-conditional
Configure Azure Content Understanding skill in AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-content-understanding
Configure Custom Entity Lookup skill parameters https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-custom-entity-lookup
Control Document Extraction behavior in skillsets https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-document-extraction
Configure Document Layout skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-document-intelligence-layout
Configure Entity Linking v3 skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-entity-linking-v3
Configure Entity Recognition skill v2 in skillsets https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-entity-recognition
Configure Entity Recognition v3 skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-entity-recognition-v3
Set up GenAI Prompt skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-genai-prompt
Configure Image Analysis skill in Azure AI Search enrichment https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-image-analysis
Configure Key Phrase Extraction skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-keyphrases
Configure Language Detection skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-language-detection
Configure Named Entity Recognition skill v2 https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-named-entity-recognition
Configure OCR skill for Azure AI Search image text extraction https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-ocr
Configure PII Detection skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-pii-detection
Use Sentiment skill v2 and interpret scores https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-sentiment
Configure Sentiment v3 skill in Azure AI Search enrichment https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-sentiment-v3
Use Shaper skill to restructure enrichment output https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-shaper
Configure Text Translation skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-text-translation
Configure Text Merge skill to consolidate fields https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-textmerger
Configure Text Split skill for chunking content https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-textsplit
Configure Azure Vision multimodal embeddings skill in Azure AI Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-skill-vision-vectorize
Design and configure skillsets for AI enrichment https://learn.microsoft.com/en-us/azure/search/cognitive-search-working-with-skillsets
Configure enrichment caching for AI pipelines (preview) https://learn.microsoft.com/en-us/azure/search/enrichment-cache-how-to-configure
Manage enrichment cache stored in Azure Storage https://learn.microsoft.com/en-us/azure/search/enrichment-cache-how-to-manage
Define custom analyzers for Azure AI Search indexes https://learn.microsoft.com/en-us/azure/search/index-add-custom-analyzers
Add language analyzers to Azure AI Search fields https://learn.microsoft.com/en-us/azure/search/index-add-language-analyzers
Define and apply scoring profiles in Azure AI Search https://learn.microsoft.com/en-us/azure/search/index-add-scoring-profiles
Configure suggesters for autocomplete in Azure AI Search https://learn.microsoft.com/en-us/azure/search/index-add-suggesters
Configure BM25 relevance scoring in Azure AI Search https://learn.microsoft.com/en-us/azure/search/index-ranking-similarity
Reference for Azure AI Search monitoring metrics and logs https://learn.microsoft.com/en-us/azure/search/monitor-azure-cognitive-search-data-reference
Reference stopword lists for Azure AI Search analyzers https://learn.microsoft.com/en-us/azure/search/reference-stopwords
Configure analyzers for text processing in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-analyzers
Use Azure AI Search preview APIs and features https://learn.microsoft.com/en-us/azure/search/search-api-preview
Map blob and document metadata into Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-blob-metadata-properties
Configure Azure AI Search indexers for data ingestion https://learn.microsoft.com/en-us/azure/search/search-how-to-create-indexers
Define and create search index schemas in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-create-search-index
Configure index projections for vectorized AI Search data https://learn.microsoft.com/en-us/azure/search/search-how-to-define-index-projections
Delete documents from Azure AI Search indexes via APIs https://learn.microsoft.com/en-us/azure/search/search-how-to-delete-documents
Configure delimitedText parsing for CSV blob indexing https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-csv
Configure JSON blob parsing for Azure AI Search indexers https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-json
Configure Azure AI Search indexers for Markdown blobs https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-markdown
Configure one-to-many blob indexing with parsing modes https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-one-to-many
Configure Azure AI Search indexer for OneLake files https://learn.microsoft.com/en-us/azure/search/search-how-to-index-onelake-files
Load and refresh data into Azure AI Search indexes https://learn.microsoft.com/en-us/azure/search/search-how-to-load-search-index
Configure complex data types in Azure AI Search indexes https://learn.microsoft.com/en-us/azure/search/search-howto-complex-data-types
Configure and manage Azure AI Search indexer runs https://learn.microsoft.com/en-us/azure/search/search-howto-run-reset-indexers
Configure field mappings for Azure AI Search indexers https://learn.microsoft.com/en-us/azure/search/search-indexer-field-mappings
Manage Azure AI Search services with Azure CLI https://learn.microsoft.com/en-us/azure/search/search-manage-azure-cli
Manage Azure AI Search with PowerShell scripts https://learn.microsoft.com/en-us/azure/search/search-manage-powershell
Configure Azure AI Search services using Management REST APIs https://learn.microsoft.com/en-us/azure/search/search-manage-rest
Configure diagnostic logging for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-monitor-enable-logging
Visualize Azure AI Search logs and metrics in Power BI https://learn.microsoft.com/en-us/azure/search/search-monitor-logs-powerbi
Monitor Azure AI Search query performance and volume https://learn.microsoft.com/en-us/azure/search/search-monitor-queries
Configure and use moreLikeThis queries in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-more-like-this
Configure text normalizers for filters, facets, and sort https://learn.microsoft.com/en-us/azure/search/search-normalizers
Configure Azure AI Search indexer for JSON blob data https://learn.microsoft.com/en-us/azure/search/search-semi-structured-data
Migrate Azure AI Search semantic ranking code https://learn.microsoft.com/en-us/azure/search/semantic-code-migration
Configure semantic ranker settings for Azure AI Search https://learn.microsoft.com/en-us/azure/search/semantic-how-to-configure
Configure semantic ranker billing plans in Azure AI Search https://learn.microsoft.com/en-us/azure/search/semantic-how-to-enable-disable
Configure scoring profiles with semantic ranking in Azure AI Search https://learn.microsoft.com/en-us/azure/search/semantic-how-to-enable-scoring-profiles
Create and configure custom analyzers in Azure AI Search https://learn.microsoft.com/en-us/azure/search/tutorial-create-custom-analyzer
Assign narrow data types to Azure AI Search vector fields https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-assign-narrow-data-types
Configure vectorizers and vector profiles in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-configure-vectorizer
Configure vector indexes and fields in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-create-index
Index binary vectors for Azure AI Search vector queries https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-index-binary-data
Configure vector quantization in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-quantization
Configure vector storage options in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-storage-options
Configure integrated vectorization in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-integrated-vectorization
Configure Azure Vision vectorizer for multimodal embeddings https://learn.microsoft.com/en-us/azure/search/vector-search-vectorizer-ai-services-vision
Configure Azure OpenAI vectorizer for query-time embeddings https://learn.microsoft.com/en-us/azure/search/vector-search-vectorizer-azure-open-ai

Integrations & Coding Patterns

Topic URL
Migrate Azure AI Search agentic retrieval code https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-migrate
Query Azure AI Search knowledge bases via API and MCP https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-retrieve
Integrate Azure ML or Foundry models as custom Azure AI Search skills https://learn.microsoft.com/en-us/azure/search/cognitive-search-aml-skill
Implement Azure AI Search custom skill with Bing Entity Search https://learn.microsoft.com/en-us/azure/search/cognitive-search-create-custom-skill-example
Implement custom skill interface for Azure AI Search enrichment https://learn.microsoft.com/en-us/azure/search/cognitive-search-custom-skill-interface
Implement Custom Web API skill for enrichment https://learn.microsoft.com/en-us/azure/search/cognitive-search-custom-skill-web-api
Connect Azure AI Search knowledge stores to Power BI https://learn.microsoft.com/en-us/azure/search/knowledge-store-connect-power-bi
Create Azure AI Search knowledge stores via REST APIs https://learn.microsoft.com/en-us/azure/search/knowledge-store-create-rest
Implement complex projection shapes for knowledge stores https://learn.microsoft.com/en-us/azure/search/knowledge-store-projection-example-long
Define knowledge store projections in Azure AI Search https://learn.microsoft.com/en-us/azure/search/knowledge-store-projections-examples
Use Lucene query syntax with Azure AI Search https://learn.microsoft.com/en-us/azure/search/query-lucene-syntax
Construct OData expressions for Azure AI Search queries https://learn.microsoft.com/en-us/azure/search/query-odata-filter-orderby-syntax
Use simple query syntax in Azure AI Search https://learn.microsoft.com/en-us/azure/search/query-simple-syntax
Implement autocomplete and suggestions in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-add-autocomplete-suggestions
Ingest Azure Blob RBAC scopes with search indexers https://learn.microsoft.com/en-us/azure/search/search-blob-indexer-role-based-access
Index Azure Blob Storage content with Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-blob-storage-integration
Index Azure Files shares with Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-file-storage-integration
Author filter expressions for Azure AI Search queries https://learn.microsoft.com/en-us/azure/search/search-filters
Use Python SDK and REST APIs for vector search https://learn.microsoft.com/en-us/azure/search/search-get-started-vector
Use Azure.Search.Documents .NET client for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-dotnet-sdk
Index client-side encrypted blobs with Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-encrypted
Configure Azure Blob indexer for automated search indexing https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-blob-storage
Configure ADLS Gen2 indexer for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-data-lake-storage
Configure Azure Table indexers for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-azure-tables
Index Azure Cosmos DB Gremlin data with AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-cosmosdb-gremlin
Index Azure Cosmos DB for MongoDB with AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-cosmosdb-mongodb
Index Azure Cosmos DB NoSQL data with Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-cosmosdb-sql
Configure Logic Apps workflows for Azure AI Search indexing https://learn.microsoft.com/en-us/azure/search/search-how-to-index-logic-apps
Index Azure Database for MySQL with AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-mysql
Index SharePoint Online content with Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-sharepoint-online
Configure Azure SQL indexer for Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-index-sql-database
Configure REST-based integrated vectorization in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-how-to-integrated-vectorization
Page Azure AI Search list API results https://learn.microsoft.com/en-us/azure/search/search-how-to-page-list-results
Use Document Layout skill for semantic chunking and vectorization https://learn.microsoft.com/en-us/azure/search/search-how-to-semantic-chunking
Use Content Understanding skill for semantic chunking https://learn.microsoft.com/en-us/azure/search/search-how-to-semantic-chunking-content-understanding
Index ACL and RBAC metadata via Azure AI Search push API https://learn.microsoft.com/en-us/azure/search/search-index-access-control-lists-and-rbac-push-api
Ingest ADLS Gen2 ACL and RBAC metadata with indexers https://learn.microsoft.com/en-us/azure/search/search-indexer-access-control-lists-and-role-based-access
Ingest Microsoft Purview sensitivity labels with Azure AI Search indexers https://learn.microsoft.com/en-us/azure/search/search-indexer-sensitivity-labels
Ingest SharePoint ACL metadata using Azure AI Search indexers https://learn.microsoft.com/en-us/azure/search/search-indexer-sharepoint-access-control-lists
Implement fuzzy search and typo tolerance in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-fuzzy
Use Lucene query syntax in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-lucene-examples
Use OData collection operators any/all in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-odata-collection-operators
Use OData comparison operators in Azure AI Search filters https://learn.microsoft.com/en-us/azure/search/search-query-odata-comparison-operators
Use OData $filter in Azure AI Search queries https://learn.microsoft.com/en-us/azure/search/search-query-odata-filter
Use OData full-text search functions in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-odata-full-text-search-functions
Use OData geo-spatial functions in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-odata-geo-spatial-functions
Use OData logical operators in Azure AI Search filters https://learn.microsoft.com/en-us/azure/search/search-query-odata-logical-operators
Use OData $orderby in Azure AI Search queries https://learn.microsoft.com/en-us/azure/search/search-query-odata-orderby
Use the OData search.in function in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-odata-search-in-function
Use the OData search.score function in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-odata-search-score-function
Use OData $select in Azure AI Search query results https://learn.microsoft.com/en-us/azure/search/search-query-odata-select
OData expression grammar for Azure AI Search queries https://learn.microsoft.com/en-us/azure/search/search-query-odata-syntax-reference
Query partial terms and patterns in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-partial-matching
Use simple query syntax in Azure AI Search https://learn.microsoft.com/en-us/azure/search/search-query-simple-examples
Invoke semantic ranking in Azure AI Search queries https://learn.microsoft.com/en-us/azure/search/semantic-how-to-query-request
Use semantic ranker for query rewriting in Azure AI Search https://learn.microsoft.com/en-us/azure/search/semantic-how-to-query-rewrite
Use .NET SDK query patterns for Azure AI Search integration https://learn.microsoft.com/en-us/azure/search/tutorial-csharp-search-query-integration
Index multiple Azure data sources into one search index https://learn.microsoft.com/en-us/azure/search/tutorial-multiple-data-sources
Apply filters and modes to Azure AI vector queries https://learn.microsoft.com/en-us/azure/search/vector-search-filters
Create and send vector queries in Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-how-to-query
Integrate Microsoft Foundry embedding models with Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-integrated-vectorization-ai-studio
Configure Foundry model catalog vectorizer https://learn.microsoft.com/en-us/azure/search/vector-search-vectorizer-azure-machine-learning-ai-studio-catalog
Configure Custom Web API vectorizer for Azure AI Search https://learn.microsoft.com/en-us/azure/search/vector-search-vectorizer-custom-web-api

Deployment

Topic URL
Deploy Azure AI Search service using ARM templates https://learn.microsoft.com/en-us/azure/search/search-get-started-arm
Deploy Azure AI Search service using Bicep https://learn.microsoft.com/en-us/azure/search/search-get-started-bicep
Provision Azure AI Search with Terraform https://learn.microsoft.com/en-us/azure/search/search-get-started-terraform
Manually move Azure AI Search services across regions https://learn.microsoft.com/en-us/azure/search/search-howto-move-across-regions
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

87/100

Grade

A

Excellent

Safety

90

Quality

88

Clarity

88

Completeness

82

Summary

This skill provides expert guidance on Azure AI Search development, combining local quick-reference content organized by category (troubleshooting, best practices, security, configuration, etc.) with remote documentation fetching capabilities. It uses MCP tools to retrieve Microsoft Learn documentation and serves as a knowledge hub for Azure AI Search tasks like indexing, enrichment, vector search, security, and deployment.

Detected Capabilities

network requestdocumentation fetchremote URL accessread_file

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure search troubleshootingconfigure search indexersvector search setupazure search securityagentic retrievalsearch index designsemantic rankingenrichment pipeline

Risk Signals

INFO

External documentation fetching via mcp_microsoftdocs or fetch_webpage

Compatibility section, How to Use section
INFO

Network access required for remote documentation retrieval

Compatibility section
INFO

Fallback to fetch_webpage with query parameters

How to Use section

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Troubleshoot Azure AI Search indexer and skillset errors using debug sessions
  • Design and configure AI enrichment pipelines with built-in and custom skills
  • Implement secure Azure AI Search deployments with RBAC, encryption, and network isolation
  • Build RAG and agentic retrieval systems with Azure AI Search knowledge bases
  • Optimize vector search performance with quantization, compression, and dimension truncation
  • Configure knowledge sources for agentic retrieval (blob, SQL, SharePoint, web)
  • Migrate Azure AI Search code and API versions safely with deprecated skill handling
  • Design multi-tenant and multi-region architectures for Azure AI Search

Quality Notes

  • Excellent category index with line ranges and clear hierarchy — makes navigation predictable
  • All 100+ documentation links are properly formatted and topically relevant
  • Clear separation of concerns: local reference content vs. remote fetch capabilities
  • Explicit instruction for agents on when to use read_file vs. fetch_webpage tools
  • Metadata staleness check (3-month threshold) helps maintain documentation currency
  • Comprehensive coverage across nine major domains with no apparent gaps
  • MCP tool availability check guides graceful degradation
  • Well-organized table structure makes scanning and discovery efficient
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Add MicrosoftDocs/azure-cognitive-search to your library

Get Started Free

Command Palette

Search for a command to run...