diff --git a/docs/docs/agent.md b/docs/docs/agent.md
index af1bdc36..c8334566 100644
--- a/docs/docs/agent.md
+++ b/docs/docs/agent.md
@@ -5,6 +5,7 @@ title: Agents
---
import CodeEmbed from '@site/src/components/CodeEmbed';
+import TypewriterTextarea from '@site/src/components/TypewriterTextarea';
# Agents
@@ -63,8 +64,26 @@ Once your agent is described in YAML, bringing it to life in Java takes only a c
-- **No boilerplate.** Just load and start chatting or calling tools.
-- The API takes care of wiring up LLMs, tool invocation, and instruction handling.
+The API takes care of wiring up LLMs, tool invocation, and instruction handling.
-Ready to build your own AI-powered assistant? Just write your YAML, implement the tool logic in Java, and go!
+Here's a sample interaction:
+
+
+Here's another one:
+
+