DynamoDB Workflow Storage

Kern supports using DynamoDB as a storage backend for Workflows using the DynamoDb class.

Usage

You need to provide aws_access_key_id and aws_secret_access_key parameters to the DynamoDb class.

1from kern.agent import Agent
2from kern.db.dynamodb import DynamoDb
3from kern.models.openai import OpenAIResponses
4from kern.team import Team
5from kern.tools.hackernews import HackerNewsTools
6from kern.tools.hackernews import HackerNewsTools
7from kern.workflow.step import Step
8from kern.workflow.workflow import Workflow
9
10db = DynamoDb()
11
12# Define agents
13hackernews_agent = Agent(
14 name="Hackernews Agent",
15 model=OpenAIResponses(id="gpt-5.2"),
16 tools=[HackerNewsTools()],
17 role="Extract key insights and content from Hackernews posts",
18)
19web_agent = Agent(
20 name="Web Agent",
21 model=OpenAIResponses(id="gpt-5.2"),
22 tools=[HackerNewsTools()],
23 role="Search the web for the latest news and trends",
24)
25
26# Define research team for complex analysis
27research_team = Team(
28 name="Research Team",
29 members=[hackernews_agent, web_agent],
30 instructions="Research tech topics from Hackernews and the web",
31)
32
33content_planner = Agent(
34 name="Content Planner",
35 model=OpenAIResponses(id="gpt-5.2"),
36 instructions=[
37 "Plan a content schedule over 4 weeks for the provided topic and research content",
38 "Ensure that I have posts for 3 posts per week",
39 ],
40)
41
42# Define steps
43research_step = Step(
44 name="Research Step",
45 team=research_team,
46)
47
48content_planning_step = Step(
49 name="Content Planning Step",
50 agent=content_planner,
51)
52
53# Create and use workflow
54if __name__ == "__main__":
55 content_creation_workflow = Workflow(
56 name="Content Creation Workflow",
57 description="Automated content creation from blog posts to social media",
58 db=db,
59 steps=[research_step, content_planning_step],
60 )
61 content_creation_workflow.print_response(
62 input="AI trends in 2024",
63 markdown=True,
64 )

Params

ParameterTypeDefaultDescription
idOptional[str]-The ID of the database instance. UUID by default.
db_clientNone-The DynamoDB client to use.
region_nameoptional[str]-AWS region name.
aws_access_key_idoptional[str]-AWS access key ID.
aws_secret_access_keyoptional[str]-AWS secret access key.
session_tableoptional[str]-The name of the session table.
memory_tableoptional[str]-The name of the memory table.
metrics_tableoptional[str]-The name of the metrics table.
eval_tableoptional[str]-The name of the eval table.
knowledge_tableoptional[str]-The name of the knowledge table.
traces_tableoptional[str]-The name of the traces table.
spans_tableoptional[str]-The name of the spans table.