# Azure Cosmos DB Agent Kit

> Documentation index for AI assistants using the Azure Cosmos DB Agent Kit, a collection of Agent Skills for data modeling, partition keys, queries, and SDK usage.

This index covers the Agent Kit documentation, not the full Azure Cosmos DB documentation set. Skills provide guidance; installing them doesn't, by itself, authenticate an assistant to Azure or grant database access. Review generated recommendations and validate them in your environment.

## Guides

- [Overview](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/overview): Capabilities, quick start, and the distinction between skills and MCP servers.
- [Setup](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/setup): Installation paths, prerequisites, skill-discovery verification, and troubleshooting.
- [Usage](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/usage): Partition-key, query-optimization, and SDK-review recipes with validation steps.
- [Compatibility](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/compatibility): Assistant integration paths and context-loading limitations; not a certification of every host version.

## Markdown versions

- [Overview as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/overview?accept=text/markdown): Machine-readable overview.
- [Setup as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/setup?accept=text/markdown): Machine-readable installation instructions.
- [Usage as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/usage?accept=text/markdown): Machine-readable task recipes.
- [Compatibility as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/compatibility?accept=text/markdown): Machine-readable compatibility guidance.

## Project and documentation tools

- [Agent Kit repository](https://github.com/AzureCosmosDB/cosmosdb-agent-kit): Current skills, plugin manifests, and installation methods.
- [Microsoft Learn MCP server](https://learn.microsoft.com/en-us/training/support/mcp): Search official documentation, retrieve articles, and find code samples; doesn't provide access to database data.
- [Connect to Learn MCP in Visual Studio Code](https://learn.microsoft.com/en-us/training/support/mcp-get-started): Documentation-retrieval setup for compatible assistants.

## Optional

- [Contribution guidelines](https://github.com/AzureCosmosDB/cosmosdb-agent-kit/blob/main/CONTRIBUTING.md): How to contribute to the kit.
- [Release history](https://github.com/AzureCosmosDB/cosmosdb-agent-kit/blob/main/CHANGELOG.md): Changes to the kit.
- [Microsoft Learn crawler policy](https://learn.microsoft.com/robots.txt): Host-level crawler rules. This index doesn't change crawler permissions or content-use policy.