Expand description
DynamoDB-backed checkpointer implementation for AWS deployments.
This checkpointer stores agent state in Amazon DynamoDB, providing:
- Fully managed, serverless persistence
- Automatic scaling and high availability
- Global table support for multi-region deployments
- Pay-per-request pricing with on-demand mode
§Table Schema
The checkpointer expects a DynamoDB table with the following schema:
- Primary Key:
thread_id
(String) - Attributes:
state
(Map/JSON) - The serialized agent stateupdated_at
(String) - ISO 8601 timestampttl
(Number, optional) - Unix epoch for automatic expiration
§Setup
Create the table using AWS CLI:
aws dynamodb create-table \
--table-name agent-checkpoints \
--attribute-definitions AttributeName=thread_id,AttributeType=S \
--key-schema AttributeName=thread_id,KeyType=HASH \
--billing-mode PAY_PER_REQUEST
Or use Terraform (see deploy/modules/dynamodb/
).
Structs§
- Dynamo
DbCheckpointer - DynamoDB-backed checkpointer for serverless AWS deployments.
- Dynamo
DbCheckpointer Builder - Builder for configuring a DynamoDB checkpointer.