MongoDb

Store sessions, memories, metrics, knowledge, evals, and traces in MongoDB.

MongoDb is a class that implements the Db interface using MongoDB as the backend storage system. It provides scalable, document-based storage for agent sessions with support for indexing and efficient querying.

Parameter	Type	Default	Description
id	Optional[str]	-	The ID of the database instance. UUID by default.
db_client	Optional[MongoClient]	-	The MongoDB client to use.
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.
runs_collection	Optional[str]	-	Name of the collection to store individual runs.
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.
traces_collection	Optional[str]	-	Name of the collection to store traces.
spans_collection	Optional[str]	-	Name of the collection to store spans.
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.
learnings_collection	Optional[str]	-	Name of the collection to store learnings.

​

Methods

​

upsert_sessions

Upsert multiple sessions in one method call.

Parameters:

• sessions (List[Session]): List of sessions to upsert
• deserialize (Optional[bool]): Whether to deserialize the sessions. Defaults to True
• preserve_updated_at (bool): Whether to keep the sessions' existing updated_at timestamps. Defaults to False

Returns: List[Union[Session, Dict[str, Any]]]

​

upsert_memories

Upsert multiple memories in one method call.

Parameters:

• memories (List[UserMemory]): List of memories to upsert
• deserialize (Optional[bool]): Whether to deserialize the memories. Defaults to True
• preserve_updated_at (bool): Whether to keep the memories' existing updated_at timestamps. Defaults to False

Returns: List[Union[UserMemory, Dict[str, Any]]]