Skip to content
cccskills
FreePublished on GitHub

azure-documentdb

Expert knowledge for Azure DocumentDB development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Mongo-compatible APIs, vector search, cross-region replication, change streams, or the HTTPS Data API, and other Azure DocumentDB 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 SQL Managed Instance (use azure-sql-managed-instance).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills
Works withAzureTerraformMongoDB
See how to install

Files included (1)

  • SKILL.md16.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Azure DocumentDB Skill

This skill provides expert guidance for Azure DocumentDB. 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

CategoryLinesDescription
TroubleshootingL37-L45Diagnosing and fixing DocumentDB issues: common errors, CMK encryption problems, query performance via explain(), connectivity, and replication troubleshooting.
Best PracticesL46-L56Best practices for DocumentDB indexing and queries, safe index changes, and configuring cross-region replication and high availability for resilient, performant data access.
Decision MakingL57-L71Guidance on choosing DocumentDB vs MongoDB services, planning and migrating MongoDB workloads, configuring cross-region failover, and selecting optimal vector index/search algorithms across languages
Architecture & Design PatternsL72-L83Patterns for scaling, HA/DR, sharding, multi‑cloud setups, and building Go/TypeScript AI agents (including autonomous travel) on Azure DocumentDB.
Limits & QuotasL84-L97Limits, quotas, and configuration constraints for DocumentDB: compute/storage tiers, free tier caps, SSD performance, indexing/text index limits, document/batch sizes, diagnostics, and feature availability.
SecurityL98-L109Securing DocumentDB clusters: encryption at rest and with customer keys, firewall and public access controls, Private Link, Entra ID RBAC, native users/privileges, and security best practices.
ConfigurationL110-L130Configuring DocumentDB features: search (BM25, vector, fuzzy, phrase, geo), MongoDB compatibility, change streams, replication/scale, transactions, Data API, alerts, and monitoring.
Integrations & Coding PatternsL131-L156Patterns and code to connect apps and AI/RAG tools to Azure DocumentDB, including drivers, HTTPS Data API, migrations (Mongo/Cassandra), vector search, and sample app integrations.
DeploymentL157-L163Guides for deploying and managing DocumentDB clusters: local dev to Azure, backup/restore, version upgrades, and IaC deployment with Bicep and Terraform.

Troubleshooting

TopicURL
Troubleshoot common Azure DocumentDB issueshttps://learn.microsoft.com/en-us/azure/documentdb/faq
Troubleshoot CMK encryption issues in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-database-encryption-troubleshoot
Diagnose query performance using explain() in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-read-explain-output
Troubleshoot common Azure DocumentDB errors and connectivityhttps://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-common-issues
Troubleshoot Azure DocumentDB replication issueshttps://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-replication

Best Practices

TopicURL
Use background indexing safely in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/background-indexing
Apply cross-region replication best practices in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/cross-region-replication
Implement HA and replication best practices in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/high-availability-replication-best-practices
Apply indexing best practices for Azure DocumentDB collectionshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-create-indexes
Explore practical indexing scenarios in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-index
Safely migrate from non-ordered to ordered indexes in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-migrate-ordered-indexes
Optimize Azure DocumentDB queries with Index Advisorhttps://learn.microsoft.com/en-us/azure/documentdb/index-advisor

Decision Making

TopicURL
Choose Azure first-party services for MongoDB workloadshttps://learn.microsoft.com/en-us/azure/documentdb/azure-mongo-first-party
Decide between Azure DocumentDB and MongoDB Atlashttps://learn.microsoft.com/en-us/azure/documentdb/compare-mongodb-atlas
Choose cross-region failover modes in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/failover-modes
Assess MongoDB readiness and plan migration to DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-assess-plan-migration-readiness
Evaluate MongoDB compatibility in managed serviceshttps://learn.microsoft.com/en-us/azure/documentdb/managed-service-compatibility
Choose migration options from MongoDB to Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/migration-options
Evaluate vector search algorithms with .NEThttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-dotnet-select-algorithm
Compare vector index options in Go on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-go-select-algorithm
Test and select vector indexes with Javahttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-java-select-algorithm
Choose vector index algorithms using TypeScripthttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-nodejs-select-algorithm
Select optimal vector index and similarity in Pythonhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-python-select-algorithm

Architecture & Design Patterns

TopicURL
Apply autoscale behavior for Azure DocumentDB workloadshttps://learn.microsoft.com/en-us/azure/documentdb/autoscale
Understand HA and DR internals for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/availability-disaster-recovery-under-hood
Plan high availability for Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/high-availability
Design multi-cloud architectures with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/multi-cloud
Design sharding strategy for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/partitioning
Implement Go-based AI agents with DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-agent-go
Build TypeScript AI agents with DocumentDB vector searchhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-agent-nodejs
Design an autonomous travel agent with DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/tutorial-ai-agent

Limits & Quotas

