Async MongoDB for Team

Store team sessions and run history asynchronously in MongoDB with AsyncMongoDb.

AsyncMongoDb stores a Team's sessions and run history asynchronously in MongoDB. Use async Team methods such as arun() and aprint_response().

Usage

Provide either db_url or db_client. This example uses db_url.

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

uv pip install agno "pymongo>=4.9" openai ddgs

Set your OpenAI API key:

export OPENAI_API_KEY="your_openai_api_key_here"

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

Run MongoDB

Install Docker Desktop, then start MongoDB on port 27017:

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_team.py
import asyncio
from typing import List

from agno.agent import Agent
from agno.db.mongo import AsyncMongoDb
from agno.models.openai import OpenAIResponses
from agno.team import Team
from agno.tools.hackernews import HackerNewsTools
from agno.tools.websearch import WebSearchTools
from pydantic import BaseModel

db_url = "mongodb://mongoadmin:secret@localhost:27017"
db = AsyncMongoDb(db_url=db_url)

class Article(BaseModel):
    title: str
    summary: str
    reference_links: List[str]

hn_researcher = Agent(
    name="HackerNews Researcher",
    model=OpenAIResponses(id="gpt-5.2"),
    role="Gets top stories from HackerNews.",
    tools=[HackerNewsTools()],
)

web_searcher = Agent(
    name="Web Searcher",
    model=OpenAIResponses(id="gpt-5.2"),
    role="Searches the web for information on a topic",
    tools=[WebSearchTools()],
    add_datetime_to_context=True,
)

hn_team = Team(
    name="HackerNews Team",
    model=OpenAIResponses(id="gpt-5.2"),
    members=[hn_researcher, web_searcher],
    db=db,
    instructions=[
        "First, search HackerNews for what the user is asking about.",
        "Then, ask the web searcher to search for each story to get more information.",
        "Finally, summarize each story and include its reference links.",
    ],
    output_schema=Article,
    markdown=True,
    show_members_responses=True,
)

async def main():
    try:
        await hn_team.aprint_response(
            "Write an article about the top 2 stories on HackerNews"
        )
    finally:
        await db.close()

if __name__ == "__main__":
    asyncio.run(main())

Parameters

ParameterTypeDefaultDescription
idOptional[str]-Database ID. Derived deterministically from connection/client and database name when omitted.
db_clientOptional[Union[AsyncIOMotorClient, AsyncMongoClient]]-The MongoDB async client to use. Supports Motor and PyMongo async clients.
db_nameOptional[str]-The name of the database to use.
db_urlOptional[str]-The database URL to connect to.
session_collectionOptional[str]-Name of the collection to store sessions.
runs_collectionOptional[str]-Name of the collection to store session runs.
memory_collectionOptional[str]-Name of the collection to store memories.
metrics_collectionOptional[str]-Name of the collection to store metrics.
eval_collectionOptional[str]-Name of the collection to store evaluation runs.
knowledge_collectionOptional[str]-Name of the collection to store knowledge documents.
traces_collectionOptional[str]-Name of the collection to store traces.
spans_collectionOptional[str]-Name of the collection to store spans.
learnings_collectionOptional[str]-Name of the collection to store learnings.
schedules_collectionOptional[str]-Name of the collection to store cron schedules.
schedule_runs_collectionOptional[str]-Name of the collection to store schedule run history.

Run the Example

Save the code as async_mongodb_for_team.py, complete the prerequisites above, then run:

python async_mongodb_for_team.py