Menu

Not in the top 1,000 by GitHub stars

AzureCosmosDB/cosmosdb-agent-kit

A collection of skills for AI coding agents working with Azure Cosmos DB. Skills are packaged instructions and scripts that extend agent capabilities.

Claude CodeCodexGemini CLIGitHub CopilotEngineering

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/cosmosdb-best-practices/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 3ddc18fcd4d6

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 3ddc18fcd4d6fe0fae154f408395ff83c39495ee

git clone --filter=blob:none --no-checkout https://github.com/AzureCosmosDB/cosmosdb-agent-kit.git .hotskills/azurecosmosdb-cosmosdb-agent-kit && git -C .hotskills/azurecosmosdb-cosmosdb-agent-kit checkout --detach 3ddc18fcd4d6fe0fae154f408395ff83c39495ee # Copy each selected skill directory from .hotskills/azurecosmosdb-cosmosdb-agent-kit into .claude/skills/<skill-name>/
git clone --filter=blob:none --no-checkout https://github.com/AzureCosmosDB/cosmosdb-agent-kit.git .hotskills/azurecosmosdb-cosmosdb-agent-kit && git -C .hotskills/azurecosmosdb-cosmosdb-agent-kit checkout --detach 3ddc18fcd4d6fe0fae154f408395ff83c39495ee # Copy each selected skill directory from .hotskills/azurecosmosdb-cosmosdb-agent-kit into .agents/skills/<skill-name>/
git clone --filter=blob:none --no-checkout https://github.com/AzureCosmosDB/cosmosdb-agent-kit.git .hotskills/azurecosmosdb-cosmosdb-agent-kit && git -C .hotskills/azurecosmosdb-cosmosdb-agent-kit checkout --detach 3ddc18fcd4d6fe0fae154f408395ff83c39495ee # Copy each selected skill directory from .hotskills/azurecosmosdb-cosmosdb-agent-kit into .gemini/skills/<skill-name>/
git clone --filter=blob:none --no-checkout https://github.com/AzureCosmosDB/cosmosdb-agent-kit.git .hotskills/azurecosmosdb-cosmosdb-agent-kit && git -C .hotskills/azurecosmosdb-cosmosdb-agent-kit checkout --detach 3ddc18fcd4d6fe0fae154f408395ff83c39495ee # Copy each selected skill directory from .hotskills/azurecosmosdb-cosmosdb-agent-kit into .github/skills/<skill-name>/
62GitHub stars
3stars in 7 days
1skill in this repository
52commits in 30 days

Heat

4.3
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 1, 202662

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

cosmosdb-best-practices

When your agent uses it

Azure Cosmos DB performance optimization and best practices guidelines for NoSQL, partitioning, queries, and SDK usage. Use when writing, reviewing, or refactoring code that interacts with Azure Cosmos DB, designing data models, optimizing queries, or implementing high-performance database operations. USE FOR: Cosmos DB NoSQL, partition key design, RU optimization, point reads, cross-partition queries, SDK singleton, CosmosClient, container modeling, change feed, bulk operations, vector search, full-text search, hierarchical partition keys, global distribution, autoscale throughput, indexing policy, DO NOT USE FOR: PostgreSQL, MySQL, MongoDB (non-Azure), DynamoDB, Cassandra, Azure SQL, Cosmos DB for PostgreSQL (vCore), Cosmos DB for MongoDB vCore, Azure DocumentDB, general SQL databases, Redis, Elasticsearch.

What it loads into context

Frontmatter

216 tokens

Always available to the agent

SKILL.md

4,856 tokens

When the skill is activated

Reference documents

137,794 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. When to Apply
  2. Rule Categories by Priority
  3. Quick Reference
  4. How to Use

Files

  • ../../.claude-plugin/marketplace.jsonasset398 bytes
  • ../../.claude-plugin/plugin.jsonasset786 bytes
  • README.mddoc4,923 bytes
  • SKILL.mdcore21,031 bytes
  • SKILL.mdcore21,031 bytes
  • agents/openai.yamlasset310 bytes
  • metadata.jsonasset590 bytes
  • rules/_sections.mddoc3,085 bytes
  • rules/_template.mddoc1,039 bytes
  • rules/fts-add-index.mddoc1,976 bytes
  • rules/fts-define-policy.mddoc1,707 bytes
  • rules/fts-enable-capability.mddoc1,636 bytes
  • rules/fts-hybrid-queries.mddoc2,327 bytes
  • rules/fts-keyword-matching.mddoc2,209 bytes
  • rules/fts-relevance-ranking.mddoc1,459 bytes
  • rules/global-conflict-resolution.mddoc4,087 bytes
  • rules/global-consistency.mddoc3,962 bytes
  • rules/global-failover.mddoc3,804 bytes
  • rules/global-multi-region-write-antipattern.mddoc2,646 bytes
  • rules/global-multi-region.mddoc3,313 bytes
  • rules/global-read-regions.mddoc3,994 bytes
  • rules/global-zone-redundancy.mddoc3,576 bytes
  • rules/index-composite-direction.mddoc2,892 bytes
  • rules/index-composite.mddoc11,955 bytes
  • rules/index-exclude-unused.mddoc4,046 bytes
  • rules/index-lazy-consistent.mddoc3,363 bytes
  • rules/index-path-syntax.mddoc2,545 bytes
  • rules/index-range-vs-hash.mddoc3,956 bytes
  • rules/index-spatial.mddoc3,193 bytes
  • rules/model-avoid-2mb-limit.mddoc2,096 bytes
  • rules/model-denormalize-reads.mddoc12,537 bytes
  • rules/model-embed-related.mddoc2,528 bytes
  • rules/model-id-constraints.mddoc7,581 bytes
  • rules/model-json-serialization.mddoc6,175 bytes
  • rules/model-nesting-depth.mddoc3,421 bytes
  • rules/model-numeric-precision.mddoc3,324 bytes
  • rules/model-reference-large.mddoc2,313 bytes
  • rules/model-relationship-references.mddoc3,664 bytes
  • rules/model-schema-versioning.mddoc2,893 bytes
  • rules/model-ttl-expiration.mddoc3,174 bytes
  • rules/model-type-discriminator.mddoc3,583 bytes
  • rules/model-unique-keys.mddoc5,450 bytes
  • rules/monitoring-azure-monitor.mddoc4,531 bytes
  • rules/monitoring-diagnostic-logs.mddoc5,204 bytes
  • rules/monitoring-latency.mddoc4,303 bytes
  • rules/monitoring-ru-consumption.mddoc7,632 bytes
  • rules/monitoring-throttling.mddoc4,491 bytes
  • rules/partition-20gb-limit.mddoc2,893 bytes
  • rules/partition-avoid-hotspots.mddoc3,478 bytes
  • rules/partition-hierarchical.mddoc5,826 bytes
  • rules/partition-high-cardinality.mddoc2,234 bytes
  • rules/partition-immutable-key.mddoc1,812 bytes
  • rules/partition-key-length.mddoc2,892 bytes
  • rules/partition-query-patterns.mddoc2,747 bytes
  • rules/partition-rekey-migration.mddoc4,470 bytes
  • rules/partition-synthetic-keys.mddoc3,914 bytes
  • rules/pattern-ai-grounding-access.mddoc4,862 bytes
  • rules/pattern-background-task-writes.mddoc2,907 bytes
  • rules/pattern-change-feed-materialized-views.mddoc11,559 bytes
  • rules/pattern-efficient-ranking.mddoc6,053 bytes
  • rules/pattern-langgraph-agent-name-attribution.mddoc2,239 bytes
  • rules/pattern-langgraph-agent-routing-cosmosdb.mddoc4,690 bytes
  • rules/pattern-langgraph-async-cosmos-routing.mddoc3,286 bytes
  • rules/pattern-langgraph-async-cosmos-writes.mddoc2,951 bytes
  • rules/pattern-langgraph-chat-history-separate.mddoc3,431 bytes
  • rules/pattern-langgraph-fastapi-startup.mddoc3,146 bytes
  • rules/pattern-langgraph-interrupt-human.mddoc3,745 bytes
  • rules/pattern-langgraph-multi-agent.mddoc4,332 bytes
  • rules/pattern-langgraph-resume-checkpoint.mddoc3,213 bytes
  • rules/pattern-service-layer-relationships.mddoc4,878 bytes
  • rules/query-aggregate-single-pass.mddoc2,722 bytes
  • rules/query-avoid-cross-partition.mddoc4,364 bytes
  • rules/query-avoid-scans.mddoc2,569 bytes
  • rules/query-distinct-keyword.mddoc2,315 bytes
  • rules/query-latest-by-timestamp.mddoc2,223 bytes
  • rules/query-olap-detection.mddoc5,064 bytes
  • rules/query-order-filters.mddoc4,810 bytes
  • rules/query-pagination.mddoc7,846 bytes
  • rules/query-parameterize.mddoc3,833 bytes
  • rules/query-point-reads.mddoc9,916 bytes
  • rules/query-top-literal.mddoc1,928 bytes
  • rules/query-use-projections.mddoc5,660 bytes
  • rules/sdk-async-api.mddoc3,291 bytes
  • rules/sdk-availability-strategy.mddoc5,405 bytes
  • rules/sdk-circuit-breaker.mddoc8,576 bytes
  • rules/sdk-conditional-create-etag.mddoc2,867 bytes
  • rules/sdk-connection-mode.mddoc2,969 bytes
  • rules/sdk-continuation-token-null-guard.mddoc3,308 bytes
  • rules/sdk-diagnostics.mddoc6,822 bytes
  • rules/sdk-dotnet-cosmos-package-id.mddoc1,844 bytes
  • rules/sdk-dotnet-namespace-collision.mddoc2,865 bytes
  • rules/sdk-emulator-ssl.mddoc15,631 bytes
  • rules/sdk-etag-concurrency.mddoc9,779 bytes
  • rules/sdk-excluded-regions.mddoc4,979 bytes
  • rules/sdk-go-partition-key-metadata.mddoc3,061 bytes
  • rules/sdk-ingestion-rate-control.mddoc8,892 bytes
  • rules/sdk-java-content-response.mddoc8,427 bytes
  • rules/sdk-java-cosmos-config.mddoc10,314 bytes
  • rules/sdk-java-spring-boot-versions.mddoc5,047 bytes
  • rules/sdk-langchain-async-checkpointer.mddoc2,882 bytes
  • rules/sdk-langchain-cosmosdb-saver.mddoc2,612 bytes
  • rules/sdk-langchain-js-chat-history.mddoc3,480 bytes
  • rules/sdk-langchain-js-embedding-model.mddoc2,910 bytes
  • rules/sdk-langchain-js-filter-injection.mddoc3,973 bytes
  • rules/sdk-langchain-js-fulltext-prerequisites.mddoc3,840 bytes
  • rules/sdk-langchain-js-managed-identity.mddoc2,787 bytes
  • rules/sdk-langchain-js-search-types.mddoc2,753 bytes
  • rules/sdk-langchain-js-semantic-cache.mddoc3,037 bytes
  • rules/sdk-langchain-js-vectorstore-init.mddoc2,825 bytes
  • rules/sdk-langchain-mcp-persistent-session.mddoc3,508 bytes
  • rules/sdk-langchain-mcp-tool-content-format.mddoc1,982 bytes
  • rules/sdk-langgraph-mcp-tool-filtering.mddoc2,653 bytes
  • rules/sdk-local-dev-config.mddoc5,614 bytes
  • rules/sdk-newtonsoft-dependency.mddoc4,486 bytes
  • rules/sdk-patch-counter-increment.mddoc3,985 bytes
  • rules/sdk-preferred-regions.mddoc3,229 bytes
  • rules/sdk-python-async-deps.mddoc1,366 bytes
  • rules/sdk-python-client-kwargs.mddoc3,494 bytes
  • rules/sdk-request-options-per-call.mddoc3,982 bytes
  • rules/sdk-retry-429.mddoc3,786 bytes
  • rules/sdk-serialization-enums.mddoc4,180 bytes
  • rules/sdk-singleton-client.mddoc6,282 bytes
  • rules/sdk-spring-data-annotations.mddoc4,847 bytes
  • rules/sdk-spring-data-repository.mddoc3,532 bytes
  • rules/security-continuous-backup.mddoc2,304 bytes
  • rules/security-disable-local-auth.mddoc2,294 bytes
  • rules/security-managed-identity.mddoc3,387 bytes
  • rules/security-network-restrict.mddoc2,197 bytes
  • rules/security-private-endpoint-dns.mddoc9,533 bytes
  • rules/security-rbac-least-privilege.mddoc3,154 bytes
  • rules/throughput-autoscale.mddoc3,753 bytes
  • rules/throughput-burst.mddoc2,737 bytes
  • rules/throughput-container-vs-database.mddoc3,432 bytes
  • rules/throughput-idle-container-review.mddoc3,202 bytes
  • rules/throughput-right-size.mddoc3,139 bytes
  • rules/throughput-serverless-migration.mddoc3,106 bytes
  • rules/throughput-serverless.mddoc2,714 bytes
  • rules/throughput-ttl-stale-data.mddoc3,040 bytes
  • rules/tooling-cosmosdb-shell-setup.mddoc4,783 bytes
  • rules/tooling-cosmosdb-shell-target.mddoc6,011 bytes
  • rules/tooling-cosmosdb-shell-writes.mddoc8,461 bytes
  • rules/tooling-emulator-setup.mddoc1,472 bytes
  • rules/tooling-vscode-extension.mddoc1,559 bytes
  • rules/vector-distance-query.mddoc4,892 bytes
  • rules/vector-embedding-policy.mddoc3,866 bytes
  • rules/vector-enable-feature.mddoc3,098 bytes
  • rules/vector-index-type.mddoc6,926 bytes
  • rules/vector-normalize-embeddings.mddoc8,779 bytes
  • rules/vector-repository-pattern.mddoc13,226 bytes
