--- layout: Conceptual title: Azure Cosmos DB Agent Kit overview - Azure Cosmos DB | Microsoft Learn canonicalUrl: https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/overview uhfHeaderId: MSDocsHeader-NoSQL permissioned-type: public recommendations: true recommendation_types: - Training - Certification breadcrumb_path: ../../../breadcrumb/azure-nosql/toc.json feedback_system: Standard feedback_product_url: https://feedback.azure.com/d365community/forum/3002b3be-0d25-ec11-b6e6-000d3a4f0858 feedback_help_link_url: /answers/tags/187/azure-cosmos-db/ feedback_help_link_type: get-help-at-qna ms.service: azure-cosmos-db ms.subservice: nosql ms.reviewer: mjbrown ms.author: sasinnat author: sajeetharan description: Install Azure Cosmos DB Agent Kit skills for AI coding assistants to get guidance on partition keys, queries, SDK usage, and performance. ms.topic: feature-guide ms.date: 2026-10-16T00:00:00.0000000Z ms.update-cycle: 180-days ms.collection: - ce-skilling-ai-copilot ai-usage: ai-assisted locale: en-us document_id: baee27ba-4ba5-1cde-6c1b-0e04ba9ff9bb document_version_independent_id: baee27ba-4ba5-1cde-6c1b-0e04ba9ff9bb updated_at: 2026-10-29T12:08:00.0000000Z original_content_git_url: https://github.com/MicrosoftDocs/nosql-docs-pr/blob/live/azure/cosmos-db/gen-ai/agent-kit/overview.md gitcommit: https://github.com/MicrosoftDocs/nosql-docs-pr/blob/d544fbd677e5c098756dbf81dcc8b6ff167255c1/azure/cosmos-db/gen-ai/agent-kit/overview.md git_commit_id: d544fbd677e5c098756dbf81dcc8b6ff167255c1 site_name: Docs depot_name: Learn.azure-nosql page_type: conceptual toc_rel: ../../toc.json word_count: 516 asset_id: cosmos-db/gen-ai/agent-kit/overview moniker_range_name: monikers: [] item_type: Content source_path: azure/cosmos-db/gen-ai/agent-kit/overview.md cmProducts: - https://authoring-docs-microsoft.poolparty.biz/devrel/cd668c2f-f5b3-4573-8ad1-019570e3e2db spProducts: - https://authoring-docs-microsoft.poolparty.biz/devrel/cc82e69d-afbe-4554-9f4c-6705fc860c42 platformId: 9fa0f2fc-53be-9289-5a00-494c4bc266a9 --- # Azure Cosmos DB Agent Kit overview - Azure Cosmos DB | Microsoft Learn The Azure Cosmos DB Agent Kit is a collection of [Agent Skills](https://agentskills.io/) that gives AI coding assistants Azure Cosmos DB guidance for data modeling, partition keys, queries, and SDK usage. Use the kit when you build or review an application and want recommendations for performance, scalability, and cost. The kit is designed for assistants that load relevant skills on demand, rather than adding every rule to every prompt. You can find the skills and installation options in the [Agent Kit repository](https://github.com/AzureCosmosDB/cosmosdb-agent-kit). ## Quick start To get started, you need an AI coding assistant that supports Agent Skills and Node.js with npm and npx installed. 1. Install the kit: ```bash npx skills add AzureCosmosDB/cosmosdb-agent-kit ``` 2. Follow the installation prompts for your coding assistant. For other installation methods, see [Set up the Agent Kit](setup). 3. In your assistant, provide your data model and workload requirements, and try this prompt: ```text Use the Azure Cosmos DB Agent Kit to review my proposed partition key. Consider my query patterns, write distribution, and expected data growth. Explain the trade-offs and identify any missing information before recommending a key. ``` Review the response for recommendations tied to the workload information you provided. Check your host's skill-loading indicators, if available, to confirm that it loaded the relevant skill. For more task examples, see [Use the Agent Kit](usage). ## What the kit helps with The kit focuses on the decisions that affect performance, scalability, and cost: - Partition key selection. - Query optimization. - Data modeling. - Hot partition prevention. - SDK usage patterns. - Security and access patterns. - Indexing strategy. - Throughput and scaling. - Global distribution. - Developer tooling. - Monitoring and diagnostics. - Vector search. - Full-text search. - Design patterns. ## Agent skills and MCP servers Agent skills provide guidance. Installing the Agent Kit doesn't, by itself, authenticate your assistant to an Azure account or give it permission to query a database. Treat generated recommendations as suggestions to review and test, not as evidence of measured performance improvements. The [Microsoft Learn MCP server](/en-us/training/support/mcp) provides a separate capability: it lets compatible assistants search official documentation and retrieve articles. It doesn't provide access to your Azure Cosmos DB data. Database operations require separately configured tools and permissions. For host-specific considerations, see [Supported AI coding assistants](compatibility). ## AI tools Connect your coding agent to Microsoft Learn or read this article in your assistant. For a compact index of the guides and their Markdown versions, use the [Agent Kit documentation index (`llms.txt`)](llms.txt). This index is a discovery aid, not a crawler policy or a guarantee that an assistant retrieves the articles. > > **[Connect your AI agent](/en-us/training/support/mcp-get-started)** Set up Microsoft Learn MCP in Visual Studio Code. > > **[Read as Markdown](/en-us/azure/cosmos-db/gen-ai/agent-kit/overview?accept=text/markdown)** Open a text version to copy into your assistant. > > **[Ask ChatGPT](https://chatgpt.com/?hint=search&q=Read%20https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fazure%2Fcosmos-db%2Fgen-ai%2Fagent-kit%2Foverview%20and%20explain%20what%20the%20Azure%20Cosmos%20DB%20Agent%20Kit%20does.%20Cite%20the%20article%20and%20state%20if%20you%20cannot%20access%20it.)** Start a conversation about this article in ChatGPT. > > **[Ask Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fazure%2Fcosmos-db%2Fgen-ai%2Fagent-kit%2Foverview%20and%20explain%20what%20the%20Azure%20Cosmos%20DB%20Agent%20Kit%20does.%20Cite%20the%20article%20and%20state%20if%20you%20cannot%20access%20it.)** Start a conversation about this article in Claude. ChatGPT and Claude open external services with the public article URL and a starter prompt. You might need to sign in. If the assistant can't access the article, copy the Markdown text instead. These actions don't install the kit or grant database access. ## Watch the overview Watch a short introduction to the Agent Kit.