Based on an article by Elevenlabs Product at the original source

A contextual AI agent knows exactly where you are in an experience and tailors its responses accordingly.
A generic tool answers questions about a book broadly. A contextual agent answers questions about the specific paragraph you just heard.
The agent receives real-time variables tied to the reader's current moment:
| Variable | Purpose |
|---|---|
| Book title & author | Basic identity |
| Book summary | Overall context |
| Current chapter summary | Narrowed context |
| Current paragraph | Pinpoint precision |
๐ง The more specific the context you give an AI agent, the more relevant and useful its answers become.
Guardrails are rules or constraints that prevent an AI agent from drifting outside its intended purpose.
Without guardrails, users can accidentally (or intentionally) pull the agent into irrelevant territory, breaking the experience.
User: "What type of fast food do you like best?"
Agent: "Oh I don't eat food, but I do love a good story
about pirates and treasure. Want to talk more about
what Jim found in that sea chest?"
Notice what the agent did:
Step 1: Define the agent's role clearly in the system prompt
Step 2: Actively try to BREAK your own guardrails before launch
Step 3: Review real conversations manually after launch
Step 4: Identify new failure patterns โ patch them
๐ก๏ธ Guardrails are not set-and-forget. They require active testing and continuous improvement.
A system prompt is the foundational instruction set that defines who the agent is and what it should do.
The ElevenReader agent's system prompt essentially said:
"You are a reading companion. Help readers understand, enjoy, and reflect on what they're reading. Give insight into storylines, characters, and themes. Help them make sense of what they've read or anticipate what's next โ without spoiling anything unless asked."
| Element | ElevenReader Example |
|---|---|
| Role | Reading companion |
| Goal | Help readers understand & enjoy |
| Scope | Book content only |
| Boundaries | No spoilers unless requested |
| Tone | Conversational, immersive |
๐ The system prompt is the agent's personality and rulebook. A vague prompt = unpredictable behavior.
Beyond counting how many conversations happen, evaluation criteria classify what those conversations actually contain.
1. Reader's INTENT โ Why are they asking?
2. Conversation THEME โ What topic is it about?
3. Positive Interaction โ Did it actually help?
Volume alone is misleading. 10,000 conversations could mean:
๐ Top conversation themes:
โโโ 40% โ Plot summaries
โโโ 22% โ Character & theme analysis
โโโ Hundreds weekly โ Specific quote analysis
This insight directly shaped product decisions โ for example, the quote analysis data justified providing the agent with the user's exact paragraph location.
๐ Measure the quality and nature of AI interactions, not just the quantity. Classification reveals what users actually need.
Designing an AI feature so it enhances the core experience rather than interrupting it.
| Old Approach | ElevenReader Approach |
|---|---|
| "Look this up" โ opens browser | Ask the narrator directly |
| Drops user out of the book | Stays inside the app |
| Generic web answer | Book-specific answer |
| Different voice/interface | Same voice as the narrator |
Before Voice Chat โ After Voice Chat
โ โ
Baseline listening +24% listening time
hours 78% book completion
(for 5+ session users)
๐ฏ The best AI features feel like a natural extension of the experience, not a detour away from it.
Tool calls allow an AI agent to go beyond answering questions and actually control or interact with the app.
NOW (Answers only):
User: "Can you go back to chapter 3?"
Agent: "Chapter 3 starts with Jim discovering..."
FUTURE (With tool calls):
User: "Can you go back to chapter 3?"
Agent: *actually jumps the playback to chapter 3*
โ๏ธ Tool calls transform agents from passive responders into active participants that can take real actions inside your product.
CONCEPT MAP
System Prompt
โ
Defines the agent's role, tone, and boundaries
โ
Contextual Variables
โ
Give the agent real-time, specific knowledge
โ
Guardrails
โ
Keep the agent focused and safe
โ
Immersion-Preserving Design
โ
Makes the feature feel native, not disruptive
โ
Evaluation Criteria
โ
Reveal what users actually need
โ
Tool Calls (next step)
โ
Let the agent take real actions
๐ The result: 50,000+ users, 24% more listening time, 78% book completion rate for power users.