DynamoDB

Use DynamoDB for agent session storage and persistence.

Agno supports using DynamoDB as a database with the DynamoDb class.

Usage

Install the boto3 and openai packages:

uv pip install boto3 openai

To connect to DynamoDB, you will need valid AWS credentials. You can set them as 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.

dynamo_for_agent.py

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

# Setup your Database
db = DynamoDb()

# Setup your Agent with the Database
agent = Agent(db=db)

Params

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.