Integration · Databases
AI agents for Azure Cosmos DB
Query items with Cosmos DB SQL, read, create, upsert, replace and delete items, and list databases and containers in an Azure Cosmos DB for NoSQL account, signed with the account's key.
- Actions
- 7
- Read
- 4
- Write
- 3
Actions
What your agents can do in Azure Cosmos DB
Query items with Cosmos DB SQL, read, create, upsert, replace and delete items, and list databases and containers in an Azure Cosmos DB for NoSQL account, signed with the account's key. The key reaches every database in the account; a read-only key keeps the tool to reads.
Read 4
Look things up. Nothing changes.
List databases
Lists the account's databases.
List containers
Lists the containers (collections) of a database with their settings.
Query items
Runs a Cosmos DB SQL query over a container's items, like SELECT * FROM c WHERE c.status = @status AND c.total > 100, with parameters like [{"name": "@status", "value": "open"}].
Get an item
Reads one item by its id and partition key value.
Write 3
Create, change or send.
Create an item
Adds an item (a JSON document) to a container.
Replace an item
Replaces a whole item by its id: item becomes the stored document, so include every property to keep (same id and partition key value).
Delete an itemDeletes data
Deletes one item by its id and partition key value, for good.
A person can approve first
Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything. Actions that delete data ask first by default.
Connection
How it connects
Connect it once in the console, then give it to the agents and workflows that need it.
Enter the sign-in details Azure Cosmos DB gives you for its API.
What you enter
- Primary key
Settings
- Account name
Kept safe
- Credentials are stored encrypted with your organization's own keys.
- They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
- Calls go only to the tool's own servers.
Ideas
Ideas to start with
Starting points made only from the actions above. Mix them with any other tool your agents can use.
- 01
Ask about your Azure Cosmos DB data
Ask a question in plain words. The agent can list databases, list containers or query items in Azure Cosmos DB, then answers with what it found.
- 02
Let an agent update Azure Cosmos DB
Have the agent create an item or delete an item in Azure Cosmos DB as part of a larger task. Turn on approval and a person signs off on each change first.
- 03
Share what it finds in Slack
Give one agent Azure Cosmos DB and Slack: it can list databases in Azure Cosmos DB and post a summary to a Slack channel in the same run.
Works well with
More Databases tools
- PostgreSQL5 actionsRead and query a PostgreSQL database directly: Amazon RDS and Aurora, Google Cloud SQL, Azure, Neon, Supabase, or your own server with a public address.
- MySQL5 actionsRead and query a MySQL database directly: Amazon RDS and Aurora MySQL, Google Cloud SQL, Azure, PlanetScale, or your own server with a public address.
- MongoDB7 actionsRead and query a MongoDB database directly: MongoDB Atlas (mongodb+srv) or your own server with a public address.
- BigQuery5 actionsRun SQL on BigQuery, browse datasets, tables and their columns, and stream rows into a table, in a Google Cloud project, signed in with the person's own Google account.
- Snowflake9 actionsRun read-only SQL in Snowflake and page through the results, and list databases, schemas, tables, columns and warehouses, through the SQL API with a programmatic access token or a key pair.
- Pinecone8 actionsSearch, add, read and delete vectors in a Pinecone index: similarity search by vector or by a stored record's ID, text search on indexes with integrated embedding, index statistics and the list of indexes in the project.
FAQ
Azure Cosmos DB and MyDeepAgents
Can MyDeepAgents connect to Azure Cosmos DB?
Yes. The Azure Cosmos DB connector has 7 actions: 4 read and 3 make changes. Your agents can call them as tools, and your workflows can run them as steps.
How do I connect Azure Cosmos DB?
Enter the sign-in details Azure Cosmos DB gives you for its API. You'll need: Primary key. The connection also asks for: Account name. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.
Can an agent change data in Azure Cosmos DB without asking?
Only if you let it. Each of the 3 actions that change data can be set to wait for a person's approval before it runs, and the one that deletes data asks first by default.
Can I use Azure Cosmos DB in workflows as well as agents?
Yes. Every Azure Cosmos DB action also works as a step in a workflow, and the same connection serves your agents and your workflows.
Early access
Put Azure Cosmos DB to work
Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.