Introduction

Completed

Building an AI application on a database means writing several layers by hand: the connection code, the retrieval logic, the storage schema for whatever the agent needs to remember. A set of AI-assisted development tools for Azure Cosmos DB removes most of that work. Some of them connect an AI assistant directly to your data so it can explore a container while you design against it. Others package the storage and retrieval patterns a production AI application needs, so you attach a component instead of building one.

That work lands on the Contoso team the moment they start building a shopping assistant for their product catalog. The assistant has to answer questions that span many products, and it has to remember what a shopper told it three messages ago and three sessions ago. Hand-building both means a vector store, a document store, a summarization pipeline, and a retrieval loop that knows when one search pass isn't enough. The team has weeks, not months, and the catalog already lives in Azure Cosmos DB.

Choosing well matters more than knowing every method signature. Each tool solves a specific problem, carries its own setup cost, and leaves a defined set of decisions to you. Pick the wrong one and you inherit work the tool was meant to absorb.

This module first explains what each tool does and which problem it solves. You then connect an AI assistant to Azure Cosmos DB through a Model Context Protocol (MCP) server. Next, you explore durable agent memory with the Azure Cosmos DB Agent Memory Toolkit, a public-preview Python SDK. You also explore multistep retrieval with Agentic Retrieval, a product-owned Python reference implementation that you clone and adapt. Finally, you match each tool to an appropriate scenario and identify what the tool handles and what you must still design, secure, deploy, and operate.

MCP uses a language-independent protocol, so compatible assistants and agents can connect regardless of the language used to implement the client or server. The Agent Memory Toolkit and Agentic Retrieval are currently Python-based. Treat their APIs and implementation details according to their documented maturity rather than as built-in Azure Cosmos DB service capabilities.

By the end of this module, you can select the right AI-assisted development tool for an Azure Cosmos DB scenario and describe the boundary between what the tool handles and what you design.