Read SKILL.md

# Azure Cosmos DB Best Practices

Comprehensive performance optimization guide for Azure Cosmos DB applications, containing 100+ rules across 13 categories, prioritized by impact to guide automated refactoring and code generation.

Before answering, read the linked rule files relevant to the user's question.
The quick reference below is an index, not the full guidance: SDK APIs, limits,
configuration prerequisites, and caveats live in the rule bodies. Use the
language-specific integration rule when one exists rather than substituting a
generic pattern. Keep answers concise, but include the constraints that make the
recommendation correct for the user's scenario.

## When to Apply

Reference these guidelines when:
View the complete source on GitHub

Skills included

  • cosmosdb-best-practices

Repository facts

License
MIT
Created
Jan 21, 2026
Last pushed
Nov 3, 2026
Forks
38
Open issues
20
Project activity
Active

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 4, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 1 note
  • skills/cosmosdb-best-practices/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 310 signals by file

.claude-plugin/marketplace.json

  • Network accessline 3
    "owner": {     "name": "Azure Cosmos DB",     "url": "https://azure.microsoft.com/products/cosmos-db"
  • Network accessline 4
    "name": "Azure Cosmos DB",     "url": "https://azure.microsoft.com/products/cosmos-db"   },
  • Network accessline 5
    "url": "https://azure.microsoft.com/products/cosmos-db"

.claude-plugin/plugin.json

  • Network accessline 6
    "name": "Azure Cosmos DB",     "email": "cosmosdb-agentfirst@microsoft.com",     "url": "https://azure.microsoft.com/products/cosmos-db"
  • Network accessline 7
    "email": "cosmosdb-agentfirst@microsoft.com",     "url": "https://azure.microsoft.com/products/cosmos-db"   },
  • Network accessline 8
    "url": "https://azure.microsoft.com/products/cosmos-db"
  • Network accessline 9
    },   "homepage": "https://github.com/AzureCosmosDB/cosmosdb-agent-kit",   "repository": "https://github.com/AzureCosmosDB/cosmosdb-agent-kit",
  • Network accessline 10
    "homepage": "https://github.com/AzureCosmosDB/cosmosdb-agent-kit",
  • Network accessline 11
    "repository": "https://github.com/AzureCosmosDB/cosmosdb-agent-kit",

