DynamoDb

Store AgentOS sessions, memory, knowledge, evals, and traces in Amazon DynamoDB.

DynamoDb implements the Db interface with DynamoDB tables for Agent, Team, and Workflow sessions, memories, knowledge, metrics, evals, cultural knowledge, traces, and spans. Tables are created on first use with the required global secondary indexes.

Parameter	Type	Default	Description
id	Optional[str]	-	The ID of the database instance. UUID by default.
db_client	Optional[Any]	-	The DynamoDB client to use.
region_name	Optional[str]	-	AWS region name.
aws_access_key_id	Optional[str]	-	AWS access key ID.
aws_secret_access_key	Optional[str]	-	AWS secret access key.
session_table	Optional[str]	-	The name of the session table.
memory_table	Optional[str]	-	The name of the memory table.
metrics_table	Optional[str]	-	The name of the metrics table.
eval_table	Optional[str]	-	The name of the eval table.
knowledge_table	Optional[str]	-	The name of the knowledge table.
culture_table	Optional[str]	-	The name of the cultural knowledge table.
traces_table	Optional[str]	-	The name of the traces table.
spans_table	Optional[str]	-	The name of the spans table.

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]]]