Design and implement Azure Cosmos DB solutions by using AI-assisted tools
Unlock the complete study guide + 25 practice exams totaling 1,500 questions.
Bundled into the existing Building AI Applications with Azure Cosmos DB premium course — no separate purchase.
14-day refund guarantee on one-time purchases and your first subscription charge.
Included in this chapter:
- Two AI-assisted tools: guidance vs live data access
- Installing and updating the Agent Kit
- How the Agent Kit activates and loads rules
- Inside the skill package
- The 12 rule categories
- Following recommended practices with assisted reviews
- Retrieval code: Vector Search and Full-Text Search rules
- Agent workflow patterns and the LangGraph async rule
- Developer Tooling and Monitoring & Diagnostics rules
- The MCP Toolkit's seven tools
- Deploying and securing the MCP Toolkit
- Exam traps: picking the right AI-assisted tool
Development guidance (Agent Kit) vs live data access (MCP Toolkit)
| Aspect | Agent Kit (development guidance) | MCP Toolkit (live data access) |
|---|---|---|
| What it gives the AI | Curated best-practice rules for Azure Cosmos DB code and design | Seven tools that query and search an existing account |
| Touches your database? | No: code suggestions and best practices only | Yes, read-only: query and search capabilities only |
| Where it lives | Installed locally in the development environment | An MCP server hosted on Azure Container Apps (Docker Compose or .NET for local development) |
| How you set it up | npx skills add AzureCosmosDB/cosmosdb-agent-kit | Clone the repository, deploy the infrastructure and server, then connect Microsoft Foundry or Visual Studio Code |
| How it is invoked | Activates automatically when you describe an Azure Cosmos DB task | The agent calls a named tool, such as get_recent_documents |
| Security model | None at runtime: it holds no database connection | Microsoft Entra ID tokens for callers; managed identity to reach Azure Cosmos DB |
Decision tree
Cheat sheet
Unlock with Premium — includes all practice exams and the complete study guide.
References
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/model-context-protocol-toolkit
- https://learn.microsoft.com/en-us/credentials/certifications/resources/study-guides/dp-420
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/setup
- https://learn.microsoft.com/en-us/python/api/azure-cosmos/azure.cosmos.containerproxy
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/usage
- https://learn.microsoft.com/en-us/azure/cosmos-db/request-units
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/compatibility
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/overview
- https://learn.microsoft.com/en-us/azure/cosmos-db/troubleshoot-request-rate-too-large
- https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/best-practice-dotnet
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/rag
- https://learn.microsoft.com/en-us/azure/cosmos-db/vector-search
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/full-text-search
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/hybrid-search
- https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/integrations
- https://learn.microsoft.com/en-us/azure/foundry/how-to/develop/langchain-agents
- https://learn.microsoft.com/en-us/azure/cosmos-db/change-feed-design-patterns
- https://learn.microsoft.com/en-us/azure/azure-functions/python-scale-performance-reference
- https://learn.microsoft.com/en-us/azure/cosmos-db/emulator