DynamoDB

DynamoDb stores Agent sessions and run history in DynamoDB.

Usage

Install the boto3 and openai packages:

uv pip install boto3 openai

Pass a configured DynamoDB client as db_client, or set all three environment variables:

AWS_REGION: The AWS region to connect to.
AWS_ACCESS_KEY_ID: Your AWS access key ID.
AWS_SECRET_ACCESS_KEY: Your AWS secret access key.

On first use, DynamoDb creates missing tables with provisioned capacity. The client or credentials must allow table creation and read/write operations.

dynamo_for_agent.py

from agno.agent import Agent
from agno.db.dynamo import DynamoDb

db = DynamoDb()

agent = Agent(db=db)

region_name, aws_access_key_id, and aws_secret_access_key accept the same values directly.

Parameters

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.

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Usage

Parameters

​Usage

​Parameters

Usage

Parameters