TopicURL
Use supported compute and storage configurations in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/compute-storage
Use supported compute and storage configurations in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/compute-storage
Understand Azure DocumentDB Free Tier limits and featureshttps://learn.microsoft.com/en-us/azure/documentdb/free-tier
Configure Premium SSD v2 performance for DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/high-performance-storage
Configure text indexes and understand their limits in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-create-text-index
Enable diagnostic logs for Azure DocumentDB with tier constraintshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-monitor-diagnostics-logs
Understand indexing behavior and limits in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/indexing
Reference service limits and quotas for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/limitations
Document size and batch write limits in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/max-document-size
Track Azure DocumentDB feature releases and previewshttps://learn.microsoft.com/en-us/azure/documentdb/release-notes

Security

TopicURL
Understand encryption at rest for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/database-encryption-at-rest
Configure Azure DocumentDB firewall access ruleshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-configure-firewall
Configure Entra ID RBAC authentication for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-connect-role-based-access-control
Configure customer-managed encryption keys for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-data-encryption
Secure Azure DocumentDB with Azure Private Linkhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-private-link
Manage public network access to Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/how-to-public-access
Manage secondary native users and privileges in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/secondary-users
Apply security best practices to Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/security

Configuration

TopicURL
Configure and use change streams in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/change-streams
Configure MongoDB feature compatibility in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/compatibility-features
Use MongoDB query language features on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/compatibility-query-language
Configure fuzzy full-text search in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/full-text-search-fuzzy
Configure hybrid BM25 and vector search on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/full-text-search-hybrid
Set up BM25 keyword search indexes on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/full-text-search-keyword
Configure full-text search in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/full-text-search-overview
Implement phrase and proximity search on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/full-text-search-phrase-proximity
Configure and run geospatial queries in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/geospatial-support
Configure wildcard indexes for dynamic schemas in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-create-wildcard-indexes
Create and use replica clusters in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-cross-region-replica-portal
Configure metric-based alerts for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-manage-alerts
Scale and configure Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/how-to-scale-cluster
Configure multi-operation transactions in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-transactions
Configure and use the Azure DocumentDB MCP Toolkithttps://learn.microsoft.com/en-us/azure/documentdb/mcp-toolkit
Monitor Azure DocumentDB metrics and resource usagehttps://learn.microsoft.com/en-us/azure/documentdb/monitor-metrics
Configure integrated vector store in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/vector-search

Integrations & Coding Patterns

TopicURL
Use LangChain Azure AI vector store with DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/build-rag-applications
Integrate Haystack RAG pipelines with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/build-rag-pipelines
Convert Cassandra schemas to Azure DocumentDB with VS Codehttps://learn.microsoft.com/en-us/azure/documentdb/cassandra-how-to-schema-conversion-vs-code
Use Azure DocumentDB Data API over HTTPShttps://learn.microsoft.com/en-us/azure/documentdb/data-api
Connect Azure Databricks to Azure DocumentDB with Sparkhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-connect-from-databricks
Migrate MongoDB to DocumentDB using native toolshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-migrate-native-tools
Migrate MongoDB using Azure DocumentDB VS Code extensionhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-migrate-vs-code-extension
Persist LangGraph agent state in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/persist-agent-state
Integrate LlamaIndex vector store with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/query-knowledge-base
Integrate .NET/C# apps with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-dotnet
Perform vector search with .NET on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-dotnet-vector-search
Use Go drivers with Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-go
Implement vector search in Go on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-go-vector-search
Connect Java applications to Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-java
Use Java for vector search on Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-java-vector-search
Use Node.js drivers with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-nodejs
Use Node.js for vector search on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-nodejs-vector-search
Connect Python applications to Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-python
Implement vector search in Python on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-python-vector-search
Integrate Rust applications with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-rust
Generate AI advertisements using DocumentDB and OpenAIhttps://learn.microsoft.com/en-us/azure/documentdb/tutorial-ai-advertisement-generation
Build a MERN web app with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/tutorial-nodejs-web-app

Deployment

TopicURL
Develop locally with DocumentDB and deploy to Azurehttps://learn.microsoft.com/en-us/azure/documentdb/development-loop
Upgrade Azure DocumentDB clusters to newer MongoDB versionshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-upgrade-cluster
Deploy Azure DocumentDB clusters with Bicephttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-bicep
Deploy Azure DocumentDB clusters using Terraformhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-terraform

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts/digests, managing rec states, using workbooks, Resource Graph, or RBAC for access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing AKS Edge/Hybrid with Arc, GitOps, IoT/OPC/ONVIF, TPM/Key Vault secrets, or AI model workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

azure-anomaly-detector

Free

Expert knowledge for Azure AI Anomaly Detector development including troubleshooting, best practices, limits & quotas, configuration, and deployment. Use when tuning Docker-based Anomaly Detector, ACI or IoT Edge deployments, univariate/multivariate APIs, or service limits, and other Azure AI Anomaly Detector related development tasks. Not for Azure AI Metrics Advisor (use azure-metrics-advisor), Azure Monitor (use azure-monitor), Azure Machine Learning (use azure-machine-learning).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills784Updated Oct 18, 2026

See all skills by MicrosoftDocs

Report a problem with this skill