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, traces, and spans. Tables are created on first use with the required global secondary indexes.
| Parameter | Type | Default | Description |
|---|---|---|---|
id | Optional[str] | - | Database ID. Derived deterministically from explicit client or constructor region/key values when omitted. |
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. |
runs_table | Optional[str] | None | Storage name for individual runs. Defaults to agno_runs, or <session_table>_runs when a custom session name is supplied. |
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. |
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 upsertdeserialize(Optional[bool]): Whether to deserialize the sessions. Defaults toTruepreserve_updated_at(bool): Request preservation of the sessions' existingupdated_attimestamps; see adapter limitations below. Defaults toFalse
Returns: List[Union[Session, Dict[str, Any]]]
upsert_memories
Upsert multiple memories in one method call.
Parameters:
memories(List[UserMemory]): List of memories to upsertdeserialize(Optional[bool]): Whether to deserialize the memories. Defaults toTruepreserve_updated_at(bool): Request preservation of the memories' existingupdated_attimestamps; see adapter limitations below. Defaults toFalse
Returns: List[Union[UserMemory, Dict[str, Any]]]
Timestamp preservation by adapter
JsonDb, GcsJsonDb, FirestoreDb, RedisDb, DynamoDb, and InMemoryDb accept preserve_updated_at but do not forward it to their individual upserts. Their bulk methods replace timestamps even when it is True.
PostgresDb, SingleStoreDb, and ValkeyDb honor the flag. MySQLDb, SqliteDb, and MongoDb honor it on their optimized bulk path; their per-record fallback paths do not forward it. Verify timestamps when a migration depends on preserving them.