skills/cosmosdb-best-practices/README.md

  • Network accessline 3
    Azure Cosmos DB best practices for AI coding agents, following the [Agent Skills](https://agentskills.io) specification.
  • Network accessline 40
    git clone https://github.com/AzureCosmosDB/cosmosdb-agent-kit.git
  • Network accessline 139
    This skill follows the [Agent Skills](https://agentskills.io) open standard and is compatible with:
  • Network accessline 155
    - Inspired by [Vercel's React Best Practices](https://vercel.com/blog/introducing-react-best-practices)
  • Network accessline 156
    - Based on the [Agent Skills](https://agentskills.io) specification from Anthropic
  • Network accessline 157
    - Azure Cosmos DB team for [official documentation](https://learn.microsoft.com/azure/cosmos-db/)

skills/cosmosdb-best-practices/metadata.json

  • Network accessline 5
    "abstract": "Performance optimization and best practices guide for Azure Cosmos DB applications, ordered by impact. Contains rules for data modeling, partition key design, query optimization, SDK usage, indexing, throughput management, glob
  • Network accessline 6
    "references": [     "https://learn.microsoft.com/azure/cosmos-db/",     "https://learn.microsoft.com/azure/well-architected/service-guides/cosmos-db"
  • Network accessline 7
    "https://learn.microsoft.com/azure/cosmos-db/",
  • Network accessline 8
    "https://learn.microsoft.com/azure/well-architected/service-guides/cosmos-db"

skills/cosmosdb-best-practices/rules/_template.md

  • Network accessline 34
    Reference: [Link to documentation or resource](https://learn.microsoft.com/azure/cosmos-db/)

skills/cosmosdb-best-practices/rules/fts-add-index.md

  • Network accessline 50
    Reference: [Indexing policy for full-text search](https://learn.microsoft.com/azure/cosmos-db/gen-ai/full-text-search)

skills/cosmosdb-best-practices/rules/fts-define-policy.md

  • Network accessline 61
    Reference: [Configure full-text policy](https://learn.microsoft.com/azure/cosmos-db/gen-ai/full-text-search)

skills/cosmosdb-best-practices/rules/fts-enable-capability.md

  • Network accessline 52
    Reference: [Full-text search in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/gen-ai/full-text-search)

skills/cosmosdb-best-practices/rules/fts-hybrid-queries.md

  • Network accessline 60
    References: [Full-text search queries](https://learn.microsoft.com/azure/cosmos-db/gen-ai/full-text-search), [index usage and filter-clause ordering](https://learn.microsoft.com/azure/cosmos-db/index-overview#composite-indexes)

skills/cosmosdb-best-practices/rules/fts-keyword-matching.md

  • Network accessline 61
    Reference: [FullTextContains function](https://learn.microsoft.com/azure/cosmos-db/nosql/query/fulltextcontains)

skills/cosmosdb-best-practices/rules/fts-relevance-ranking.md

  • Network accessline 46
    Reference: [FullTextScore function](https://learn.microsoft.com/azure/cosmos-db/nosql/query/fulltextscore)

skills/cosmosdb-best-practices/rules/global-conflict-resolution.md

  • Network accessline 130
    Reference: [Conflict resolution](https://learn.microsoft.com/azure/cosmos-db/conflict-resolution-policies)

skills/cosmosdb-best-practices/rules/global-consistency.md

  • Network accessline 114
    Reference: [Consistency levels](https://learn.microsoft.com/azure/cosmos-db/consistency-levels)

skills/cosmosdb-best-practices/rules/global-failover.md

  • Network accessline 124
    Reference: [Automatic failover](https://learn.microsoft.com/azure/cosmos-db/high-availability)

skills/cosmosdb-best-practices/rules/global-multi-region-write-antipattern.md

  • Network accessline 52
    Reference: [Configure multi-region writes](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-multi-master)

skills/cosmosdb-best-practices/rules/global-multi-region.md

  • Network accessline 106
    Reference: [Multi-region writes](https://learn.microsoft.com/azure/cosmos-db/multi-region-writes)

skills/cosmosdb-best-practices/rules/global-read-regions.md

  • Network accessline 135
    Reference: [Global distribution](https://learn.microsoft.com/azure/cosmos-db/distribute-data-globally)

skills/cosmosdb-best-practices/rules/global-zone-redundancy.md

  • Network accessline 108
    Check current availability: [Azure regions with availability zones](https://learn.microsoft.com/en-us/azure/reliability/availability-zones-service-support)
  • Network accessline 110
    Reference: [High availability in Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/reliability/reliability-cosmos-db-nosql#availability-zone-support)

skills/cosmosdb-best-practices/rules/index-composite-direction.md

  • Network accessline 76
    Reference: [Composite index sort order](https://learn.microsoft.com/azure/cosmos-db/index-policy#composite-indexes)

skills/cosmosdb-best-practices/rules/index-composite.md

  • Network accessline 284
    Reference: [Composite indexes](https://learn.microsoft.com/azure/cosmos-db/index-policy#composite-indexes)

skills/cosmosdb-best-practices/rules/index-exclude-unused.md

  • Network accessline 124
    Reference: [Indexing policies](https://learn.microsoft.com/azure/cosmos-db/index-policy)

skills/cosmosdb-best-practices/rules/index-lazy-consistent.md

  • Network accessline 122
    Reference: [Indexing modes](https://learn.microsoft.com/azure/cosmos-db/index-policy#indexing-mode)

skills/cosmosdb-best-practices/rules/index-path-syntax.md

  • Network accessline 85
    Reference: [Indexing policy path syntax](https://learn.microsoft.com/azure/cosmos-db/index-policy#include-exclude-paths)

skills/cosmosdb-best-practices/rules/index-range-vs-hash.md

  • Network accessline 136
    Reference: [Index types](https://learn.microsoft.com/azure/cosmos-db/index-overview)

skills/cosmosdb-best-practices/rules/index-spatial.md

  • Network accessline 131
    Reference: [Geospatial queries](https://learn.microsoft.com/azure/cosmos-db/nosql/query/geospatial)

skills/cosmosdb-best-practices/rules/model-avoid-2mb-limit.md

  • Network accessline 74
    Reference: [Azure Cosmos DB service quotas](https://learn.microsoft.com/azure/cosmos-db/concepts-limits)

skills/cosmosdb-best-practices/rules/model-denormalize-reads.md

  • Network accessline 288
    Reference: [Embedding and denormalization](https://learn.microsoft.com/azure/cosmos-db/modeling-data#embed-data)

skills/cosmosdb-best-practices/rules/model-embed-related.md

  • Network accessline 65
    Reference: [Data modeling in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/modeling-data)

skills/cosmosdb-best-practices/rules/model-id-constraints.md

  • Network accessline 188
    Reference: [Azure Cosmos DB service quotas - Per-item limits](https://learn.microsoft.com/azure/cosmos-db/concepts-limits#per-item-limits) | [Access control on Cosmos DB resources](https://learn.microsoft.com/rest/api/cosmos-db/access-contr

skills/cosmosdb-best-practices/rules/model-json-serialization.md

  • Network accessline 196
    Reference: [Jackson annotations guide](https://github.com/FasterXML/jackson-annotations/wiki/Jackson-Annotations)

skills/cosmosdb-best-practices/rules/model-nesting-depth.md

  • Network accessline 101
    Reference: [Azure Cosmos DB service quotas - Per-item limits](https://learn.microsoft.com/azure/cosmos-db/concepts-limits#per-item-limits)

skills/cosmosdb-best-practices/rules/model-numeric-precision.md

  • Network accessline 100
    Reference: [Azure Cosmos DB service quotas - Per-item limits](https://learn.microsoft.com/azure/cosmos-db/concepts-limits#per-item-limits)

skills/cosmosdb-best-practices/rules/model-reference-large.md

  • Network accessline 69
    Reference: [Model document data](https://learn.microsoft.com/azure/cosmos-db/nosql/modeling-data#referencing-data)

skills/cosmosdb-best-practices/rules/model-relationship-references.md

  • Network accessline 95
    Reference: [Data modeling in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/modeling-data)

skills/cosmosdb-best-practices/rules/model-schema-versioning.md

  • Network accessline 90
    Reference: [Schema evolution in Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/modeling-data)

skills/cosmosdb-best-practices/rules/model-ttl-expiration.md

  • Network accessline 84
    Reference: [Time to Live in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/time-to-live)

skills/cosmosdb-best-practices/rules/model-type-discriminator.md

  • Network accessline 103
    Reference: [Model data in Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/modeling-data)

skills/cosmosdb-best-practices/rules/model-unique-keys.md

  • Network accessline 106
    References: - [Unique keys in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/unique-keys)
  • Network accessline 107
    - [Unique keys in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/unique-keys)
  • Network accessline 108
    - [Define unique keys with SDKs](https://learn.microsoft.com/azure/cosmos-db/how-to-define-unique-keys)
  • Network accessline 109
    - [Cosmos DB JavaScript SDK](https://learn.microsoft.com/javascript/api/@azure/cosmos/)

skills/cosmosdb-best-practices/rules/monitoring-azure-monitor.md

  • Network accessline 160
    Reference: [Monitor Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/monitor)

skills/cosmosdb-best-practices/rules/monitoring-diagnostic-logs.md

  • Network accessline 159
    Reference: [Diagnostic logging](https://learn.microsoft.com/azure/cosmos-db/monitor-resource-logs)

skills/cosmosdb-best-practices/rules/monitoring-latency.md

  • Network accessline 143
    Reference: [Monitor latency](https://learn.microsoft.com/azure/cosmos-db/monitor-server-side-latency)

skills/cosmosdb-best-practices/rules/monitoring-ru-consumption.md

  • Network accessline 231
    Reference: [Monitor RU/s](https://learn.microsoft.com/azure/cosmos-db/monitor-request-unit-usage)

skills/cosmosdb-best-practices/rules/monitoring-throttling.md

  • Network accessline 146
    Reference: [Monitor throttling](https://learn.microsoft.com/azure/cosmos-db/monitor-normalized-request-units)

skills/cosmosdb-best-practices/rules/partition-20gb-limit.md

  • Network accessline 99
    Reference: [Partition key limits](https://learn.microsoft.com/azure/cosmos-db/concepts-limits#per-logical-partition)

skills/cosmosdb-best-practices/rules/partition-avoid-hotspots.md

  • Network accessline 88
    **Partition Limits (as of current Azure Cosmos DB documentation):**    - Physical partition throughput limit: **10,000 RU/s** per physical partition        See [Azure Cosmos DB partitioning – physical partitions](https://learn.microsoft.com
  • Network accessline 89
    - Physical partition throughput limit: **10,000 RU/s** per physical partition        See [Azure Cosmos DB partitioning – physical partitions](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview#physical-partitions).    - Logic
  • Network accessline 90
    See [Azure Cosmos DB partitioning – physical partitions](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview#physical-partitions).
  • Network accessline 91
    - Logical partition size limit: **20 GB** per logical partition        See [Azure Cosmos DB partitioning – logical partitions](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview#logical-partitions).    - Physical partition si
  • Network accessline 92
    See [Azure Cosmos DB partitioning – logical partitions](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview#logical-partitions).
  • Network accessline 94
    See [Azure Cosmos DB partitioning – physical partitions](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview#physical-partitions).

skills/cosmosdb-best-practices/rules/partition-hierarchical.md

  • Network accessline 172
    Reference: [Hierarchical partition keys](https://learn.microsoft.com/en-us/azure/cosmos-db/hierarchical-partition-keys?tabs=python%2Cbicep#sdk)

skills/cosmosdb-best-practices/rules/partition-high-cardinality.md

  • Network accessline 80
    Reference: [Partitioning in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview)

skills/cosmosdb-best-practices/rules/partition-immutable-key.md

  • Network accessline 45
    Reference: [Change partition key value](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-change-partition-key-value)

skills/cosmosdb-best-practices/rules/partition-key-length.md

  • Network accessline 81
    Reference: [Azure Cosmos DB service quotas - Per-item limits](https://learn.microsoft.com/azure/cosmos-db/concepts-limits#per-item-limits)

skills/cosmosdb-best-practices/rules/partition-query-patterns.md

  • Network accessline 86
    Reference: [Choose a partition key](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview#choose-a-partition-key)

skills/cosmosdb-best-practices/rules/partition-rekey-migration.md

  • Network accessline 12
    Prefer the built-in feature over hand-rolling this migration. Azure Cosmos DB for NoSQL provides a built-in **Change partition key** feature (Azure portal) that performs the re-key for you using service-managed [container copy](https://lear
  • Network accessline 54
    Requirements and limitations (verify before starting): - **API:** Azure Cosmos DB for **NoSQL** API. - **Size/throughput:** container has **< 4 TB** of data and is provisioned with **< 1,000,000 RU/s**. Above either, contact Microsoft suppo
  • Network accessline 55
    - **API:** Azure Cosmos DB for **NoSQL** API. - **Size/throughput:** container has **< 4 TB** of data and is provisioned with **< 1,000,000 RU/s**. Above either, contact Microsoft support. ([Change partition key — Limitations](https://learn
  • Network accessline 56
    - **Size/throughput:** container has **< 4 TB** of data and is provisioned with **< 1,000,000 RU/s**. Above either, contact Microsoft support. ([Change partition key — Limitations](https://learn.microsoft.com/azure/cosmos-db/change-partitio
  • Network accessline 57
    - **Not supported** on accounts that have the **Merge partition** capability enabled. - **Regions:** available only in the [regions supported by container copy](https://learn.microsoft.com/azure/cosmos-db/container-copy#supported-regions).
  • Network accessline 58
    - **Regions:** available only in the [regions supported by container copy](https://learn.microsoft.com/azure/cosmos-db/container-copy#supported-regions).
  • Network accessline 63
    Reference: [Change partition key in Azure Cosmos DB for NoSQL](https://learn.microsoft.com/azure/cosmos-db/change-partition-key)

skills/cosmosdb-best-practices/rules/partition-synthetic-keys.md

  • Network accessline 106
    References: - [Synthetic partition keys](https://learn.microsoft.com/azure/cosmos-db/nosql/synthetic-partition-keys)
  • Network accessline 107
    - [Synthetic partition keys](https://learn.microsoft.com/azure/cosmos-db/nosql/synthetic-partition-keys)
  • Network accessline 108
    - [Hierarchical partition keys (HPK)](https://learn.microsoft.com/azure/cosmos-db/nosql/hierarchical-partition-keys)

skills/cosmosdb-best-practices/rules/pattern-ai-grounding-access.md

  • Network accessline 94
    Reference: [Point-read request charges and consistency levels](https://learn.microsoft.com/azure/cosmos-db/optimize-cost-reads-writes)

skills/cosmosdb-best-practices/rules/pattern-background-task-writes.md

  • Network accessline 68
    Reference: [FastAPI Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/)

skills/cosmosdb-best-practices/rules/pattern-change-feed-materialized-views.md

  • Network accessline 292
    Reference(s):  [Change feed in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/change-feed)
  • Network accessline 293
    [Change feed in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/change-feed)
  • Network accessline 294
    [Change feed design patterns in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/change-feed-design-patterns)
  • Network accessline 295
    [Global Secondary Indexes (GSI) in Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/global-secondary-indexes)

skills/cosmosdb-best-practices/rules/pattern-efficient-ranking.md

  • Network accessline 163
    Reference: [Cosmos DB query optimization](https://learn.microsoft.com/azure/cosmos-db/nosql/query/getting-started)

skills/cosmosdb-best-practices/rules/pattern-langgraph-agent-name-attribution.md

  • Network accessline 48
    Reference: [LangGraph multi-agent patterns](https://langchain-ai.github.io/langgraph/concepts/multi_agent/)

skills/cosmosdb-best-practices/rules/pattern-langgraph-agent-routing-cosmosdb.md

  • Network accessline 85
    1. Use hierarchical partition key (`/tenantId`, `/userId`, `/sessionId`) for efficient multi-tenant lookups 2. A point read of a 1-KB item costs 1 RU at session, consistent-prefix, or eventual consistency. Larger items cost more; the docume
  • Network accessline 86
    2. A point read of a 1-KB item costs 1 RU at session, consistent-prefix, or eventual consistency. Larger items cost more; the documented 100-KB example costs 10 RUs. Strong or bounded-staleness consistency doubles the read charge. Measure t
  • Network accessline 87
    3. Use patch operations to update only the active agent field without sending the full document. [Patch is billed like other operations](https://learn.microsoft.com/azure/cosmos-db/partial-document-update-faq#how-is-ru-s-pricing-calculated-
  • Network accessline 92
    Reference: [Point-read request charges and consistency levels](https://learn.microsoft.com/azure/cosmos-db/optimize-cost-reads-writes)

skills/cosmosdb-best-practices/rules/pattern-langgraph-async-cosmos-routing.md

  • Network accessline 70
    Reference: [Python asyncio.to_thread documentation](https://docs.python.org/3/library/asyncio-task.html#asyncio.to_thread)

skills/cosmosdb-best-practices/rules/pattern-langgraph-async-cosmos-writes.md

  • Network accessline 70
    Reference: [Python asyncio.to_thread documentation](https://docs.python.org/3/library/asyncio-task.html#asyncio.to_thread)

skills/cosmosdb-best-practices/rules/pattern-langgraph-chat-history-separate.md

  • Network accessline 70
    Reference: [Azure Cosmos DB container design](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-model-partition-example)

skills/cosmosdb-best-practices/rules/pattern-langgraph-fastapi-startup.md

  • Network accessline 84
    Reference: [FastAPI lifespan events](https://fastapi.tiangolo.com/advanced/events/)

skills/cosmosdb-best-practices/rules/pattern-langgraph-interrupt-human.md

  • Network accessline 80
    Reference: [LangGraph interrupts and resuming](https://docs.langchain.com/oss/python/langgraph/interrupts#resuming-interrupts)

skills/cosmosdb-best-practices/rules/pattern-langgraph-multi-agent.md

  • Network accessline 93
    Reference: [LangGraph multi-agent patterns](https://langchain-ai.github.io/langgraph/concepts/multi_agent/)

skills/cosmosdb-best-practices/rules/pattern-langgraph-resume-checkpoint.md

  • Network accessline 55
    References: [LangGraph persistence](https://docs.langchain.com/oss/python/langgraph/persistence), [resuming interrupts](https://docs.langchain.com/oss/python/langgraph/interrupts#resuming-interrupts), [StateSnapshot](https://reference.langc

skills/cosmosdb-best-practices/rules/pattern-service-layer-relationships.md

  • Network accessline 132
    Reference: [Data modeling in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/modeling-data)

skills/cosmosdb-best-practices/rules/query-aggregate-single-pass.md

  • Network accessline 68
    Reference: [Aggregate functions in Azure Cosmos DB for NoSQL](https://learn.microsoft.com/azure/cosmos-db/nosql/query/aggregate-functions) | [Query performance tips](https://learn.microsoft.com/azure/cosmos-db/nosql/performance-tips-query-s

skills/cosmosdb-best-practices/rules/query-avoid-cross-partition.md

  • Network accessline 115
    Reference: [Query patterns](https://learn.microsoft.com/azure/cosmos-db/nosql/query/getting-started)

skills/cosmosdb-best-practices/rules/query-avoid-scans.md

  • Network accessline 86
    Reference: [Query optimization](https://learn.microsoft.com/azure/cosmos-db/nosql/query-metrics)

skills/cosmosdb-best-practices/rules/query-distinct-keyword.md

  • Network accessline 72
    References: - https://learn.microsoft.com/azure/cosmos-db/nosql/query/keywords#distinct
  • Network accessline 73
    - https://learn.microsoft.com/azure/cosmos-db/nosql/query/keywords#distinct

skills/cosmosdb-best-practices/rules/query-latest-by-timestamp.md

  • Network accessline 66
    Reference: [ORDER BY in Azure Cosmos DB for NoSQL](https://learn.microsoft.com/azure/cosmos-db/nosql/query/order-by) | [TOP keyword](https://learn.microsoft.com/azure/cosmos-db/nosql/query/keywords#top)

skills/cosmosdb-best-practices/rules/query-olap-detection.md

  • Network accessline 106
    References: - [Azure Synapse Link for Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/synapse-link)
  • Network accessline 107
    - [Azure Synapse Link for Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/synapse-link)
  • Network accessline 108
    - [Analytical store overview](https://learn.microsoft.com/azure/cosmos-db/analytical-store-introduction)
  • Network accessline 109
    - [Change Feed materialized views pattern](https://learn.microsoft.com/azure/cosmos-db/nosql/change-feed-design-patterns#materialized-views)

skills/cosmosdb-best-practices/rules/query-order-filters.md

  • Network accessline 99
    Reference: [Index usage and filter-clause ordering](https://learn.microsoft.com/azure/cosmos-db/index-overview#composite-indexes)

skills/cosmosdb-best-practices/rules/query-pagination.md

  • Possible obfuscationline 96
    ? Encoding.UTF8.GetString(Convert.FromBase64String(continuationToken))
  • Network accessline 222
    Reference: [Pagination in Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/query/pagination)

skills/cosmosdb-best-practices/rules/query-parameterize.md

  • Network accessline 121
    Reference: [Parameterized queries](https://learn.microsoft.com/azure/cosmos-db/nosql/query/parameterized-queries)

skills/cosmosdb-best-practices/rules/query-point-reads.md

  • Network accessline 276
    Reference: [Point reads in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-read-item) | [ReadMany — read multiple items](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-dotnet-read-item#read-multiple-items

skills/cosmosdb-best-practices/rules/query-top-literal.md

  • Network accessline 53
    References: - [Parameterized queries](https://learn.microsoft.com/azure/cosmos-db/nosql/query/parameterized-queries)
  • Network accessline 54
    - [Parameterized queries](https://learn.microsoft.com/azure/cosmos-db/nosql/query/parameterized-queries)
  • Network accessline 55
    - [SQL query TOP keyword](https://learn.microsoft.com/azure/cosmos-db/nosql/query/select#top-keyword)

skills/cosmosdb-best-practices/rules/query-use-projections.md

  • Network accessline 168
    Reference: [Project fields in queries](https://learn.microsoft.com/azure/cosmos-db/nosql/query/select)

skills/cosmosdb-best-practices/rules/sdk-async-api.md

  • Network accessline 115
    Reference: [Async programming best practices](https://learn.microsoft.com/azure/cosmos-db/nosql/best-practice-dotnet#use-async-methods)

skills/cosmosdb-best-practices/rules/sdk-availability-strategy.md

  • Network accessline 125
    Reference: [Performance tips - .NET SDK High Availability](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-dotnet-sdk-v3#high-availability)
  • Network accessline 126
    Reference: [Performance tips - Java SDK High Availability](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-java-sdk-v4#high-availability)

skills/cosmosdb-best-practices/rules/sdk-circuit-breaker.md

  • Access to secretsline 106
    [Credential-related source omitted]
  • Access to secretsline 107
    [Credential-related source omitted]
  • Access to secretsline 108
    [Credential-related source omitted]
  • Access to secretsline 109
    [Credential-related source omitted]
  • Network accessline 190
    Reference: [Performance tips - .NET SDK Circuit Breaker](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-dotnet-sdk-v3#partition-level-circuit-breaker)
  • Network accessline 191
    Reference: [Performance tips - Java SDK Circuit Breaker](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-java-sdk-v4#partition-level-circuit-breaker)
  • Network accessline 192
    Reference: [Performance tips - Python SDK Circuit Breaker](https://learn.microsoft.com/en-gb/azure/cosmos-db/performance-tips-python-sdk#partition-level-circuit-breaker)

skills/cosmosdb-best-practices/rules/sdk-conditional-create-etag.md

  • Network accessline 67
    Reference: [Optimistic concurrency in Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/database-transactions-optimistic-concurrency)

skills/cosmosdb-best-practices/rules/sdk-connection-mode.md

  • Network accessline 97
    Reference: [Direct vs Gateway connection modes](https://learn.microsoft.com/azure/cosmos-db/nosql/sdk-connection-modes)

skills/cosmosdb-best-practices/rules/sdk-continuation-token-null-guard.md

  • Network accessline 74
    Reference: [Query with continuation tokens (Java SDK)](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-java-get-started)

skills/cosmosdb-best-practices/rules/sdk-diagnostics.md

  • Network accessline 174
    Reference: [Capture diagnostics — Troubleshoot .NET SDK](https://learn.microsoft.com/azure/cosmos-db/nosql/troubleshoot-dotnet-sdk#capture-diagnostics)

skills/cosmosdb-best-practices/rules/sdk-dotnet-cosmos-package-id.md

  • Network accessline 41
    Reference: [Microsoft.Azure.Cosmos NuGet package](https://www.nuget.org/packages/Microsoft.Azure.Cosmos)

skills/cosmosdb-best-practices/rules/sdk-dotnet-namespace-collision.md

  • Network accessline 73
    Reference: [C# CS0104 — ambiguous reference](https://learn.microsoft.com/dotnet/csharp/misc/cs0104)

skills/cosmosdb-best-practices/rules/sdk-emulator-ssl.md

  • Network accessline 16
    | Connection Mode | **Gateway** (required) | Direct (recommended) | | SSL Validation | Disable or import cert | Normal validation | | Endpoint | `https://localhost:8081` | Your account URL |
  • Network accessline 17
    | SSL Validation | Disable or import cert | Normal validation | | Endpoint | `https://localhost:8081` | Your account URL | | Key | Well-known emulator key | Your account key |
  • Network accessline 18
    | Endpoint | `https://localhost:8081` | Your account URL |
  • Network accessline 42
    var client = new CosmosClient(     "https://localhost:8081",
  • Network accessline 43
    "https://localhost:8081",
  • Network accessline 60
    # Python SDK uses Gateway mode by default client = CosmosClient(     url="https://localhost:8081",
  • Network accessline 61
    client = CosmosClient(     url="https://localhost:8081",     credential="C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
  • Network accessline 62
    url="https://localhost:8081",
  • Network accessline 78
    const client = new CosmosClient({     endpoint: "https://localhost:8081",
  • Network accessline 79
    endpoint: "https://localhost:8081",
  • Network accessline 110
    // Direct mode fails even after certificate import: CosmosClientBuilder builder = new CosmosClientBuilder()     .endpoint("https://localhost:8081")
  • Network accessline 111
    CosmosClientBuilder builder = new CosmosClientBuilder()     .endpoint("https://localhost:8081")     .key("...")
  • Network accessline 112
    .endpoint("https://localhost:8081")
  • Network accessline 151
    // Gateway mode works reliably with the emulator after certificate import CosmosClientBuilder builder = new CosmosClientBuilder()     .endpoint("https://localhost:8081")
  • Network accessline 152
    CosmosClientBuilder builder = new CosmosClientBuilder()     .endpoint("https://localhost:8081")     .key("C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==")
  • Network accessline 153
    .endpoint("https://localhost:8081")
  • Network accessline 163
    azure:   cosmos:     endpoint: https://localhost:8081
  • Network accessline 164
    cosmos:     endpoint: https://localhost:8081     key: C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
  • Network accessline 165
    endpoint: https://localhost:8081
  • Network accessline 287
    COSMOS_ENDPOINT=https://localhost:8081
  • Network accessline 295
    CosmosClient client = new CosmosClientBuilder()     .endpoint(System.getenv("COSMOS_ENDPOINT"))   // https://localhost:8081 (SAN-matching host)
  • Network accessline 296
    .endpoint(System.getenv("COSMOS_ENDPOINT"))   // https://localhost:8081 (SAN-matching host)
  • Access to secretsline 297
    [Credential-related source omitted]
  • Network accessline 332
    Reference: [Azure Cosmos DB Java SDK v4](https://learn.microsoft.com/azure/cosmos-db/sdk-java-v4)
  • Network accessline 346
    // ✅ Emulator configuration — accepts invalid certificates let endpoint: CosmosAccountEndpoint = "https://localhost:8081"
  • Network accessline 347
    let endpoint: CosmosAccountEndpoint = "https://localhost:8081"
  • Network accessline 378
    Reference: [Use the Azure Cosmos DB Emulator for local development](https://learn.microsoft.com/azure/cosmos-db/emulator)

skills/cosmosdb-best-practices/rules/sdk-etag-concurrency.md

  • Network accessline 241
    Reference: [Optimistic concurrency control in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/database-transactions-optimistic-concurrency#optimistic-concurrency-control)

skills/cosmosdb-best-practices/rules/sdk-excluded-regions.md

  • Network accessline 145
    Reference: [Performance tips - .NET SDK Excluded Regions](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-dotnet-sdk-v3#excluded-regions)
  • Network accessline 146
    Reference: [Performance tips - Java SDK Excluded Regions](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-java-sdk-v4#excluded-regions)

skills/cosmosdb-best-practices/rules/sdk-go-partition-key-metadata.md

  • Network accessline 71
    References: - [Azure Cosmos DB for NoSQL partitioning overview](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview)
  • Network accessline 72
    - [Azure Cosmos DB for NoSQL partitioning overview](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview)
  • Network accessline 73
    - [Azure Cosmos DB Go SDK (`azcosmos`) package docs](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos)

skills/cosmosdb-best-practices/rules/sdk-ingestion-rate-control.md

  • Network accessline 152
    References: - [Bulk import data with the .NET SDK](https://learn.microsoft.com/azure/cosmos-db/nosql/tutorial-dotnet-bulk-import)
  • Network accessline 153
    - [Bulk import data with the .NET SDK](https://learn.microsoft.com/azure/cosmos-db/nosql/tutorial-dotnet-bulk-import)
  • Network accessline 154
    - [Throughput control groups — Java SDK v4](https://learn.microsoft.com/azure/cosmos-db/throughput-control-java)
  • Network accessline 155
    - [Throughput control — Spark connector](https://learn.microsoft.com/azure/cosmos-db/throughput-control-spark)
  • Network accessline 156
    - [Priority-based execution](https://learn.microsoft.com/azure/cosmos-db/priority-based-execution)
  • Network accessline 157
    - [Throughput buckets](https://learn.microsoft.com/azure/cosmos-db/throughput-buckets)

skills/cosmosdb-best-practices/rules/sdk-java-content-response.md

  • Network accessline 208
    Reference: [Azure Cosmos DB Java SDK best practices](https://learn.microsoft.com/azure/cosmos-db/nosql/best-practice-java)

skills/cosmosdb-best-practices/rules/sdk-java-cosmos-config.md

  • Network accessline 260
    References: - [Spring Framework @Bean documentation](https://docs.spring.io/spring-framework/reference/core/beans/java/bean-annotation.html)
  • Network accessline 261
    - [Spring Framework @Bean documentation](https://docs.spring.io/spring-framework/reference/core/beans/java/bean-annotation.html)
  • Network accessline 262
    - [`CosmosAsyncClient.createDatabaseIfNotExists()` Javadoc](https://learn.microsoft.com/java/api/com.azure.cosmos.cosmosasyncclient?view=azure-java-stable)
  • Network accessline 263
    - [`AbstractCosmosConfiguration` Javadoc](https://learn.microsoft.com/java/api/com.azure.spring.data.cosmos.config.abstractcosmosconfiguration?view=azure-java-stable)

skills/cosmosdb-best-practices/rules/sdk-java-spring-boot-versions.md

  • Network accessline 131
    - [Spring Boot 3.x System Requirements](https://docs.spring.io/spring-boot/docs/current/reference/html/getting-started.html#getting-started.system-requirements)
  • Network accessline 132
    - [Spring Boot 2.7.x System Requirements](https://docs.spring.io/spring-boot/docs/2.7.x/reference/html/getting-started.html#getting-started-system-requirements)
  • Network accessline 133
    - [Azure Cosmos DB Java SDK](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/sdk-java-v4)

skills/cosmosdb-best-practices/rules/sdk-langchain-async-checkpointer.md

  • Network accessline 64
    Reference: [Azure Cosmos DB async Python SDK](https://learn.microsoft.com/python/api/azure-cosmos/azure.cosmos.aio?view=azure-python)

skills/cosmosdb-best-practices/rules/sdk-langchain-cosmosdb-saver.md

  • Network accessline 64
    Reference: [langchain-azure-cosmosdb documentation](https://python.langchain.com/docs/integrations/providers/azure_cosmos_db/)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-chat-history.md

  • Network accessline 87
    Reference: [LangChain.js Azure Cosmos DB Chat History](https://js.langchain.com/docs/integrations/chat_memory/azure_cosmosdb_nosql/)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-embedding-model.md

  • Access to secretsline 46
    [Credential-related source omitted]
  • Network accessline 68
    Reference: [LangChain.js Azure OpenAI Embeddings](https://js.langchain.com/docs/integrations/text_embedding/azure_openai/)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-filter-injection.md

  • Network accessline 87
    Reference: [Azure Cosmos DB Parameterized Queries](https://learn.microsoft.com/azure/cosmos-db/nosql/query/parameterized-queries)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-fulltext-prerequisites.md

  • Network accessline 104
    Reference: [Azure Cosmos DB Full-Text Search](https://learn.microsoft.com/azure/cosmos-db/nosql/query/full-text-search)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-managed-identity.md

  • Network accessline 44
    const credential = new DefaultAzureCredential(); const store = new AzureCosmosDBNoSQLVectorStore(embeddings, {   endpoint: process.env.COSMOS_ENDPOINT, // e.g., "https://myaccount.documents.azure.com:443/"
  • Network accessline 45
    const store = new AzureCosmosDBNoSQLVectorStore(embeddings, {   endpoint: process.env.COSMOS_ENDPOINT, // e.g., "https://myaccount.documents.azure.com:443/"   credential,
  • Network accessline 46
    endpoint: process.env.COSMOS_ENDPOINT, // e.g., "https://myaccount.documents.azure.com:443/"
  • Network accessline 66
    Reference: [Azure Cosmos DB RBAC with Azure Identity](https://learn.microsoft.com/azure/cosmos-db/nosql/security/how-to-grant-data-plane-role-based-access)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-search-types.md

  • Network accessline 71
    Reference: [LangChain.js Azure Cosmos DB NoSQL Vector Store](https://js.langchain.com/docs/integrations/vectorstores/azure_cosmosdb_nosql/)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-semantic-cache.md

  • Network accessline 73
    Reference: [LangChain.js Azure Cosmos DB Semantic Cache](https://js.langchain.com/docs/integrations/llm_caching/azure_cosmosdb_nosql/)

skills/cosmosdb-best-practices/rules/sdk-langchain-js-vectorstore-init.md

  • Network accessline 71
    Reference: [LangChain.js Azure Cosmos DB Integration](https://js.langchain.com/docs/integrations/vectorstores/azure_cosmosdb_nosql/)

skills/cosmosdb-best-practices/rules/sdk-langchain-mcp-persistent-session.md

  • Network accessline 22
    # BAD: Creates a new client (and underlying sessions) for every single request     client = MultiServerMCPClient({         "my_server": {"transport": "streamable_http", "url": "http://localhost:8080/mcp"}
  • Network accessline 23
    client = MultiServerMCPClient({         "my_server": {"transport": "streamable_http", "url": "http://localhost:8080/mcp"}     })
  • Network accessline 24
    "my_server": {"transport": "streamable_http", "url": "http://localhost:8080/mcp"}
  • Network accessline 89
    Reference: [langchain-mcp-adapters documentation](https://github.com/langchain-ai/langchain-mcp-adapters)

skills/cosmosdb-best-practices/rules/sdk-langchain-mcp-tool-content-format.md

  • Network accessline 52
    Reference: [langchain-mcp-adapters changelog](https://github.com/langchain-ai/langchain-mcp-adapters)

skills/cosmosdb-best-practices/rules/sdk-langgraph-mcp-tool-filtering.md

  • Network accessline 58
    Reference: [LangGraph prebuilt agents](https://langchain-ai.github.io/langgraph/reference/prebuilt/)

skills/cosmosdb-best-practices/rules/sdk-local-dev-config.md

  • Network accessline 15
    [Credential-related source omitted]
  • Access to secretsline 15
    [Credential-related source omitted]
  • Network accessline 16
    COSMOS_ENDPOINT=https://localhost:8081
  • Network accessline 19
    # But system environment has (from Azure CLI or other tools): # COSMOS_ENDPOINT=https://my-prod-account.documents.azure.com:443/
  • Network accessline 20
    # COSMOS_ENDPOINT=https://my-prod-account.documents.azure.com:443/
  • Access to secretsline 35
    [Credential-related source omitted]
  • Access to secretsline 36
    [Credential-related source omitted]
  • Network accessline 38
    # Or use explicit defaults for emulator COSMOS_ENDPOINT = os.getenv("COSMOS_ENDPOINT", "https://localhost:8081")
  • Network accessline 39
    COSMOS_ENDPOINT = os.getenv("COSMOS_ENDPOINT", "https://localhost:8081")
  • Network accessline 52
    // Or with explicit defaults const endpoint = process.env.COSMOS_ENDPOINT || 'https://localhost:8081';
  • Network accessline 53
    const endpoint = process.env.COSMOS_ENDPOINT || 'https://localhost:8081';
  • Access to secretsline 54
    [Credential-related source omitted]
  • Network accessline 65
    {   "CosmosDb": {     "Endpoint": "https://localhost:8081",
  • Network accessline 66
    "CosmosDb": {     "Endpoint": "https://localhost:8081",     "Key": "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw=="
  • Network accessline 67
    "Endpoint": "https://localhost:8081",
  • Network accessline 118
    azure:   cosmos:     endpoint: https://localhost:8081
  • Network accessline 119
    cosmos:     endpoint: https://localhost:8081     key: C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
  • Network accessline 120
    endpoint: https://localhost:8081
  • Access to secretsline 128
    [Credential-related source omitted]
  • Access to secretsline 160
    [Credential-related source omitted]
  • Access to secretsline 167
    [Credential-related source omitted]
  • Network accessline 173
    Reference: [Azure Cosmos DB Emulator](https://learn.microsoft.com/azure/cosmos-db/emulator)

skills/cosmosdb-best-practices/rules/sdk-newtonsoft-dependency.md

  • Network accessline 106
    Reference: [Managing Newtonsoft.Json Dependencies](https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-dotnet-sdk-v3?tabs=trace-net-core#managing-newtonsoftjson-dependencies)

skills/cosmosdb-best-practices/rules/sdk-patch-counter-increment.md

  • Network accessline 79
    References: [Supported patch operations](https://learn.microsoft.com/azure/cosmos-db/partial-document-update#supported-operations), [Patch troubleshooting](https://learn.microsoft.com/azure/cosmos-db/partial-document-update-getting-started#

skills/cosmosdb-best-practices/rules/sdk-preferred-regions.md

  • Network accessline 98
    Reference: [Configure preferred regions](https://learn.microsoft.com/azure/cosmos-db/nosql/tutorial-global-distribution)

skills/cosmosdb-best-practices/rules/sdk-python-async-deps.md

  • Network accessline 50
    Reference: [Azure Cosmos DB Python SDK](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/sdk-python)

skills/cosmosdb-best-practices/rules/sdk-python-client-kwargs.md

  • Network accessline 75
    Reference: [azure.cosmos.CosmosClient](https://learn.microsoft.com/python/api/azure-cosmos/azure.cosmos.cosmosclient?view=azure-python)

skills/cosmosdb-best-practices/rules/sdk-request-options-per-call.md

  • Network accessline 81
    References: [CosmosAsyncContainer API](https://learn.microsoft.com/java/api/com.azure.cosmos.cosmosasynccontainer?view=azure-java-stable), [Java SDK createItem implementation](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/cosmos

skills/cosmosdb-best-practices/rules/sdk-retry-429.md

  • Network accessline 119
    Reference: [Handle rate limiting](https://learn.microsoft.com/azure/cosmos-db/nosql/troubleshoot-request-rate-too-large)

skills/cosmosdb-best-practices/rules/sdk-singleton-client.md

  • Network accessline 176
    #[tokio::main] async fn main() {     let cosmos = create_singleton_client("https://...", "key...").await;
  • Network accessline 177
    async fn main() {     let cosmos = create_singleton_client("https://...", "key...").await;     let app = axum::Router::new()
  • Network accessline 178
    let cosmos = create_singleton_client("https://...", "key...").await;
  • Network accessline 194
    Reference: [CosmosClient best practices](https://learn.microsoft.com/azure/cosmos-db/nosql/best-practice-dotnet)

skills/cosmosdb-best-practices/rules/sdk-spring-data-annotations.md

  • Network accessline 118
    Reference: [Spring Data Azure Cosmos DB annotations](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-java-spring-data)

skills/cosmosdb-best-practices/rules/sdk-spring-data-repository.md

  • Network accessline 93
    Reference: [Spring Data Azure Cosmos DB repository](https://learn.microsoft.com/azure/cosmos-db/nosql/how-to-java-spring-data#define-a-repository)

skills/cosmosdb-best-practices/rules/security-continuous-backup.md

  • Network accessline 68
    Reference: [Continuous backup with point-in-time restore in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction)

skills/cosmosdb-best-practices/rules/security-disable-local-auth.md

  • Network accessline 17
    // WRONG: Connection string contains a master key // If this leaks via source control, logs, or config, all data is exposed var connectionString = "AccountEndpoint=https://myaccount.documents.azure.com:443/;AccountKey=abc123...==;";
  • Network accessline 18
    // If this leaks via source control, logs, or config, all data is exposed var connectionString = "AccountEndpoint=https://myaccount.documents.azure.com:443/;AccountKey=abc123...==;"; var client = new CosmosClient(connectionString);
  • Network accessline 19
    var connectionString = "AccountEndpoint=https://myaccount.documents.azure.com:443/;AccountKey=abc123...==;";
  • Access to secretsline 23
    [Credential-related source omitted]
  • Network accessline 45
    var client = new CosmosClient(     accountEndpoint: "https://myaccount.documents.azure.com:443/",
  • Network accessline 46
    accountEndpoint: "https://myaccount.documents.azure.com:443/",
  • Network accessline 59
    Reference: [Disable local authentication in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/how-to-setup-rbac#disable-local-auth)

skills/cosmosdb-best-practices/rules/security-managed-identity.md

  • Network accessline 17
    // WRONG: Key stored in configuration var client = new CosmosClient(     "https://myaccount.documents.azure.com:443/",
  • Network accessline 18
    var client = new CosmosClient(     "https://myaccount.documents.azure.com:443/",     "abc123masterkey=="
  • Network accessline 19
    "https://myaccount.documents.azure.com:443/",
  • Network accessline 43
    // - CI/CD: uses service principal or workload identity federation var client = new CosmosClient(     accountEndpoint: "https://myaccount.documents.azure.com:443/",
  • Network accessline 44
    var client = new CosmosClient(     accountEndpoint: "https://myaccount.documents.azure.com:443/",     tokenCredential: new DefaultAzureCredential()
  • Network accessline 45
    accountEndpoint: "https://myaccount.documents.azure.com:443/",
  • Network accessline 54
    credential = DefaultAzureCredential() client = CosmosClient("https://myaccount.documents.azure.com:443/", credential)
  • Network accessline 55
    client = CosmosClient("https://myaccount.documents.azure.com:443/", credential)
  • Network accessline 62
    const credential = new DefaultAzureCredential(); const client = new CosmosClient({     endpoint: "https://myaccount.documents.azure.com:443/",
  • Network accessline 63
    const client = new CosmosClient({     endpoint: "https://myaccount.documents.azure.com:443/",     aadCredentials: credential
  • Network accessline 64
    endpoint: "https://myaccount.documents.azure.com:443/",
  • Network accessline 73
    CosmosClient client = new CosmosClientBuilder()     .endpoint("https://myaccount.documents.azure.com:443/")
  • Network accessline 74
    .endpoint("https://myaccount.documents.azure.com:443/")
  • Network accessline 94
    Reference: [DefaultAzureCredential Class](https://learn.microsoft.com/dotnet/api/azure.identity.defaultazurecredential)

skills/cosmosdb-best-practices/rules/security-network-restrict.md

  • Network accessline 59
    Reference: [Configure IP firewall in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/how-to-configure-firewall)

skills/cosmosdb-best-practices/rules/security-private-endpoint-dns.md

  • Network accessline 152
    **Option 3: Allow only the published Azure portal middleware IPs.** This is a narrow allowlist of portal-only addresses. Microsoft publishes the current list per API and cloud environment in [Allow requests from the Azure portal](https://le
  • Network accessline 193
    // Same connection string before and after private endpoint var client = new CosmosClient(     "https://myaccount.documents.azure.com:443/",
  • Network accessline 194
    var client = new CosmosClient(     "https://myaccount.documents.azure.com:443/",     tokenCredential: new DefaultAzureCredential()
  • Network accessline 195
    "https://myaccount.documents.azure.com:443/",
  • Network accessline 201
    References: - [Configure private endpoints for Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/how-to-configure-private-endpoints)
  • Network accessline 202
    - [Configure private endpoints for Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/how-to-configure-private-endpoints)
  • Network accessline 203
    - [Azure Private Endpoint DNS configuration](https://learn.microsoft.com/azure/private-link/private-endpoint-dns)
  • Network accessline 204
    - [Troubleshoot Azure Private Endpoint connectivity](https://learn.microsoft.com/azure/private-link/troubleshoot-private-endpoint-connectivity)

skills/cosmosdb-best-practices/rules/security-rbac-least-privilege.md

  • Network accessline 73
    Reference: [Use data plane role-based access control with Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/security/how-to-grant-data-plane-role-based-access)

skills/cosmosdb-best-practices/rules/throughput-autoscale.md

  • Network accessline 120
    Reference: [Autoscale throughput](https://learn.microsoft.com/en-us/azure/cosmos-db/provision-throughput-autoscale)

skills/cosmosdb-best-practices/rules/throughput-burst.md

  • Network accessline 82
    Reference: [Burst capacity](https://learn.microsoft.com/azure/cosmos-db/concepts-limits#throughput-limits)

skills/cosmosdb-best-practices/rules/throughput-container-vs-database.md

  • Network accessline 99
    Reference: [Throughput on containers vs databases](https://learn.microsoft.com/azure/cosmos-db/set-throughput)

skills/cosmosdb-best-practices/rules/throughput-idle-container-review.md

  • Network accessline 10
    A container on **dedicated (provisioned) throughput** still bills for that throughput at near-zero traffic: **manual** bills its full RU/s 24/7, and **autoscale** [bills each hour for the highest RU/s it scaled to that hour](https://learn.m
  • Network accessline 46
    Reference: [Time to Live (TTL) in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/time-to-live)

skills/cosmosdb-best-practices/rules/throughput-right-size.md

  • Network accessline 94
    Reference: [Estimate RU/s](https://learn.microsoft.com/azure/cosmos-db/estimate-ru-with-capacity-planner)

skills/cosmosdb-best-practices/rules/throughput-serverless-migration.md

  • Network accessline 53
    References: - [Serverless in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/serverless)
  • Network accessline 54
    - [Serverless in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/serverless)
  • Network accessline 55
    - [Change from serverless to provisioned throughput](https://learn.microsoft.com/azure/cosmos-db/how-to-change-capacity-mode)

skills/cosmosdb-best-practices/rules/throughput-serverless.md

  • Network accessline 96
    Reference: [Serverless in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/serverless)

skills/cosmosdb-best-practices/rules/throughput-ttl-stale-data.md

  • Network accessline 56
    Reference: - [Time to Live (TTL) in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/time-to-live)
  • Network accessline 57
    - [Time to Live (TTL) in Azure Cosmos DB](https://learn.microsoft.com/azure/cosmos-db/nosql/time-to-live)
  • Network accessline 58
    - [Partitioning and horizontal scaling — partition storage limits](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview)

skills/cosmosdb-best-practices/rules/tooling-cosmosdb-shell-setup.md

  • Network accessline 51
    Reference: [Cosmos DB Shell overview](https://learn.microsoft.com/azure/cosmos-db/shell/overview) · [Install Cosmos DB Shell](https://learn.microsoft.com/azure/cosmos-db/shell/install) · [MCP security](https://github.com/Azure/CosmosDBShell

skills/cosmosdb-best-practices/rules/tooling-cosmosdb-shell-target.md

  • Network accessline 64
    Reference: [Cosmos DB Shell commands](https://github.com/Azure/CosmosDBShell/blob/main/docs/commands.md) · [MCP integration](https://github.com/Azure/CosmosDBShell/blob/main/docs/mcp.md)

skills/cosmosdb-best-practices/rules/tooling-cosmosdb-shell-writes.md

  • Instruction override signalline 25
    **Incorrect (deleting by an assumed ID, relying on navigation, and trying to skip confirmation):**
  • Dangerous shell operationline 37
    rm order-123
  • Dangerous shell operationline 52
    rm order-123 --key=id --partition-key=customer-42 --database=MyDb --container=Orders --dry-run
  • Dangerous shell operationline 70
    rm order-123 --key=id --partition-key=customer-42 --etag '"00000000-0000-0000-0000-000000000000"' --database=MyDb --container=Orders
  • Dangerous shell operationline 82
    Reference: [Cosmos DB Shell rm command](https://github.com/Azure/CosmosDBShell/blob/main/docs/commands.md#rm), [MCP destructive command confirmation](https://github.com/Azure/CosmosDBShell/blob/main/docs/mcp.md#destructive-command-confirmat
  • Network accessline 82
    Reference: [Cosmos DB Shell rm command](https://github.com/Azure/CosmosDBShell/blob/main/docs/commands.md#rm), [MCP destructive command confirmation](https://github.com/Azure/CosmosDBShell/blob/main/docs/mcp.md#destructive-command-confirmat

skills/cosmosdb-best-practices/rules/tooling-emulator-setup.md

  • Network accessline 16
    azure:   cosmos:     endpoint: https://my-prod-account.documents.azure.com:443/
  • Network accessline 17
    cosmos:     endpoint: https://my-prod-account.documents.azure.com:443/     key: ${COSMOS_KEY}
  • Network accessline 18
    endpoint: https://my-prod-account.documents.azure.com:443/
  • Access to secretsline 19
    [Credential-related source omitted]
  • Network accessline 26
    azure:   cosmos:     endpoint: https://localhost:8081/
  • Network accessline 27
    cosmos:     endpoint: https://localhost:8081/     key: C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
  • Network accessline 28
    endpoint: https://localhost:8081/
  • Network accessline 38
    Reference: [Use the Azure Cosmos DB Emulator for local development](https://learn.microsoft.com/azure/cosmos-db/emulator)

skills/cosmosdb-best-practices/rules/tooling-vscode-extension.md

  • Network accessline 33
    Reference: [Azure Cosmos DB extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-cosmosdb)

skills/cosmosdb-best-practices/rules/vector-distance-query.md

  • Network accessline 134
    Reference: [VectorDistance](https://learn.microsoft.com/en-us/cosmos-db/query/vectordistance) | [.NET](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-dotnet-vector-index-query#run-a-vector-similarity-search-query) | [Python](https

skills/cosmosdb-best-practices/rules/vector-embedding-policy.md

  • Network accessline 118
    Reference: [.NET](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-dotnet-vector-index-query) | [Python](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-python-vector-index-query) | [JavaScript](https://learn.microsoft.com/

skills/cosmosdb-best-practices/rules/vector-enable-feature.md

  • Network accessline 90
    Reference: [.NET](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-dotnet-vector-index-query#enable-the-feature) | [Python](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-python-vector-index-query#enable-the-feature) | [Ja

skills/cosmosdb-best-practices/rules/vector-index-type.md

  • Network accessline 14
    **Vector Index Types:** - `flat`: Exact brute-force search with 100% recall. Use for exact search over small, focused candidate sets subject to the documented [505-dimension service limit](https://learn.microsoft.com/en-us/azure/cosmos-db/n
  • Network accessline 15
    - `flat`: Exact brute-force search with 100% recall. Use for exact search over small, focused candidate sets subject to the documented [505-dimension service limit](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/vector-search#vecto
  • Network accessline 19
    `quantizedFlat` and `diskANN` [require at least 1,000 indexed vectors](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/vector-search#vector-indexing-policies) before Cosmos DB uses the vector index. With fewer vectors, the query use
  • Network accessline 148
    Reference: [Vector indexing policies](https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/vector-search#vector-indexing-policies) | [.NET](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-dotnet-vector-index-query#create-a-vecto

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 297 facts

and 247 more

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativeManifest .claude-plugin/marketplace.json.claude/skills/<skill-name>/
CodexNativeManifest AGENTS.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md skills/cosmosdb-best-practices/SKILL.md.cursor/skills/<skill-name>/
Gemini CLINativeManifest gemini-extension.json.gemini/skills/<skill-name>/
GitHub CopilotNativeManifest .github/copilot-instructions.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/cosmosdb-best-practices/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

You might also use

wshobson/agents

Plugins, agents, skills, and commands for Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot, and Pi, written once in Markdown and adapted to each tool by g…

42.3kGitHub stars

davila7/claude-code-templates

Open-source registry and CLI for Claude Code components: agents, commands, skills, hooks, MCPs, settings and mods

33.2kGitHub stars

wesammustafa/Claude-Code-Quest

Claude Code guide in three levels, Beginner to Advanced: hands-on lessons with checked exercises, every volatile fact cited to its source. Independent community guide.

3.6kGitHub stars

scenario-labs/skills

Get production-ready images, video, audio, and 3D from any AI agent: skills that pick the right model, price before spending, and keep characters and brands consistent through the…

3.4kGitHub stars

nano-muse/nanoMuse

nanoMuse: an open-source personal agent for every device you own. One agent with a name and a look of its own that does things, keeps working while the app is closed, remembers yo…

3.3kGitHub stars

0xsline/OpenChatCut

Open-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.

3kGitHub stars