azure-cognitive-search

name	azure-cognitive-search
description	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 building indexes, indexers, skillsets, vectors, semantic ranker queries, or agentic RAG retrieval, and other Azure AI Search related development tasks. Not for Azure Cosmos DB (use azure-cosmos-db), Azure Table Storage (use azure-table-storage), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics). Use when this capability is needed.
metadata	{"author":"gabrielmoreira"}

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/skillset issues, including errors, warnings, OData filters, portal debug sessions, private link, and storage/metrics discrepancies
Best Practices	L49-L69	Designing, scaling, and troubleshooting Azure AI Search indexing/query pipelines, including enrichment, data modeling, concurrency, cost/perf tuning, chunking, vectors, and handling blob/SQL changes.
Decision Making	L70-L83	Guidance on planning and managing Azure AI Search services: pricing and tiers, capacity estimation and upgrades, regional choices, SDK/API migrations, and cost optimization.
Architecture & Design Patterns	L84-L90	Architectural guidance for Azure AI Search: RAG patterns, knowledge store design, multitenancy and tenant isolation, and multi-region/high-availability deployment designs.
Limits & Quotas	L91-L100	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	L101-L138	Securing Azure AI Search: identity/RBAC, keys and encryption, private networking, indexer access to data sources, document-level ACLs, and policy/compliance controls.
Configuration	L139-L238	Configuring Azure AI Search: data sources, indexers, indexes, analyzers, skills/enrichment, vectors, semantic ranker, monitoring, and agentic retrieval/answer synthesis settings.
Integrations & Coding Patterns	L239-L300	Patterns and code for integrating Azure AI Search with data sources, indexers, vectorization, OData/Lucene queries, semantic ranking, custom skills, and knowledge stores/Power BI.
Deployment	L301-L307	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
Troubleshoot Azure AI Search storage and 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
Model complex and nested data in Azure AI Search	https://learn.microsoft.com/en-us/azure/search/search-howto-complex-data-types
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

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 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
Apply RAG patterns with Azure AI Search and generative AI	https://learn.microsoft.com/en-us/azure/search/retrieval-augmented-generation-overview
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

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

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 APIs and MCP	https://learn.microsoft.com/en-us/azure/search/agentic-retrieval-how-to-retrieve
Configure AML custom skill in Azure AI Search	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

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

---

Source: gabrielmoreira/agent-skills-mirror — distributed by TomeVault.