Async MongoDB for Agent

Agno supports using MongoDB asynchronously as a storage backend for Agents, with the AsyncMongoDb class.

Usage

You need to provide either db_url or db_client. The following example uses db_url.

Install the pymongo (4.9 or later), openai, and ddgs packages:

uv pip install "pymongo>=4.9" openai ddgs

motor clients are also supported, but motor is deprecated. Use PyMongo’s async client instead.

Run MongoDB

Install docker desktop and run MongoDB on port 27017 using:

docker run -d \
  --name local-mongo \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=mongoadmin \
  -e MONGO_INITDB_ROOT_PASSWORD=secret \
  mongo

async_mongodb_for_agent.py

import asyncio

from agno.agent import Agent
from agno.db.mongo import AsyncMongoDb
from agno.tools.websearch import WebSearchTools

# MongoDB connection settings
db_url = "mongodb://mongoadmin:secret@localhost:27017"

db = AsyncMongoDb(db_url=db_url)

agent = Agent(
    db=db,
    tools=[WebSearchTools()],
    add_history_to_context=True,
)

if __name__ == "__main__":
    asyncio.run(agent.aprint_response("How many people live in Canada?"))
    asyncio.run(agent.aprint_response("What is their national anthem called?"))

Params

Parameter	Type	Default	Description
id	Optional[str]	-	The ID of the database instance. UUID by default.
db_client	Optional[Union[AsyncIOMotorClient, AsyncMongoClient]]	-	The MongoDB async client to use. Supports Motor and PyMongo async clients.
db_name	Optional[str]	-	The name of the database to use.
db_url	Optional[str]	-	The database URL to connect to.
session_collection	Optional[str]	-	Name of the collection to store sessions.
memory_collection	Optional[str]	-	Name of the collection to store memories.
metrics_collection	Optional[str]	-	Name of the collection to store metrics.
eval_collection	Optional[str]	-	Name of the collection to store evaluation runs.
knowledge_collection	Optional[str]	-	Name of the collection to store knowledge documents.
culture_collection	Optional[str]	-	Name of the collection to store cultural knowledge.
traces_collection	Optional[str]	-	Name of the collection to store traces.
spans_collection	Optional[str]	-	Name of the collection to store spans.
learnings_collection	Optional[str]	-	Name of the collection to store learnings.
schedules_collection	Optional[str]	-	Name of the collection to store cron schedules.
schedule_runs_collection	Optional[str]	-	Name of the collection to store schedule run history.