jbaruch/koog
Koog 1.0 idioms, gotchas, and scaffolding skills for Kotlin agents on the JVM
87
88%
Does it follow best practices?
Impact
87%
1.85xAverage score across 45 eval scenarios
Advisory
Suggest reviewing before use
task.mdevals/scenario-34/
Returning Users Lose Their Conversation
Problem/Feature Description
A developer is building a customer-support chatbot powered by a Koog 1.0 agent. They have a bug report from users: "When I come back tomorrow, the bot doesn't remember anything we talked about — I have to re-explain my whole problem from scratch."
The agent today is a plain AIAgent(...) invocation per HTTP request. Each authenticated user has a stable userId that the route handler already has in scope. The developer has a Postgres database available; the JDBC URL and credentials are in environment variables (DB_URL, DB_USER, DB_PASSWORD).
They asked for whichever Koog feature fits this.
Output Specification
Walk through what to install and how to wire it into the agent's invocation pattern. Produce the modified agent construction and the route/handler code as a single response, labeled.
evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
scenario-8
scenario-9
scenario-10
scenario-11
scenario-12
scenario-13
scenario-14
scenario-15
scenario-16
scenario-17
scenario-18
scenario-19
scenario-20
scenario-21
scenario-22
scenario-23
scenario-24
scenario-25
scenario-26
scenario-27
scenario-28
scenario-29
scenario-30
scenario-31
scenario-32
scenario-33
scenario-34
scenario-35
scenario-36
scenario-37
scenario-38
scenario-39
scenario-40
scenario-41
scenario-42
scenario-43
scenario-44
scenario-45
skills
add-observability
add-persistence
add-rag
add-structured-output
add-token-budgeting
add-tool
cache-llm-calls
define-prompt
domain-model-subtask-pipeline
references
enable-prompt-caching
handle-agent-events
manage-state
migrate-from-0-x
model-planner-subtasks
persist-chat-history
query-sql-from-agent
scaffold-agent
snapshot-and-restore
test-koog-agents
trace-agent-internals
use-attachments
use-functional-agent
use-llm-node-variants
use-planner
wire-a2a
wire-acp-server
wire-ktor-server
wire-mcp-server
wire-spring-boot