[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M711CSNGXF95EMZGJM4CQMMW":3,"skill-same:01M711CSNGXF95EMZGJM4CQMMW":652},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":34,"publishedAt":55,"linkOnly":56,"markdownContent":57,"markdownBody":58,"frontMatter":59,"refName":64,"commitSha":65,"skillDirectory":66,"forksCount":67,"repositoryHtmlUrl":68,"repositoryHomepageUrl":69,"ownerHtmlUrl":70,"ownerBlogUrl":71,"ownerDescription":72,"updatedAt":73,"install":74,"resources":87},"01M711CSNGXF95EMZGJM4CQMMW","cosmosdb-best-practices",null,"Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,\npartitioning, queries, and SDK usage. Use when writing, reviewing, or refactoring\ncode that interacts with Azure Cosmos DB, designing data models, optimizing queries,\nor implementing high-performance database operations.\nUSE FOR: Cosmos DB NoSQL, partition key design, RU optimization, point reads,\ncross-partition queries, SDK singleton, CosmosClient, container modeling,\nchange feed, bulk operations, vector search, full-text search, hierarchical\npartition keys, global distribution, autoscale throughput, indexing policy,\nDO NOT USE FOR: PostgreSQL, MySQL, MongoDB (non-Azure), DynamoDB, Cassandra,\nAzure SQL, Cosmos DB for PostgreSQL (vCore), Cosmos DB for MongoDB vCore, Azure DocumentDB,\ngeneral SQL databases, Redis, Elasticsearch.","microsoft\u002Fvscode-cosmosdb","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M711CDNH6JY9J7RZVN19SNNC",200,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002FSKILL.md",[18,23,26,31],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":32,"categoryName":33,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000033","数据分析师",[35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54],"cosmosdb best practices","best practices","database","high-performance","singleton","elasticsearch","writing","mongodb","kit","design","database operations","implementing","vector","search","partition","performance","db","distribution","databases","bulk","2026-11-10 10:12:30",false,"---\nname: cosmosdb-best-practices\ndescription: |\n  Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,\n  partitioning, queries, and SDK usage. Use when writing, reviewing, or refactoring\n  code that interacts with Azure Cosmos DB, designing data models, optimizing queries,\n  or implementing high-performance database operations.\n  USE FOR: Cosmos DB NoSQL, partition key design, RU optimization, point reads,\n  cross-partition queries, SDK singleton, CosmosClient, container modeling,\n  change feed, bulk operations, vector search, full-text search, hierarchical\n  partition keys, global distribution, autoscale throughput, indexing policy,\n  DO NOT USE FOR: PostgreSQL, MySQL, MongoDB (non-Azure), DynamoDB, Cassandra,\n  Azure SQL, Cosmos DB for PostgreSQL (vCore), Cosmos DB for MongoDB vCore, Azure DocumentDB,\n  general SQL databases, Redis, Elasticsearch.\n\nlicense: MIT\nmetadata:\n  author: cosmosdb-agent-kit\n  version: \"1.0.0\"\n---\n\n# Azure Cosmos DB Best Practices\n\nComprehensive performance optimization guide for Azure Cosmos DB applications, containing 100+ rules across 13 categories, prioritized by impact to guide automated refactoring and code generation.\n\nBefore answering, read the linked rule files relevant to the user's question.\nThe quick reference below is an index, not the full guidance: SDK APIs, limits,\nconfiguration prerequisites, and caveats live in the rule bodies. Use the\nlanguage-specific integration rule when one exists rather than substituting a\ngeneric pattern. Keep answers concise, but include the constraints that make the\nrecommendation correct for the user's scenario.\n\n## When to Apply\n\nReference these guidelines when:\n- Designing data models for Cosmos DB\n- Choosing partition keys\n- Writing or optimizing queries\n- Implementing SDK patterns\n- Using the Cosmos DB Emulator for local development\n- Inspecting or managing Cosmos DB data with developer tooling\n- Implementing vector search or RAG features on Cosmos DB\n- Reviewing code for performance issues\n- Configuring throughput and scaling\n- Building globally distributed applications\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | Data Modeling | CRITICAL | `model-` |\n| 2 | Partition Key Design | CRITICAL | `partition-` |\n| 3 | Query Optimization | HIGH | `query-` |\n| 4 | SDK Best Practices | HIGH | `sdk-` |\n| 5 | Indexing Strategies | MEDIUM-HIGH | `index-` |\n| 6 | Throughput & Scaling | MEDIUM | `throughput-` |\n| 7 | Global Distribution | MEDIUM | `global-` |\n| 8 | Monitoring & Diagnostics | LOW-MEDIUM | `monitoring-` |\n| 9 | Design Patterns | HIGH | `pattern-` |\n| 10 | Developer Tooling | MEDIUM | `tooling-` |\n| 11 | Vector Search | HIGH | `vector-` |\n| 12 | Full-Text Search | HIGH | `fts-` |\n| 13 | Security | HIGH | `security-` |\n\n## Quick Reference\n\n### 1. Data Modeling (CRITICAL)\n\n- [model-embed-related](rules\u002Fmodel-embed-related.md) - Embed related data retrieved together\n- [model-reference-large](rules\u002Fmodel-reference-large.md) - Reference data when items get too large\n- [model-avoid-2mb-limit](rules\u002Fmodel-avoid-2mb-limit.md) - Keep items well under 2MB limit\n- [model-id-constraints](rules\u002Fmodel-id-constraints.md) - Follow ID value length and character constraints\n- [model-unique-keys](rules\u002Fmodel-unique-keys.md) - Enforce business-key uniqueness within the correct logical partition scope\n- [model-nesting-depth](rules\u002Fmodel-nesting-depth.md) - Stay within 128-level nesting depth limit\n- [model-numeric-precision](rules\u002Fmodel-numeric-precision.md) - Understand IEEE 754 numeric precision limits\n- [model-denormalize-reads](rules\u002Fmodel-denormalize-reads.md) - Denormalize for read-heavy workloads including pre-computed aggregates\n- [model-schema-versioning](rules\u002Fmodel-schema-versioning.md) - Version your document schemas\n- [model-type-discriminator](rules\u002Fmodel-type-discriminator.md) - Use type discriminators for polymorphic data\n- [model-json-serialization](rules\u002Fmodel-json-serialization.md) - Handle JSON serialization correctly for Cosmos DB documents\n- [model-relationship-references](rules\u002Fmodel-relationship-references.md) - Use ID references with transient hydration for document relationships\n- [model-ttl-expiration](rules\u002Fmodel-ttl-expiration.md) - Configure TTL relative to the item's last update, with container defaults and item overrides\n\n### 2. Partition Key Design (CRITICAL)\n\n- [partition-high-cardinality](rules\u002Fpartition-high-cardinality.md) - Choose high-cardinality partition keys\n- [partition-avoid-hotspots](rules\u002Fpartition-avoid-hotspots.md) - Distribute writes evenly\n- [partition-hierarchical](rules\u002Fpartition-hierarchical.md) - Use hierarchical partition keys for flexibility; order levels broad→narrow\n- [partition-query-patterns](rules\u002Fpartition-query-patterns.md) - Align partition key with query patterns\n- [partition-synthetic-keys](rules\u002Fpartition-synthetic-keys.md) - Create synthetic keys when needed\n- [partition-key-length](rules\u002Fpartition-key-length.md) - Respect partition key value length limits\n- [partition-immutable-key](rules\u002Fpartition-immutable-key.md) - Choose immutable properties as partition keys\n- [partition-20gb-limit](rules\u002Fpartition-20gb-limit.md) - Plan for 20GB logical partition limit\n- [partition-rekey-migration](rules\u002Fpartition-rekey-migration.md) - Re-key a misaligned container with the Change partition key feature\n\n### 3. Query Optimization (HIGH)\n\n- [query-aggregate-single-pass](rules\u002Fquery-aggregate-single-pass.md) - Compute min\u002Fmax\u002Favg with one scoped aggregate query\n- [query-avoid-cross-partition](rules\u002Fquery-avoid-cross-partition.md) - Minimize cross-partition queries\n- [query-use-projections](rules\u002Fquery-use-projections.md) - Project only needed fields; prefer dedicated result types for projections\n- [query-pagination](rules\u002Fquery-pagination.md) - Use continuation tokens for pagination\n- [query-avoid-scans](rules\u002Fquery-avoid-scans.md) - Avoid full container scans\n- [query-parameterize](rules\u002Fquery-parameterize.md) - Use parameterized queries\n- [query-order-filters](rules\u002Fquery-order-filters.md) - Let the query engine order filters; tune indexed predicates rather than their textual order\n- [query-top-literal](rules\u002Fquery-top-literal.md) - Use literal integers for TOP, never parameters\n- [query-latest-by-timestamp](rules\u002Fquery-latest-by-timestamp.md) - Query \"latest\" documents with explicit ORDER BY and TOP 1\n- [query-olap-detection](rules\u002Fquery-olap-detection.md) - Detect and redirect analytical queries away from transactional containers\n- [query-point-reads](rules\u002Fquery-point-reads.md) - Use point reads (ReadItem) instead of queries when id and partition key are known\n- [query-distinct-keyword](rules\u002Fquery-distinct-keyword.md) - Return unique values with DISTINCT instead of client-side deduplication\n\n### 4. SDK Best Practices (HIGH)\n\n- [sdk-singleton-client](rules\u002Fsdk-singleton-client.md) - Reuse CosmosClient as singleton\n- [sdk-async-api](rules\u002Fsdk-async-api.md) - Use async APIs for throughput\n- [sdk-retry-429](rules\u002Fsdk-retry-429.md) - Handle 429s with retry-after\n- [sdk-connection-mode](rules\u002Fsdk-connection-mode.md) - Use Direct mode for production\n- [sdk-preferred-regions](rules\u002Fsdk-preferred-regions.md) - Configure preferred regions\n- [sdk-excluded-regions](rules\u002Fsdk-excluded-regions.md) - Exclude regions experiencing issues\n- [sdk-availability-strategy](rules\u002Fsdk-availability-strategy.md) - Configure availability strategy for resilience\n- [sdk-circuit-breaker](rules\u002Fsdk-circuit-breaker.md) - Use circuit breaker for fault tolerance\n- [sdk-diagnostics](rules\u002Fsdk-diagnostics.md) - Log diagnostics for troubleshooting\n- [sdk-serialization-enums](rules\u002Fsdk-serialization-enums.md) - Serialize enums as strings not integers\n- [sdk-emulator-ssl](rules\u002Fsdk-emulator-ssl.md) - Configure SSL and connection mode for Cosmos DB Emulator\n- [sdk-ifnonematch-create](rules\u002Fsdk-conditional-create-etag.md) - Use `setIfNoneMatchETag(\"*\")` on `createItem` to reject duplicates atomically (409 on conflict)\n- [sdk-no-shared-request-options](rules\u002Fsdk-request-options-per-call.md) - Use separate `CosmosItemRequestOptions` instances for deferred or concurrent `createItem` operations to avoid shared-state partition-key overrides\n- [sdk-patch-incr](rules\u002Fsdk-patch-counter-increment.md) - Use `CosmosPatchOperations.increment()` for atomic counter increments — no read RU, no ETag conflict cycle\n- [sdk-bypage-empty-token](rules\u002Fsdk-continuation-token-null-guard.md) - Guard against empty-string continuation tokens before calling `byPage()` — pass `null` for first page, never `\"\"`\n- [sdk-etag-concurrency](rules\u002Fsdk-etag-concurrency.md) - Use ETags for optimistic concurrency on read-modify-write operations\n- [sdk-java-content-response](rules\u002Fsdk-java-content-response.md) - Enable content response on write operations (Java)\n- [sdk-java-cosmos-config](rules\u002Fsdk-java-cosmos-config.md) - Configure Cosmos DB initialization correctly in Spring Boot\n- [sdk-java-spring-boot-versions](rules\u002Fsdk-java-spring-boot-versions.md) - Match Java version to Spring Boot requirements\n- [sdk-local-dev-config](rules\u002Fsdk-local-dev-config.md) - Configure local development to avoid cloud conflicts\n- [sdk-dotnet-cosmos-package-id](rules\u002Fsdk-dotnet-cosmos-package-id.md) - Use `Microsoft.Azure.Cosmos`, not the abandoned `Azure.Cosmos` v4-preview package\n- [sdk-newtonsoft-dependency](rules\u002Fsdk-newtonsoft-dependency.md) - Explicitly reference Newtonsoft.Json package\n- [sdk-python-async-deps](rules\u002Fsdk-python-async-deps.md) - Include aiohttp when using Python async SDK\n- [sdk-spring-data-annotations](rules\u002Fsdk-spring-data-annotations.md) - Annotate entities for Spring Data Cosmos\n- [sdk-spring-data-repository](rules\u002Fsdk-spring-data-repository.md) - Use CosmosRepository correctly and handle Iterable return types\n- [sdk-langchain-cosmosdb-saver](rules\u002Fsdk-langchain-cosmosdb-saver.md) - Use CosmosDBSaver for LangGraph checkpointing with async container client\n- [sdk-langchain-async-checkpointer](rules\u002Fsdk-langchain-async-checkpointer.md) - Initialize async Cosmos DB container in startup routine, not module level\n- [sdk-langchain-mcp-persistent-session](rules\u002Fsdk-langchain-mcp-persistent-session.md) - Maintain persistent MCP client sessions for application lifetime\n- [sdk-langchain-mcp-tool-content-format](rules\u002Fsdk-langchain-mcp-tool-content-format.md) - Handle both string and list formats in MCP ToolMessage content\n- [sdk-langgraph-mcp-tool-filtering](rules\u002Fsdk-langgraph-mcp-tool-filtering.md) - Filter MCP tools by name prefix for per-agent assignment\n- [sdk-dotnet-namespace-collision](rules\u002Fsdk-dotnet-namespace-collision.md) - Avoid `Microsoft.Azure.Cosmos` namespace collisions with domain models (User, Database, Container, etc.)\n- [sdk-ingestion-rate-control](rules\u002Fsdk-ingestion-rate-control.md) - Rate-control high-volume ingestion (concurrency, retry-after, throughput control)\n- [sdk-go-partition-key-metadata](rules\u002Fsdk-go-partition-key-metadata.md) - Upgrade stale Go SDKs to serialize partition-key kind metadata correctly across SDKs\n- [sdk-python-client-kwargs](rules\u002Fsdk-python-client-kwargs.md) - Configure Python v4 clients with flat keyword arguments instead of legacy ConnectionPolicy objects\n- [sdk-langchain-js-chat-history](rules\u002Fsdk-langchain-js-chat-history.md) - Persist isolated JS\u002FTS conversations with AzureCosmosDBNoSQLChatMessageHistory\n- [sdk-langchain-js-embedding-model](rules\u002Fsdk-langchain-js-embedding-model.md) - Configure the Azure OpenAI deployment name for JS\u002FTS embeddings\n- [sdk-langchain-js-filter-injection](rules\u002Fsdk-langchain-js-filter-injection.md) - Bind vector-store filter values through a parameterized filterClause\n- [sdk-langchain-js-fulltext-prerequisites](rules\u002Fsdk-langchain-js-fulltext-prerequisites.md) - Configure account capability, text policy, and indexes before hybrid search\n- [sdk-langchain-js-managed-identity](rules\u002Fsdk-langchain-js-managed-identity.md) - Authenticate JS\u002FTS LangChain with managed identity and data-plane RBAC\n- [sdk-langchain-js-search-types](rules\u002Fsdk-langchain-js-search-types.md) - Choose vector, full-text, or hybrid retrieval for the query\n- [sdk-langchain-js-semantic-cache](rules\u002Fsdk-langchain-js-semantic-cache.md) - Reuse equivalent LLM responses with AzureCosmosDBNoSQLSemanticCache\n- [sdk-langchain-js-vectorstore-init](rules\u002Fsdk-langchain-js-vectorstore-init.md) - Initialize JS\u002FTS vector stores with embeddings and pre-provisioned RBAC resources\n\n### 5. Indexing Strategies (MEDIUM-HIGH)\n\n- [index-exclude-unused](rules\u002Findex-exclude-unused.md) - Exclude paths never queried\n- [index-path-syntax](rules\u002Findex-path-syntax.md) - Use correct path notation (`\u002F?`, `\u002F[]`, `\u002F*`)\n- [index-composite](rules\u002Findex-composite.md) - Use composite indexes for ORDER BY\n- [index-composite-direction](rules\u002Findex-composite-direction.md) - Match composite index directions to ORDER BY\n- [index-spatial](rules\u002Findex-spatial.md) - Add spatial indexes for geo queries\n- [index-range-vs-hash](rules\u002Findex-range-vs-hash.md) - Choose appropriate index types\n- [index-lazy-consistent](rules\u002Findex-lazy-consistent.md) - Understand indexing modes\n\n### 6. Throughput & Scaling (MEDIUM)\n\n- [throughput-autoscale](rules\u002Fthroughput-autoscale.md) - Use autoscale for variable workloads\n- [throughput-right-size](rules\u002Fthroughput-right-size.md) - Right-size provisioned throughput\n- [throughput-serverless](rules\u002Fthroughput-serverless.md) - Consider serverless for dev\u002Ftest\n- [throughput-burst](rules\u002Fthroughput-burst.md) - Understand burst capacity\n- [throughput-container-vs-database](rules\u002Fthroughput-container-vs-database.md) - Choose allocation level wisely\n- [throughput-idle-container-review](rules\u002Fthroughput-idle-container-review.md) - Review idle containers for lifecycle action\n- [throughput-ttl-stale-data](rules\u002Fthroughput-ttl-stale-data.md) - Expire stale data with TTL before hitting storage limits\n- [throughput-serverless-migration](rules\u002Fthroughput-serverless-migration.md) - Migrate a low-traffic provisioned account to serverless\n\n### 7. Global Distribution (MEDIUM)\n\n- [global-multi-region](rules\u002Fglobal-multi-region.md) - Configure multi-region writes\n- [global-consistency](rules\u002Fglobal-consistency.md) - Choose appropriate consistency level\n- [global-conflict-resolution](rules\u002Fglobal-conflict-resolution.md) - Implement conflict resolution\n- [global-failover](rules\u002Fglobal-failover.md) - Configure automatic failover\n- [global-read-regions](rules\u002Fglobal-read-regions.md) - Add read regions near users\n- [global-zone-redundancy](rules\u002Fglobal-zone-redundancy.md) - Enable zone redundancy for HA\n- [global-multi-region-write-antipattern](rules\u002Fglobal-multi-region-write-antipattern.md) - Avoid multi-region writes without an active-active need\n\n### 8. Monitoring & Diagnostics (LOW-MEDIUM)\n\n- [monitoring-ru-consumption](rules\u002Fmonitoring-ru-consumption.md) - Track RU consumption\n- [monitoring-latency](rules\u002Fmonitoring-latency.md) - Monitor P99 latency\n- [monitoring-throttling](rules\u002Fmonitoring-throttling.md) - Alert on throttling\n- [monitoring-azure-monitor](rules\u002Fmonitoring-azure-monitor.md) - Integrate Azure Monitor\n- [monitoring-diagnostic-logs](rules\u002Fmonitoring-diagnostic-logs.md) - Enable diagnostic logging\n\n### 9. Design Patterns (HIGH)\n\n- [pattern-change-feed-materialized-views](rules\u002Fpattern-change-feed-materialized-views.md) - Use Change Feed for cross-partition query optimization\n- [pattern-efficient-ranking](rules\u002Fpattern-efficient-ranking.md) - Use count-based or cached approaches for efficient ranking\n- [pattern-service-layer-relationships](rules\u002Fpattern-service-layer-relationships.md) - Use a service layer to hydrate document references\n- [pattern-langgraph-multi-agent](rules\u002Fpattern-langgraph-multi-agent.md) - Use StateGraph with conditional edges for multi-agent routing\n- [pattern-langgraph-interrupt-human](rules\u002Fpattern-langgraph-interrupt-human.md) - Use LangGraph interrupt for human-in-the-loop confirmation flows\n- [pattern-langgraph-resume-checkpoint](rules\u002Fpattern-langgraph-resume-checkpoint.md) - Resume LangGraph from checkpoint after interrupt for multi-turn conversations\n- [pattern-langgraph-agent-routing-cosmosdb](rules\u002Fpattern-langgraph-agent-routing-cosmosdb.md) - Persist active agent in Cosmos DB for deterministic routing via point reads\n- [pattern-langgraph-fastapi-startup](rules\u002Fpattern-langgraph-fastapi-startup.md) - Initialize LangGraph agents in FastAPI startup with retry logic\n- [pattern-langgraph-chat-history-separate](rules\u002Fpattern-langgraph-chat-history-separate.md) - Store chat history in a dedicated container, not the checkpointer\n- [pattern-background-task-writes](rules\u002Fpattern-background-task-writes.md) - Use FastAPI background tasks for non-blocking chat history writes\n- [pattern-langgraph-async-cosmos-routing](rules\u002Fpattern-langgraph-async-cosmos-routing.md) - Wrap Cosmos DB sync calls in asyncio.to_thread for LangGraph routing functions\n- [pattern-langgraph-async-cosmos-writes](rules\u002Fpattern-langgraph-async-cosmos-writes.md) - Use asyncio.to_thread for active agent writes in async node functions\n- [pattern-langgraph-agent-name-attribution](rules\u002Fpattern-langgraph-agent-name-attribution.md) - Tag AI messages with agent name for API response attribution\n- [pattern-ai-grounding-access](rules\u002Fpattern-ai-grounding-access.md) - Use point reads for AI grounding when the item id and partition key are known\n\n### 10. Developer Tooling (MEDIUM)\n\n- [tooling-vscode-extension](rules\u002Ftooling-vscode-extension.md) - Use the VS Code extension for routine inspection and management\n- [tooling-emulator-setup](rules\u002Ftooling-emulator-setup.md) - Use the Emulator for local development and testing\n- [tooling-emulator-fidelity](rules\u002Ftooling-emulator-fidelity.md) - Distinguish emulator configuration and data checks from Azure runtime parity\n- [tooling-cosmosdb-shell-target](rules\u002Ftooling-cosmosdb-shell-target.md) - Verify the Cosmos DB Shell account and target before reading data\n- [tooling-cosmosdb-shell-writes](rules\u002Ftooling-cosmosdb-shell-writes.md) - Scope, preview, and confirm Cosmos DB Shell writes and deletions\n- [tooling-cosmosdb-shell-setup](rules\u002Ftooling-cosmosdb-shell-setup.md) - Diagnose Cosmos DB Shell MCP problems without changing the user's environment\n\n### 11. Vector Search (HIGH)\n\n- [vector-enable-feature](rules\u002Fvector-enable-feature.md) - Enable vector search on the account before using vector features\n- [vector-embedding-policy](rules\u002Fvector-embedding-policy.md) - Define vector embedding policy for vector properties\n- [vector-index-type](rules\u002Fvector-index-type.md) - Configure vector indexes in the indexing policy\n- [vector-normalize-embeddings](rules\u002Fvector-normalize-embeddings.md) - Normalize embeddings for cosine similarity\n- [vector-distance-query](rules\u002Fvector-distance-query.md) - Use VectorDistance for similarity search\n- [vector-repository-pattern](rules\u002Fvector-repository-pattern.md) - Implement a repository pattern for vector search\n\n### 12. Full-Text Search (HIGH)\n\n- [fts-enable-capability](rules\u002Ffts-enable-capability.md) - Enable `EnableNoSQLFullTextSearch` capability on the account — prerequisite for all FTS functions\n- [fts-full-text-policy](rules\u002Ffts-define-policy.md) - Define `fullTextPolicy` on the container with correct language code (`en-US`, case-sensitive)\n- [fts-index-policy](rules\u002Ffts-add-index.md) - Add `fullTextIndexes` entry in the indexing policy to build the inverted index\n- [fts-contains-query](rules\u002Ffts-keyword-matching.md) - Use `FullTextContains` \u002F `FullTextContainsAll` \u002F `FullTextContainsAny` instead of `CONTAINS(LOWER(...))`\n- [fts-score-ranking](rules\u002Ffts-relevance-ranking.md) - Use `ORDER BY RANK FullTextScore(path, term)` for BM25 relevance ranking\n- [fts-hybrid-query](rules\u002Ffts-hybrid-queries.md) - Combine FTS predicates with selective indexed equality\u002Frange filters; predicate text order does not control execution\n\n### 13. Security (HIGH)\n\n- [security-continuous-backup](rules\u002Fsecurity-continuous-backup.md) - Enable continuous backup for point-in-time recovery\n- [security-disable-local-auth](rules\u002Fsecurity-disable-local-auth.md) - Disable shared-key authentication after migrating clients to Entra ID\n- [security-managed-identity](rules\u002Fsecurity-managed-identity.md) - Use managed identity and DefaultAzureCredential instead of stored keys\n- [security-network-restrict](rules\u002Fsecurity-network-restrict.md) - Restrict public access and prefer private endpoints for production\n- [security-private-endpoint-dns](rules\u002Fsecurity-private-endpoint-dns.md) - Configure private DNS records and VNet links while retaining the account hostname\n- [security-rbac-least-privilege](rules\u002Fsecurity-rbac-least-privilege.md) - Assign narrowly scoped Cosmos DB data-plane roles\n\n## How to Use\n\nUse the linked rule files above for detailed explanations and code examples. The links give the agent direct paths to the relevant guidance instead of relying on folder scanning or inferred filenames.\n\nEach rule file contains:\n- Brief explanation of why it matters\n- Incorrect code example with explanation\n- Correct code example with explanation\n- Additional context and references\n","# Azure Cosmos DB Best Practices\n\nComprehensive performance optimization guide for Azure Cosmos DB applications, containing 100+ rules across 13 categories, prioritized by impact to guide automated refactoring and code generation.\n\nBefore answering, read the linked rule files relevant to the user's question.\nThe quick reference below is an index, not the full guidance: SDK APIs, limits,\nconfiguration prerequisites, and caveats live in the rule bodies. Use the\nlanguage-specific integration rule when one exists rather than substituting a\ngeneric pattern. Keep answers concise, but include the constraints that make the\nrecommendation correct for the user's scenario.\n\n## When to Apply\n\nReference these guidelines when:\n- Designing data models for Cosmos DB\n- Choosing partition keys\n- Writing or optimizing queries\n- Implementing SDK patterns\n- Using the Cosmos DB Emulator for local development\n- Inspecting or managing Cosmos DB data with developer tooling\n- Implementing vector search or RAG features on Cosmos DB\n- Reviewing code for performance issues\n- Configuring throughput and scaling\n- Building globally distributed applications\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | Data Modeling | CRITICAL | `model-` |\n| 2 | Partition Key Design | CRITICAL | `partition-` |\n| 3 | Query Optimization | HIGH | `query-` |\n| 4 | SDK Best Practices | HIGH | `sdk-` |\n| 5 | Indexing Strategies | MEDIUM-HIGH | `index-` |\n| 6 | Throughput & Scaling | MEDIUM | `throughput-` |\n| 7 | Global Distribution | MEDIUM | `global-` |\n| 8 | Monitoring & Diagnostics | LOW-MEDIUM | `monitoring-` |\n| 9 | Design Patterns | HIGH | `pattern-` |\n| 10 | Developer Tooling | MEDIUM | `tooling-` |\n| 11 | Vector Search | HIGH | `vector-` |\n| 12 | Full-Text Search | HIGH | `fts-` |\n| 13 | Security | HIGH | `security-` |\n\n## Quick Reference\n\n### 1. Data Modeling (CRITICAL)\n\n- [model-embed-related](rules\u002Fmodel-embed-related.md) - Embed related data retrieved together\n- [model-reference-large](rules\u002Fmodel-reference-large.md) - Reference data when items get too large\n- [model-avoid-2mb-limit](rules\u002Fmodel-avoid-2mb-limit.md) - Keep items well under 2MB limit\n- [model-id-constraints](rules\u002Fmodel-id-constraints.md) - Follow ID value length and character constraints\n- [model-unique-keys](rules\u002Fmodel-unique-keys.md) - Enforce business-key uniqueness within the correct logical partition scope\n- [model-nesting-depth](rules\u002Fmodel-nesting-depth.md) - Stay within 128-level nesting depth limit\n- [model-numeric-precision](rules\u002Fmodel-numeric-precision.md) - Understand IEEE 754 numeric precision limits\n- [model-denormalize-reads](rules\u002Fmodel-denormalize-reads.md) - Denormalize for read-heavy workloads including pre-computed aggregates\n- [model-schema-versioning](rules\u002Fmodel-schema-versioning.md) - Version your document schemas\n- [model-type-discriminator](rules\u002Fmodel-type-discriminator.md) - Use type discriminators for polymorphic data\n- [model-json-serialization](rules\u002Fmodel-json-serialization.md) - Handle JSON serialization correctly for Cosmos DB documents\n- [model-relationship-references](rules\u002Fmodel-relationship-references.md) - Use ID references with transient hydration for document relationships\n- [model-ttl-expiration](rules\u002Fmodel-ttl-expiration.md) - Configure TTL relative to the item's last update, with container defaults and item overrides\n\n### 2. Partition Key Design (CRITICAL)\n\n- [partition-high-cardinality](rules\u002Fpartition-high-cardinality.md) - Choose high-cardinality partition keys\n- [partition-avoid-hotspots](rules\u002Fpartition-avoid-hotspots.md) - Distribute writes evenly\n- [partition-hierarchical](rules\u002Fpartition-hierarchical.md) - Use hierarchical partition keys for flexibility; order levels broad→narrow\n- [partition-query-patterns](rules\u002Fpartition-query-patterns.md) - Align partition key with query patterns\n- [partition-synthetic-keys](rules\u002Fpartition-synthetic-keys.md) - Create synthetic keys when needed\n- [partition-key-length](rules\u002Fpartition-key-length.md) - Respect partition key value length limits\n- [partition-immutable-key](rules\u002Fpartition-immutable-key.md) - Choose immutable properties as partition keys\n- [partition-20gb-limit](rules\u002Fpartition-20gb-limit.md) - Plan for 20GB logical partition limit\n- [partition-rekey-migration](rules\u002Fpartition-rekey-migration.md) - Re-key a misaligned container with the Change partition key feature\n\n### 3. Query Optimization (HIGH)\n\n- [query-aggregate-single-pass](rules\u002Fquery-aggregate-single-pass.md) - Compute min\u002Fmax\u002Favg with one scoped aggregate query\n- [query-avoid-cross-partition](rules\u002Fquery-avoid-cross-partition.md) - Minimize cross-partition queries\n- [query-use-projections](rules\u002Fquery-use-projections.md) - Project only needed fields; prefer dedicated result types for projections\n- [query-pagination](rules\u002Fquery-pagination.md) - Use continuation tokens for pagination\n- [query-avoid-scans](rules\u002Fquery-avoid-scans.md) - Avoid full container scans\n- [query-parameterize](rules\u002Fquery-parameterize.md) - Use parameterized queries\n- [query-order-filters](rules\u002Fquery-order-filters.md) - Let the query engine order filters; tune indexed predicates rather than their textual order\n- [query-top-literal](rules\u002Fquery-top-literal.md) - Use literal integers for TOP, never parameters\n- [query-latest-by-timestamp](rules\u002Fquery-latest-by-timestamp.md) - Query \"latest\" documents with explicit ORDER BY and TOP 1\n- [query-olap-detection](rules\u002Fquery-olap-detection.md) - Detect and redirect analytical queries away from transactional containers\n- [query-point-reads](rules\u002Fquery-point-reads.md) - Use point reads (ReadItem) instead of queries when id and partition key are known\n- [query-distinct-keyword](rules\u002Fquery-distinct-keyword.md) - Return unique values with DISTINCT instead of client-side deduplication\n\n### 4. SDK Best Practices (HIGH)\n\n- [sdk-singleton-client](rules\u002Fsdk-singleton-client.md) - Reuse CosmosClient as singleton\n- [sdk-async-api](rules\u002Fsdk-async-api.md) - Use async APIs for throughput\n- [sdk-retry-429](rules\u002Fsdk-retry-429.md) - Handle 429s with retry-after\n- [sdk-connection-mode](rules\u002Fsdk-connection-mode.md) - Use Direct mode for production\n- [sdk-preferred-regions](rules\u002Fsdk-preferred-regions.md) - Configure preferred regions\n- [sdk-excluded-regions](rules\u002Fsdk-excluded-regions.md) - Exclude regions experiencing issues\n- [sdk-availability-strategy](rules\u002Fsdk-availability-strategy.md) - Configure availability strategy for resilience\n- [sdk-circuit-breaker](rules\u002Fsdk-circuit-breaker.md) - Use circuit breaker for fault tolerance\n- [sdk-diagnostics](rules\u002Fsdk-diagnostics.md) - Log diagnostics for troubleshooting\n- [sdk-serialization-enums](rules\u002Fsdk-serialization-enums.md) - Serialize enums as strings not integers\n- [sdk-emulator-ssl](rules\u002Fsdk-emulator-ssl.md) - Configure SSL and connection mode for Cosmos DB Emulator\n- [sdk-ifnonematch-create](rules\u002Fsdk-conditional-create-etag.md) - Use `setIfNoneMatchETag(\"*\")` on `createItem` to reject duplicates atomically (409 on conflict)\n- [sdk-no-shared-request-options](rules\u002Fsdk-request-options-per-call.md) - Use separate `CosmosItemRequestOptions` instances for deferred or concurrent `createItem` operations to avoid shared-state partition-key overrides\n- [sdk-patch-incr](rules\u002Fsdk-patch-counter-increment.md) - Use `CosmosPatchOperations.increment()` for atomic counter increments — no read RU, no ETag conflict cycle\n- [sdk-bypage-empty-token](rules\u002Fsdk-continuation-token-null-guard.md) - Guard against empty-string continuation tokens before calling `byPage()` — pass `null` for first page, never `\"\"`\n- [sdk-etag-concurrency](rules\u002Fsdk-etag-concurrency.md) - Use ETags for optimistic concurrency on read-modify-write operations\n- [sdk-java-content-response](rules\u002Fsdk-java-content-response.md) - Enable content response on write operations (Java)\n- [sdk-java-cosmos-config](rules\u002Fsdk-java-cosmos-config.md) - Configure Cosmos DB initialization correctly in Spring Boot\n- [sdk-java-spring-boot-versions](rules\u002Fsdk-java-spring-boot-versions.md) - Match Java version to Spring Boot requirements\n- [sdk-local-dev-config](rules\u002Fsdk-local-dev-config.md) - Configure local development to avoid cloud conflicts\n- [sdk-dotnet-cosmos-package-id](rules\u002Fsdk-dotnet-cosmos-package-id.md) - Use `Microsoft.Azure.Cosmos`, not the abandoned `Azure.Cosmos` v4-preview package\n- [sdk-newtonsoft-dependency](rules\u002Fsdk-newtonsoft-dependency.md) - Explicitly reference Newtonsoft.Json package\n- [sdk-python-async-deps](rules\u002Fsdk-python-async-deps.md) - Include aiohttp when using Python async SDK\n- [sdk-spring-data-annotations](rules\u002Fsdk-spring-data-annotations.md) - Annotate entities for Spring Data Cosmos\n- [sdk-spring-data-repository](rules\u002Fsdk-spring-data-repository.md) - Use CosmosRepository correctly and handle Iterable return types\n- [sdk-langchain-cosmosdb-saver](rules\u002Fsdk-langchain-cosmosdb-saver.md) - Use CosmosDBSaver for LangGraph checkpointing with async container client\n- [sdk-langchain-async-checkpointer](rules\u002Fsdk-langchain-async-checkpointer.md) - Initialize async Cosmos DB container in startup routine, not module level\n- [sdk-langchain-mcp-persistent-session](rules\u002Fsdk-langchain-mcp-persistent-session.md) - Maintain persistent MCP client sessions for application lifetime\n- [sdk-langchain-mcp-tool-content-format](rules\u002Fsdk-langchain-mcp-tool-content-format.md) - Handle both string and list formats in MCP ToolMessage content\n- [sdk-langgraph-mcp-tool-filtering](rules\u002Fsdk-langgraph-mcp-tool-filtering.md) - Filter MCP tools by name prefix for per-agent assignment\n- [sdk-dotnet-namespace-collision](rules\u002Fsdk-dotnet-namespace-collision.md) - Avoid `Microsoft.Azure.Cosmos` namespace collisions with domain models (User, Database, Container, etc.)\n- [sdk-ingestion-rate-control](rules\u002Fsdk-ingestion-rate-control.md) - Rate-control high-volume ingestion (concurrency, retry-after, throughput control)\n- [sdk-go-partition-key-metadata](rules\u002Fsdk-go-partition-key-metadata.md) - Upgrade stale Go SDKs to serialize partition-key kind metadata correctly across SDKs\n- [sdk-python-client-kwargs](rules\u002Fsdk-python-client-kwargs.md) - Configure Python v4 clients with flat keyword arguments instead of legacy ConnectionPolicy objects\n- [sdk-langchain-js-chat-history](rules\u002Fsdk-langchain-js-chat-history.md) - Persist isolated JS\u002FTS conversations with AzureCosmosDBNoSQLChatMessageHistory\n- [sdk-langchain-js-embedding-model](rules\u002Fsdk-langchain-js-embedding-model.md) - Configure the Azure OpenAI deployment name for JS\u002FTS embeddings\n- [sdk-langchain-js-filter-injection](rules\u002Fsdk-langchain-js-filter-injection.md) - Bind vector-store filter values through a parameterized filterClause\n- [sdk-langchain-js-fulltext-prerequisites](rules\u002Fsdk-langchain-js-fulltext-prerequisites.md) - Configure account capability, text policy, and indexes before hybrid search\n- [sdk-langchain-js-managed-identity](rules\u002Fsdk-langchain-js-managed-identity.md) - Authenticate JS\u002FTS LangChain with managed identity and data-plane RBAC\n- [sdk-langchain-js-search-types](rules\u002Fsdk-langchain-js-search-types.md) - Choose vector, full-text, or hybrid retrieval for the query\n- [sdk-langchain-js-semantic-cache](rules\u002Fsdk-langchain-js-semantic-cache.md) - Reuse equivalent LLM responses with AzureCosmosDBNoSQLSemanticCache\n- [sdk-langchain-js-vectorstore-init](rules\u002Fsdk-langchain-js-vectorstore-init.md) - Initialize JS\u002FTS vector stores with embeddings and pre-provisioned RBAC resources\n\n### 5. Indexing Strategies (MEDIUM-HIGH)\n\n- [index-exclude-unused](rules\u002Findex-exclude-unused.md) - Exclude paths never queried\n- [index-path-syntax](rules\u002Findex-path-syntax.md) - Use correct path notation (`\u002F?`, `\u002F[]`, `\u002F*`)\n- [index-composite](rules\u002Findex-composite.md) - Use composite indexes for ORDER BY\n- [index-composite-direction](rules\u002Findex-composite-direction.md) - Match composite index directions to ORDER BY\n- [index-spatial](rules\u002Findex-spatial.md) - Add spatial indexes for geo queries\n- [index-range-vs-hash](rules\u002Findex-range-vs-hash.md) - Choose appropriate index types\n- [index-lazy-consistent](rules\u002Findex-lazy-consistent.md) - Understand indexing modes\n\n### 6. Throughput & Scaling (MEDIUM)\n\n- [throughput-autoscale](rules\u002Fthroughput-autoscale.md) - Use autoscale for variable workloads\n- [throughput-right-size](rules\u002Fthroughput-right-size.md) - Right-size provisioned throughput\n- [throughput-serverless](rules\u002Fthroughput-serverless.md) - Consider serverless for dev\u002Ftest\n- [throughput-burst](rules\u002Fthroughput-burst.md) - Understand burst capacity\n- [throughput-container-vs-database](rules\u002Fthroughput-container-vs-database.md) - Choose allocation level wisely\n- [throughput-idle-container-review](rules\u002Fthroughput-idle-container-review.md) - Review idle containers for lifecycle action\n- [throughput-ttl-stale-data](rules\u002Fthroughput-ttl-stale-data.md) - Expire stale data with TTL before hitting storage limits\n- [throughput-serverless-migration](rules\u002Fthroughput-serverless-migration.md) - Migrate a low-traffic provisioned account to serverless\n\n### 7. Global Distribution (MEDIUM)\n\n- [global-multi-region](rules\u002Fglobal-multi-region.md) - Configure multi-region writes\n- [global-consistency](rules\u002Fglobal-consistency.md) - Choose appropriate consistency level\n- [global-conflict-resolution](rules\u002Fglobal-conflict-resolution.md) - Implement conflict resolution\n- [global-failover](rules\u002Fglobal-failover.md) - Configure automatic failover\n- [global-read-regions](rules\u002Fglobal-read-regions.md) - Add read regions near users\n- [global-zone-redundancy](rules\u002Fglobal-zone-redundancy.md) - Enable zone redundancy for HA\n- [global-multi-region-write-antipattern](rules\u002Fglobal-multi-region-write-antipattern.md) - Avoid multi-region writes without an active-active need\n\n### 8. Monitoring & Diagnostics (LOW-MEDIUM)\n\n- [monitoring-ru-consumption](rules\u002Fmonitoring-ru-consumption.md) - Track RU consumption\n- [monitoring-latency](rules\u002Fmonitoring-latency.md) - Monitor P99 latency\n- [monitoring-throttling](rules\u002Fmonitoring-throttling.md) - Alert on throttling\n- [monitoring-azure-monitor](rules\u002Fmonitoring-azure-monitor.md) - Integrate Azure Monitor\n- [monitoring-diagnostic-logs](rules\u002Fmonitoring-diagnostic-logs.md) - Enable diagnostic logging\n\n### 9. Design Patterns (HIGH)\n\n- [pattern-change-feed-materialized-views](rules\u002Fpattern-change-feed-materialized-views.md) - Use Change Feed for cross-partition query optimization\n- [pattern-efficient-ranking](rules\u002Fpattern-efficient-ranking.md) - Use count-based or cached approaches for efficient ranking\n- [pattern-service-layer-relationships](rules\u002Fpattern-service-layer-relationships.md) - Use a service layer to hydrate document references\n- [pattern-langgraph-multi-agent](rules\u002Fpattern-langgraph-multi-agent.md) - Use StateGraph with conditional edges for multi-agent routing\n- [pattern-langgraph-interrupt-human](rules\u002Fpattern-langgraph-interrupt-human.md) - Use LangGraph interrupt for human-in-the-loop confirmation flows\n- [pattern-langgraph-resume-checkpoint](rules\u002Fpattern-langgraph-resume-checkpoint.md) - Resume LangGraph from checkpoint after interrupt for multi-turn conversations\n- [pattern-langgraph-agent-routing-cosmosdb](rules\u002Fpattern-langgraph-agent-routing-cosmosdb.md) - Persist active agent in Cosmos DB for deterministic routing via point reads\n- [pattern-langgraph-fastapi-startup](rules\u002Fpattern-langgraph-fastapi-startup.md) - Initialize LangGraph agents in FastAPI startup with retry logic\n- [pattern-langgraph-chat-history-separate](rules\u002Fpattern-langgraph-chat-history-separate.md) - Store chat history in a dedicated container, not the checkpointer\n- [pattern-background-task-writes](rules\u002Fpattern-background-task-writes.md) - Use FastAPI background tasks for non-blocking chat history writes\n- [pattern-langgraph-async-cosmos-routing](rules\u002Fpattern-langgraph-async-cosmos-routing.md) - Wrap Cosmos DB sync calls in asyncio.to_thread for LangGraph routing functions\n- [pattern-langgraph-async-cosmos-writes](rules\u002Fpattern-langgraph-async-cosmos-writes.md) - Use asyncio.to_thread for active agent writes in async node functions\n- [pattern-langgraph-agent-name-attribution](rules\u002Fpattern-langgraph-agent-name-attribution.md) - Tag AI messages with agent name for API response attribution\n- [pattern-ai-grounding-access](rules\u002Fpattern-ai-grounding-access.md) - Use point reads for AI grounding when the item id and partition key are known\n\n### 10. Developer Tooling (MEDIUM)\n\n- [tooling-vscode-extension](rules\u002Ftooling-vscode-extension.md) - Use the VS Code extension for routine inspection and management\n- [tooling-emulator-setup](rules\u002Ftooling-emulator-setup.md) - Use the Emulator for local development and testing\n- [tooling-emulator-fidelity](rules\u002Ftooling-emulator-fidelity.md) - Distinguish emulator configuration and data checks from Azure runtime parity\n- [tooling-cosmosdb-shell-target](rules\u002Ftooling-cosmosdb-shell-target.md) - Verify the Cosmos DB Shell account and target before reading data\n- [tooling-cosmosdb-shell-writes](rules\u002Ftooling-cosmosdb-shell-writes.md) - Scope, preview, and confirm Cosmos DB Shell writes and deletions\n- [tooling-cosmosdb-shell-setup](rules\u002Ftooling-cosmosdb-shell-setup.md) - Diagnose Cosmos DB Shell MCP problems without changing the user's environment\n\n### 11. Vector Search (HIGH)\n\n- [vector-enable-feature](rules\u002Fvector-enable-feature.md) - Enable vector search on the account before using vector features\n- [vector-embedding-policy](rules\u002Fvector-embedding-policy.md) - Define vector embedding policy for vector properties\n- [vector-index-type](rules\u002Fvector-index-type.md) - Configure vector indexes in the indexing policy\n- [vector-normalize-embeddings](rules\u002Fvector-normalize-embeddings.md) - Normalize embeddings for cosine similarity\n- [vector-distance-query](rules\u002Fvector-distance-query.md) - Use VectorDistance for similarity search\n- [vector-repository-pattern](rules\u002Fvector-repository-pattern.md) - Implement a repository pattern for vector search\n\n### 12. Full-Text Search (HIGH)\n\n- [fts-enable-capability](rules\u002Ffts-enable-capability.md) - Enable `EnableNoSQLFullTextSearch` capability on the account — prerequisite for all FTS functions\n- [fts-full-text-policy](rules\u002Ffts-define-policy.md) - Define `fullTextPolicy` on the container with correct language code (`en-US`, case-sensitive)\n- [fts-index-policy](rules\u002Ffts-add-index.md) - Add `fullTextIndexes` entry in the indexing policy to build the inverted index\n- [fts-contains-query](rules\u002Ffts-keyword-matching.md) - Use `FullTextContains` \u002F `FullTextContainsAll` \u002F `FullTextContainsAny` instead of `CONTAINS(LOWER(...))`\n- [fts-score-ranking](rules\u002Ffts-relevance-ranking.md) - Use `ORDER BY RANK FullTextScore(path, term)` for BM25 relevance ranking\n- [fts-hybrid-query](rules\u002Ffts-hybrid-queries.md) - Combine FTS predicates with selective indexed equality\u002Frange filters; predicate text order does not control execution\n\n### 13. Security (HIGH)\n\n- [security-continuous-backup](rules\u002Fsecurity-continuous-backup.md) - Enable continuous backup for point-in-time recovery\n- [security-disable-local-auth](rules\u002Fsecurity-disable-local-auth.md) - Disable shared-key authentication after migrating clients to Entra ID\n- [security-managed-identity](rules\u002Fsecurity-managed-identity.md) - Use managed identity and DefaultAzureCredential instead of stored keys\n- [security-network-restrict](rules\u002Fsecurity-network-restrict.md) - Restrict public access and prefer private endpoints for production\n- [security-private-endpoint-dns](rules\u002Fsecurity-private-endpoint-dns.md) - Configure private DNS records and VNet links while retaining the account hostname\n- [security-rbac-least-privilege](rules\u002Fsecurity-rbac-least-privilege.md) - Assign narrowly scoped Cosmos DB data-plane roles\n\n## How to Use\n\nUse the linked rule files above for detailed explanations and code examples. The links give the agent direct paths to the relevant guidance instead of relying on folder scanning or inferred filenames.\n\nEach rule file contains:\n- Brief explanation of why it matters\n- Incorrect code example with explanation\n- Correct code example with explanation\n- Additional context and references\n",{"name":5,"license":15,"metadata":60,"description":63},{"author":61,"version":62},"cosmosdb-agent-kit","1.0.0","Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,\npartitioning, queries, and SDK usage. Use when writing, reviewing, or refactoring\ncode that interacts with Azure Cosmos DB, designing data models, optimizing queries,\nor implementing high-performance database operations.\nUSE FOR: Cosmos DB NoSQL, partition key design, RU optimization, point reads,\ncross-partition queries, SDK singleton, CosmosClient, container modeling,\nchange feed, bulk operations, vector search, full-text search, hierarchical\npartition keys, global distribution, autoscale throughput, indexing policy,\nDO NOT USE FOR: PostgreSQL, MySQL, MongoDB (non-Azure), DynamoDB, Cassandra,\nAzure SQL, Cosmos DB for PostgreSQL (vCore), Cosmos DB for MongoDB vCore, Azure DocumentDB,\ngeneral SQL databases, Redis, Elasticsearch.\n","main","4d0ccf8e835f0cbf4788732ff7a42930e4b7c6d8","skills\u002Fcosmosdb-best-practices",89,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb","https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=ms-azuretools.vscode-cosmosdb","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-13 02:36:29",{"source":8,"skillName":5,"commands":75,"prompt":85,"zipAvailable":86},[76,79,82],{"tool":77,"command":78},"npx","npx skills add microsoft\u002Fvscode-cosmosdb --skill cosmosdb-best-practices",{"tool":80,"command":81},"bunx","bunx skills add microsoft\u002Fvscode-cosmosdb --skill cosmosdb-best-practices",{"tool":83,"command":84},"pnpm","pnpm dlx skills add microsoft\u002Fvscode-cosmosdb --skill cosmosdb-best-practices","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002FSKILL.md",true,[88,94,98,102,106,110,114,118,122,126,130,134,138,142,146,150,154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,245,249,253,257,261,264,268,272,276,280,284,288,292,296,300,304,308,312,316,320,324,328,332,336,340,344,348,352,356,360,364,368,372,376,380,384,388,392,396,400,404,408,412,416,420,424,428,432,436,440,444,448,452,456,460,464,468,472,476,480,484,488,492,496,500,504,508,512,516,520,524,528,532,536,540,544,548,552,556,560,564,568,572,576,580,584,588,592,596,600,604,608,612,616,620,624,628,632,636,640,644,648],{"path":89,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":92,"sourceHtmlUrl":93},"rules\u002Ffts-add-index.md","REFERENCE","参考文档",1976,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ffts-add-index.md",{"path":95,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":96,"sourceHtmlUrl":97},"rules\u002Ffts-define-policy.md",1707,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ffts-define-policy.md",{"path":99,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":100,"sourceHtmlUrl":101},"rules\u002Ffts-enable-capability.md",1636,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ffts-enable-capability.md",{"path":103,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":104,"sourceHtmlUrl":105},"rules\u002Ffts-hybrid-queries.md",2327,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ffts-hybrid-queries.md",{"path":107,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":108,"sourceHtmlUrl":109},"rules\u002Ffts-keyword-matching.md",2209,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ffts-keyword-matching.md",{"path":111,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":112,"sourceHtmlUrl":113},"rules\u002Ffts-relevance-ranking.md",1459,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ffts-relevance-ranking.md",{"path":115,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":116,"sourceHtmlUrl":117},"rules\u002Fglobal-conflict-resolution.md",4087,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-conflict-resolution.md",{"path":119,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":120,"sourceHtmlUrl":121},"rules\u002Fglobal-consistency.md",3962,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-consistency.md",{"path":123,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":124,"sourceHtmlUrl":125},"rules\u002Fglobal-failover.md",3804,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-failover.md",{"path":127,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":128,"sourceHtmlUrl":129},"rules\u002Fglobal-multi-region-write-antipattern.md",2646,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-multi-region-write-antipattern.md",{"path":131,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":132,"sourceHtmlUrl":133},"rules\u002Fglobal-multi-region.md",3313,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-multi-region.md",{"path":135,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":136,"sourceHtmlUrl":137},"rules\u002Fglobal-read-regions.md",3994,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-read-regions.md",{"path":139,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":140,"sourceHtmlUrl":141},"rules\u002Fglobal-zone-redundancy.md",3576,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fglobal-zone-redundancy.md",{"path":143,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":144,"sourceHtmlUrl":145},"rules\u002Findex-composite-direction.md",2892,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-composite-direction.md",{"path":147,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":148,"sourceHtmlUrl":149},"rules\u002Findex-composite.md",11955,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-composite.md",{"path":151,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":152,"sourceHtmlUrl":153},"rules\u002Findex-exclude-unused.md",4046,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-exclude-unused.md",{"path":155,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":156,"sourceHtmlUrl":157},"rules\u002Findex-lazy-consistent.md",3363,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-lazy-consistent.md",{"path":159,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":160,"sourceHtmlUrl":161},"rules\u002Findex-path-syntax.md",2545,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-path-syntax.md",{"path":163,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":164,"sourceHtmlUrl":165},"rules\u002Findex-range-vs-hash.md",3956,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-range-vs-hash.md",{"path":167,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":168,"sourceHtmlUrl":169},"rules\u002Findex-spatial.md",3193,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Findex-spatial.md",{"path":171,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":172,"sourceHtmlUrl":173},"rules\u002Fmodel-avoid-2mb-limit.md",2096,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-avoid-2mb-limit.md",{"path":175,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":176,"sourceHtmlUrl":177},"rules\u002Fmodel-denormalize-reads.md",12537,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-denormalize-reads.md",{"path":179,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":180,"sourceHtmlUrl":181},"rules\u002Fmodel-embed-related.md",2528,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-embed-related.md",{"path":183,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":184,"sourceHtmlUrl":185},"rules\u002Fmodel-id-constraints.md",7581,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-id-constraints.md",{"path":187,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":188,"sourceHtmlUrl":189},"rules\u002Fmodel-json-serialization.md",6175,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-json-serialization.md",{"path":191,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":192,"sourceHtmlUrl":193},"rules\u002Fmodel-nesting-depth.md",3421,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-nesting-depth.md",{"path":195,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":196,"sourceHtmlUrl":197},"rules\u002Fmodel-numeric-precision.md",3324,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-numeric-precision.md",{"path":199,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":200,"sourceHtmlUrl":201},"rules\u002Fmodel-reference-large.md",2313,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-reference-large.md",{"path":203,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":204,"sourceHtmlUrl":205},"rules\u002Fmodel-relationship-references.md",3664,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-relationship-references.md",{"path":207,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":208,"sourceHtmlUrl":209},"rules\u002Fmodel-schema-versioning.md",2893,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-schema-versioning.md",{"path":211,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":212,"sourceHtmlUrl":213},"rules\u002Fmodel-ttl-expiration.md",3174,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-ttl-expiration.md",{"path":215,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":216,"sourceHtmlUrl":217},"rules\u002Fmodel-type-discriminator.md",3583,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-type-discriminator.md",{"path":219,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":220,"sourceHtmlUrl":221},"rules\u002Fmodel-unique-keys.md",5450,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmodel-unique-keys.md",{"path":223,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":224,"sourceHtmlUrl":225},"rules\u002Fmonitoring-azure-monitor.md",4531,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmonitoring-azure-monitor.md",{"path":227,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":228,"sourceHtmlUrl":229},"rules\u002Fmonitoring-diagnostic-logs.md",5204,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmonitoring-diagnostic-logs.md",{"path":231,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":232,"sourceHtmlUrl":233},"rules\u002Fmonitoring-latency.md",4303,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmonitoring-latency.md",{"path":235,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":236,"sourceHtmlUrl":237},"rules\u002Fmonitoring-ru-consumption.md",7632,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmonitoring-ru-consumption.md",{"path":239,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":240,"sourceHtmlUrl":241},"rules\u002Fmonitoring-throttling.md",4491,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fmonitoring-throttling.md",{"path":243,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":208,"sourceHtmlUrl":244},"rules\u002Fpartition-20gb-limit.md","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-20gb-limit.md",{"path":246,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":247,"sourceHtmlUrl":248},"rules\u002Fpartition-avoid-hotspots.md",3478,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-avoid-hotspots.md",{"path":250,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":251,"sourceHtmlUrl":252},"rules\u002Fpartition-hierarchical.md",5826,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-hierarchical.md",{"path":254,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":255,"sourceHtmlUrl":256},"rules\u002Fpartition-high-cardinality.md",2234,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-high-cardinality.md",{"path":258,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":259,"sourceHtmlUrl":260},"rules\u002Fpartition-immutable-key.md",1812,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-immutable-key.md",{"path":262,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":144,"sourceHtmlUrl":263},"rules\u002Fpartition-key-length.md","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-key-length.md",{"path":265,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":266,"sourceHtmlUrl":267},"rules\u002Fpartition-query-patterns.md",2747,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-query-patterns.md",{"path":269,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":270,"sourceHtmlUrl":271},"rules\u002Fpartition-rekey-migration.md",4470,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-rekey-migration.md",{"path":273,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":274,"sourceHtmlUrl":275},"rules\u002Fpartition-synthetic-keys.md",3914,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpartition-synthetic-keys.md",{"path":277,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":278,"sourceHtmlUrl":279},"rules\u002Fpattern-ai-grounding-access.md",4862,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-ai-grounding-access.md",{"path":281,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":282,"sourceHtmlUrl":283},"rules\u002Fpattern-background-task-writes.md",2907,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-background-task-writes.md",{"path":285,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":286,"sourceHtmlUrl":287},"rules\u002Fpattern-change-feed-materialized-views.md",11559,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-change-feed-materialized-views.md",{"path":289,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":290,"sourceHtmlUrl":291},"rules\u002Fpattern-efficient-ranking.md",6053,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-efficient-ranking.md",{"path":293,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":294,"sourceHtmlUrl":295},"rules\u002Fpattern-langgraph-agent-name-attribution.md",2239,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-agent-name-attribution.md",{"path":297,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":298,"sourceHtmlUrl":299},"rules\u002Fpattern-langgraph-agent-routing-cosmosdb.md",4690,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-agent-routing-cosmosdb.md",{"path":301,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":302,"sourceHtmlUrl":303},"rules\u002Fpattern-langgraph-async-cosmos-routing.md",3286,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-async-cosmos-routing.md",{"path":305,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":306,"sourceHtmlUrl":307},"rules\u002Fpattern-langgraph-async-cosmos-writes.md",2951,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-async-cosmos-writes.md",{"path":309,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":310,"sourceHtmlUrl":311},"rules\u002Fpattern-langgraph-chat-history-separate.md",3431,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-chat-history-separate.md",{"path":313,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":314,"sourceHtmlUrl":315},"rules\u002Fpattern-langgraph-fastapi-startup.md",3146,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-fastapi-startup.md",{"path":317,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":318,"sourceHtmlUrl":319},"rules\u002Fpattern-langgraph-interrupt-human.md",3745,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-interrupt-human.md",{"path":321,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":322,"sourceHtmlUrl":323},"rules\u002Fpattern-langgraph-multi-agent.md",4332,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-multi-agent.md",{"path":325,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":326,"sourceHtmlUrl":327},"rules\u002Fpattern-langgraph-resume-checkpoint.md",3213,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-langgraph-resume-checkpoint.md",{"path":329,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":330,"sourceHtmlUrl":331},"rules\u002Fpattern-service-layer-relationships.md",4878,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fpattern-service-layer-relationships.md",{"path":333,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":334,"sourceHtmlUrl":335},"rules\u002Fquery-aggregate-single-pass.md",2722,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-aggregate-single-pass.md",{"path":337,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":338,"sourceHtmlUrl":339},"rules\u002Fquery-avoid-cross-partition.md",4364,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-avoid-cross-partition.md",{"path":341,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":342,"sourceHtmlUrl":343},"rules\u002Fquery-avoid-scans.md",2569,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-avoid-scans.md",{"path":345,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":346,"sourceHtmlUrl":347},"rules\u002Fquery-distinct-keyword.md",2315,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-distinct-keyword.md",{"path":349,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":350,"sourceHtmlUrl":351},"rules\u002Fquery-latest-by-timestamp.md",2223,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-latest-by-timestamp.md",{"path":353,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":354,"sourceHtmlUrl":355},"rules\u002Fquery-olap-detection.md",5064,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-olap-detection.md",{"path":357,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":358,"sourceHtmlUrl":359},"rules\u002Fquery-order-filters.md",4810,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-order-filters.md",{"path":361,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":362,"sourceHtmlUrl":363},"rules\u002Fquery-pagination.md",7846,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-pagination.md",{"path":365,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":366,"sourceHtmlUrl":367},"rules\u002Fquery-parameterize.md",3833,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-parameterize.md",{"path":369,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":370,"sourceHtmlUrl":371},"rules\u002Fquery-point-reads.md",9916,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-point-reads.md",{"path":373,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":374,"sourceHtmlUrl":375},"rules\u002Fquery-top-literal.md",1928,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-top-literal.md",{"path":377,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":378,"sourceHtmlUrl":379},"rules\u002Fquery-use-projections.md",5660,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fquery-use-projections.md",{"path":381,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":382,"sourceHtmlUrl":383},"rules\u002Fsdk-async-api.md",3291,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-async-api.md",{"path":385,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":386,"sourceHtmlUrl":387},"rules\u002Fsdk-availability-strategy.md",5405,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-availability-strategy.md",{"path":389,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":390,"sourceHtmlUrl":391},"rules\u002Fsdk-circuit-breaker.md",8576,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-circuit-breaker.md",{"path":393,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":394,"sourceHtmlUrl":395},"rules\u002Fsdk-conditional-create-etag.md",2867,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-conditional-create-etag.md",{"path":397,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":398,"sourceHtmlUrl":399},"rules\u002Fsdk-connection-mode.md",2969,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-connection-mode.md",{"path":401,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":402,"sourceHtmlUrl":403},"rules\u002Fsdk-continuation-token-null-guard.md",3308,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-continuation-token-null-guard.md",{"path":405,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":406,"sourceHtmlUrl":407},"rules\u002Fsdk-diagnostics.md",6822,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-diagnostics.md",{"path":409,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":410,"sourceHtmlUrl":411},"rules\u002Fsdk-dotnet-cosmos-package-id.md",1844,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-dotnet-cosmos-package-id.md",{"path":413,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":414,"sourceHtmlUrl":415},"rules\u002Fsdk-dotnet-namespace-collision.md",2865,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-dotnet-namespace-collision.md",{"path":417,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":418,"sourceHtmlUrl":419},"rules\u002Fsdk-emulator-ssl.md",15631,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-emulator-ssl.md",{"path":421,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":422,"sourceHtmlUrl":423},"rules\u002Fsdk-etag-concurrency.md",9779,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-etag-concurrency.md",{"path":425,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":426,"sourceHtmlUrl":427},"rules\u002Fsdk-excluded-regions.md",4979,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-excluded-regions.md",{"path":429,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":430,"sourceHtmlUrl":431},"rules\u002Fsdk-go-partition-key-metadata.md",3061,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-go-partition-key-metadata.md",{"path":433,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":434,"sourceHtmlUrl":435},"rules\u002Fsdk-ingestion-rate-control.md",8892,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-ingestion-rate-control.md",{"path":437,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":438,"sourceHtmlUrl":439},"rules\u002Fsdk-java-content-response.md",8427,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-java-content-response.md",{"path":441,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":442,"sourceHtmlUrl":443},"rules\u002Fsdk-java-cosmos-config.md",10314,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-java-cosmos-config.md",{"path":445,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":446,"sourceHtmlUrl":447},"rules\u002Fsdk-java-spring-boot-versions.md",5047,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-java-spring-boot-versions.md",{"path":449,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":450,"sourceHtmlUrl":451},"rules\u002Fsdk-langchain-async-checkpointer.md",2882,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-async-checkpointer.md",{"path":453,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":454,"sourceHtmlUrl":455},"rules\u002Fsdk-langchain-cosmosdb-saver.md",2612,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-cosmosdb-saver.md",{"path":457,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":458,"sourceHtmlUrl":459},"rules\u002Fsdk-langchain-js-chat-history.md",3480,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-chat-history.md",{"path":461,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":462,"sourceHtmlUrl":463},"rules\u002Fsdk-langchain-js-embedding-model.md",2910,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-embedding-model.md",{"path":465,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":466,"sourceHtmlUrl":467},"rules\u002Fsdk-langchain-js-filter-injection.md",3973,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-filter-injection.md",{"path":469,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":470,"sourceHtmlUrl":471},"rules\u002Fsdk-langchain-js-fulltext-prerequisites.md",3840,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-fulltext-prerequisites.md",{"path":473,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":474,"sourceHtmlUrl":475},"rules\u002Fsdk-langchain-js-managed-identity.md",2787,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-managed-identity.md",{"path":477,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":478,"sourceHtmlUrl":479},"rules\u002Fsdk-langchain-js-search-types.md",2753,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-search-types.md",{"path":481,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":482,"sourceHtmlUrl":483},"rules\u002Fsdk-langchain-js-semantic-cache.md",3037,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-semantic-cache.md",{"path":485,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":486,"sourceHtmlUrl":487},"rules\u002Fsdk-langchain-js-vectorstore-init.md",2825,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-js-vectorstore-init.md",{"path":489,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":490,"sourceHtmlUrl":491},"rules\u002Fsdk-langchain-mcp-persistent-session.md",3508,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-mcp-persistent-session.md",{"path":493,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":494,"sourceHtmlUrl":495},"rules\u002Fsdk-langchain-mcp-tool-content-format.md",1982,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langchain-mcp-tool-content-format.md",{"path":497,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":498,"sourceHtmlUrl":499},"rules\u002Fsdk-langgraph-mcp-tool-filtering.md",2653,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-langgraph-mcp-tool-filtering.md",{"path":501,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":502,"sourceHtmlUrl":503},"rules\u002Fsdk-local-dev-config.md",5614,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-local-dev-config.md",{"path":505,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":506,"sourceHtmlUrl":507},"rules\u002Fsdk-newtonsoft-dependency.md",4486,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-newtonsoft-dependency.md",{"path":509,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":510,"sourceHtmlUrl":511},"rules\u002Fsdk-patch-counter-increment.md",3985,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-patch-counter-increment.md",{"path":513,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":514,"sourceHtmlUrl":515},"rules\u002Fsdk-preferred-regions.md",3229,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-preferred-regions.md",{"path":517,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":518,"sourceHtmlUrl":519},"rules\u002Fsdk-python-async-deps.md",1366,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-python-async-deps.md",{"path":521,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":522,"sourceHtmlUrl":523},"rules\u002Fsdk-python-client-kwargs.md",3494,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-python-client-kwargs.md",{"path":525,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":526,"sourceHtmlUrl":527},"rules\u002Fsdk-request-options-per-call.md",3982,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-request-options-per-call.md",{"path":529,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":530,"sourceHtmlUrl":531},"rules\u002Fsdk-retry-429.md",3786,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-retry-429.md",{"path":533,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":534,"sourceHtmlUrl":535},"rules\u002Fsdk-serialization-enums.md",4180,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-serialization-enums.md",{"path":537,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":538,"sourceHtmlUrl":539},"rules\u002Fsdk-singleton-client.md",6282,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-singleton-client.md",{"path":541,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":542,"sourceHtmlUrl":543},"rules\u002Fsdk-spring-data-annotations.md",4847,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-spring-data-annotations.md",{"path":545,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":546,"sourceHtmlUrl":547},"rules\u002Fsdk-spring-data-repository.md",3532,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsdk-spring-data-repository.md",{"path":549,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":550,"sourceHtmlUrl":551},"rules\u002Fsecurity-continuous-backup.md",2304,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsecurity-continuous-backup.md",{"path":553,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":554,"sourceHtmlUrl":555},"rules\u002Fsecurity-disable-local-auth.md",2294,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsecurity-disable-local-auth.md",{"path":557,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":558,"sourceHtmlUrl":559},"rules\u002Fsecurity-managed-identity.md",3387,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsecurity-managed-identity.md",{"path":561,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":562,"sourceHtmlUrl":563},"rules\u002Fsecurity-network-restrict.md",2197,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsecurity-network-restrict.md",{"path":565,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":566,"sourceHtmlUrl":567},"rules\u002Fsecurity-private-endpoint-dns.md",9533,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsecurity-private-endpoint-dns.md",{"path":569,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":570,"sourceHtmlUrl":571},"rules\u002Fsecurity-rbac-least-privilege.md",3154,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fsecurity-rbac-least-privilege.md",{"path":573,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":574,"sourceHtmlUrl":575},"rules\u002Fthroughput-autoscale.md",3753,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-autoscale.md",{"path":577,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":578,"sourceHtmlUrl":579},"rules\u002Fthroughput-burst.md",2737,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-burst.md",{"path":581,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":582,"sourceHtmlUrl":583},"rules\u002Fthroughput-container-vs-database.md",3432,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-container-vs-database.md",{"path":585,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":586,"sourceHtmlUrl":587},"rules\u002Fthroughput-idle-container-review.md",3202,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-idle-container-review.md",{"path":589,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":590,"sourceHtmlUrl":591},"rules\u002Fthroughput-right-size.md",3139,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-right-size.md",{"path":593,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":594,"sourceHtmlUrl":595},"rules\u002Fthroughput-serverless-migration.md",3106,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-serverless-migration.md",{"path":597,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":598,"sourceHtmlUrl":599},"rules\u002Fthroughput-serverless.md",2714,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-serverless.md",{"path":601,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":602,"sourceHtmlUrl":603},"rules\u002Fthroughput-ttl-stale-data.md",3040,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fthroughput-ttl-stale-data.md",{"path":605,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":606,"sourceHtmlUrl":607},"rules\u002Ftooling-cosmosdb-shell-setup.md",4783,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ftooling-cosmosdb-shell-setup.md",{"path":609,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":610,"sourceHtmlUrl":611},"rules\u002Ftooling-cosmosdb-shell-target.md",6011,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ftooling-cosmosdb-shell-target.md",{"path":613,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":614,"sourceHtmlUrl":615},"rules\u002Ftooling-cosmosdb-shell-writes.md",8461,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ftooling-cosmosdb-shell-writes.md",{"path":617,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":618,"sourceHtmlUrl":619},"rules\u002Ftooling-emulator-fidelity.md",3597,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ftooling-emulator-fidelity.md",{"path":621,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":622,"sourceHtmlUrl":623},"rules\u002Ftooling-emulator-setup.md",1743,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ftooling-emulator-setup.md",{"path":625,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":626,"sourceHtmlUrl":627},"rules\u002Ftooling-vscode-extension.md",1559,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Ftooling-vscode-extension.md",{"path":629,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":630,"sourceHtmlUrl":631},"rules\u002Fvector-distance-query.md",4892,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fvector-distance-query.md",{"path":633,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":634,"sourceHtmlUrl":635},"rules\u002Fvector-embedding-policy.md",3866,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fvector-embedding-policy.md",{"path":637,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":638,"sourceHtmlUrl":639},"rules\u002Fvector-enable-feature.md",3098,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fvector-enable-feature.md",{"path":641,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":642,"sourceHtmlUrl":643},"rules\u002Fvector-index-type.md",6926,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fvector-index-type.md",{"path":645,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":646,"sourceHtmlUrl":647},"rules\u002Fvector-normalize-embeddings.md",8779,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fvector-normalize-embeddings.md",{"path":649,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":650,"sourceHtmlUrl":651},"rules\u002Fvector-repository-pattern.md",13226,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-best-practices\u002Frules\u002Fvector-repository-pattern.md",[653,681,706,725,747,770],{"skillNo":654,"name":655,"nameZh":6,"description":656,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":657,"categories":658,"keywords":662,"publishedAt":55},"01M711DAKP4A0MGZ9GB677588E","cosmosdb-relational-migration","Orchestrate relational database migrations to Azure Cosmos DB for NoSQL from source\ndiscovery through schema conversion, provisioning, and application code migration.\nUse when asked to migrate an RDBMS application, run or resume a\n.cosmosdb-migration project, infer relational DDL from code or other artifacts when\nno DDL is available, verify whether the application language has a supported Cosmos DB\nSDK, execute one migration phase, or remember migration findings, decisions, or a\ngenerated Cosmos DB model for another application, or review migration blockers\nand propose fixes for approval. Requires the\ncosmosdb-best-practices peer Skill.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-relational-migration\u002FSKILL.md",[659],{"categoryNo":660,"categoryName":661,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[663,664,665,666,667,668,669,51,670,671,37,672,673,674,675,676,677,678,679,680],"cosmosdb relational migration","relational","migration","orchestrate","code migration","infer","model","project","generated","when","migrate","code","conversion","phase","review","run","database migrations","nosql",{"skillNo":682,"name":683,"nameZh":6,"description":684,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":685,"categories":686,"keywords":688,"publishedAt":55},"01M711D5WVTMXJ79CEWR7YWNW2","cosmosdb-nosql-query-generation","Generate, explain, edit, and fix Azure Cosmos DB for NoSQL (SQL API) queries. Use\nwhenever you need to produce a syntactically correct, safe Cosmos DB NoSQL query — for\nexample when the user asks to generate, write, edit, fix, or explain a Cosmos DB NoSQL\nquery. Provides the NoSQL dialect rules, safety rules, and few-shot examples. Covers\nSELECT\u002FVALUE\u002FDISTINCT\u002FTOP, array-unwind JOINs, subqueries, WHERE\u002FBETWEEN\u002FIN\u002FLIKE,\nGROUP BY and aggregates, ORDER BY and ORDER BY RANK, OFFSET\u002FLIMIT, the full built-in\nfunction reference, and how Cosmos DB NoSQL differs from T-SQL \u002F PostgreSQL \u002F MySQL.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-nosql-query-generation\u002FSKILL.md",[687],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[689,680,690,691,51,692,693,694,672,695,696,697,698,699,700,701,702,703,704,705],"query","cosmosdb nosql query generation","generation","select","aggregates","fix","you","api","mysql","postgresql","top","generate","how","sql","write","safe","edit",{"skillNo":707,"name":708,"nameZh":6,"description":709,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":710,"categories":711,"keywords":712,"publishedAt":55},"01M711D2B9HC4SG6TQ22F0DVM4","cosmosdb-nosql-query-editor","Drive the active Azure Cosmos DB for NoSQL Query Editor in VS Code from natural\nlanguage. Use whenever the user asks in natural language to show \u002F find \u002F list \u002F count \u002F\nfilter data \"in this container\", \"in my container\", or in the active Cosmos DB Query\nEditor (for example: \"show me all trucks in this container\", \"find active users\",\n\"count documents by type\"), or to generate, edit, or explain a query for the active\neditor. This skill orchestrates the VS Code Language Model tools that read editor\ncontext, sample the container schema, apply a query, and run it; it delegates all\nCosmos DB NoSQL query-language rules, syntax, functions, and examples to the\ncosmosdb-nosql-query-generation skill.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-nosql-query-editor\u002FSKILL.md",[],[689,680,713,714,715,669,51,716,717,674,718,719,720,721,700,722,678,723,705,724],"cosmosdb nosql query editor","editor","show","documents","show me","filter","db query","sample","me","active","read","syntax",{"skillNo":726,"name":727,"nameZh":6,"description":728,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":729,"categories":730,"keywords":732,"publishedAt":55},"01M711CZ4AKAN8XX4EJSTZSW1T","cosmosdb-data-model-recommendation","Recommend Azure Cosmos DB for NoSQL partition keys from container schemas, query\npatterns, write rates, cardinality, and growth estimates. Use for Data Modeler\nrecommendations or direct Chat requests to choose, compare, score, or explain\npartition keys, including hierarchical and synthetic keys. Reuses the\ncosmosdb-best-practices skill and prefers suitable scenario hints for unchanged defaults.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002Fskills\u002Fcosmosdb-data-model-recommendation\u002FSKILL.md",[731],{"categoryNo":32,"categoryName":33,"taxonomyType":29,"taxonomyTypeDesc":30},[669,733,734,735,736,737,51,49,738,689,739,740,703,741,742,680,743,744,745,746],"data","data model","recommendation","model recommendation","cosmosdb data model recommendation","choose","synthetic","recommendations","recommend","scenario","direct","patterns","for","cosmos",{"skillNo":748,"name":749,"nameZh":6,"description":750,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":751,"categories":752,"keywords":753,"publishedAt":55},"01M711CPFKVFSTFRXR0S5T4S59","telemetry-best-practices","Reviews and authors telemetry code in this extension. Use when adding, modifying, or reviewing any `callWithTelemetryAndErrorHandling` call, any `context.telemetry.properties`\u002F`measurements` assignment, or any helper that reports stats to telemetry. Ensures no PII\u002FEUII is emitted, that property vs. measurement usage is correct, and that event\u002Fproperty names are consistent.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Ftelemetry-best-practices\u002FSKILL.md",[],[754,36,755,756,757,672,674,758,759,760,761,762,763,764,765,766,767,768,769],"telemetry","telemetry best practices","reviews","pii","reports","context","measurement","usage","event","correct","call","use","helper","stats","properties","extension",{"skillNo":771,"name":772,"nameZh":6,"description":773,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":774,"categories":775,"keywords":777,"publishedAt":55},"01M711CK9HG0ZMGQGWN0ZNR70M","backport","Backport changes (current branch, a PR, a branch, or specific commits\u002FSHAs) onto a target branch (typically a release branch like `rel\u002F*`). Use when the user says \"backport this\", \"backport PR ...\", \"cherry-pick to \u003Cbranch>\", or asks to port commits to another branch. Handles stashing uncommitted work, branch creation, cherry-picking with conflict handling, pushing, and opening a PR.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-cosmosdb\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fbackport\u002FSKILL.md",[776],{"categoryNo":660,"categoryName":661,"taxonomyType":21,"taxonomyTypeDesc":22},[772,778,779,780,781,782,783,765,784,672,785,786,787,788,789,790,791],"branch","conflict","pr","creation","commits","pick","backport pr","with","port","work","changes","release","opening a pr","user"]