Structured LLM Conversations for Language Learning Video Calls

duolingo · Education · 2025 · source Agentic: yes · promotional bias: med · source-backed · extracted with prompt 0.5.6 (schema v2)

Generated from extraction.json — do not edit by hand. Every claim cites verbatim source evidence; stated means the quote directly asserts the claim, implied means it supports it indirectly.

Problem

Domain: AI-powered language-learning video conversations

Duolingo needed Video Call with Lily to produce natural spoken language practice that stays at the learner's CEFR level, preserves Lily's character voice, personalizes across sessions, and adapts mid-call without letting a general LLM roam freely.

Constraints:

Architecture

Duolingo structures Video Call with Lily around system instructions, a conversation blueprint, separate conversation-prep prompting for the first question, a main conversation prompt, a memory pipeline that extracts learner facts from transcripts, and mid-call evaluations that decide whether Lily should follow or abandon the planned topic.

Diagram confidence: explicit (topology described by the source).

flowchart LR
  learner["Learner"] --> lily_assistant["Lily assistant"]
  system_prompt["System prompt"] --> conversation_prep_prompt["Conversation prep prompt"]
  conversation_prep_prompt --> main_conversation_prompt["Main conversation prompt"]
  system_prompt --> main_conversation_prompt
  system_prompt --> lily_assistant
  main_conversation_prompt --> lily_assistant
  lily_assistant --> mid_call_evaluation["Mid-call evaluation"]
  learner_memory_facts["Learner memory facts"] --> system_prompt
  transcript_fact_extractor["Transcript fact extractor"] --> learner_memory_facts
Drag to pan · scroll or use +/− to zoom · reconstructed from the source's described component topology

Components

Component Role Interacts with
Learner User participating in spoken language practice. Lily assistant, Mid-call evaluation
System prompt Learning-designer-authored instructions controlling Lily's behavior, level, backstory, help behavior, and conversation structure. Conversation prep prompt, Main conversation prompt, Lily assistant, Learner memory facts
Conversation prep prompt Generates the first question separately so the main prompt is not overloaded. System prompt, Main conversation prompt
Main conversation prompt Runs the actual Lily conversation with greeting, opener, reactions, and call-ending control. Conversation prep prompt, Lily assistant, Mid-call evaluation
Lily assistant AI character that talks to the learner in the target language. Learner, Main conversation prompt, Mid-call evaluation
Learner memory facts List of facts extracted from prior call transcripts and passed into future system instructions. System prompt, Transcript fact extractor
Transcript fact extractor LLM step that extracts important learner facts after each call. Learner memory facts
Mid-call evaluation Runtime checks that decide whether learner turns should change Lily's plan. Main conversation prompt

Data flow

Before a call, the system prepares a first question at the learner's CEFR level and injects prior learner facts into Lily's instructions. The main conversation starts with a system-controlled greeting and opener, then Lily reacts to learner turns. During the call, mid-call checks inspect what the learner said and adjust the conversation direction; after the call, the transcript is summarized into memory facts for next time.

4 supporting quotes
“In all our calls, we provide the System with a robust set of instructions for how Lily should behave.”article, stated
“when your Video Call is ringing, that’s when the System is formulating the first question.”article, stated
“after Lily hangs up, we take the call’s transcript, show it to the LLM, and ask “What important information have we learned about the User?””article, stated
“we’ve since added an extra check that says “Does it seem like the learner wants to lead this conversation? If yes, ignore what you originally were going to talk about.””article, stated

Why this architecture

Duolingo splits conversation prep, main conversation, memory, and mid-call evaluation because one broad prompt can overload the LLM. Structured prompts let Lily maintain character, CEFR level, conversation shape, personalization, and learner-led adaptability without drifting.

3 supporting quotes
“we can’t just let the model roam freely. Instead, we use targeted instructions and a predictable structure”article, stated
“When we include the instructions for the first question with the instructions for the rest of the call, we can often overload the LLM”article, stated
“This prevents the call from going on forever.”article, stated

Models used: LLM · Video Call with Lily

Scale

Alternatives considered (roads not taken)

Let the LLM roam freely

Rejected because: Duolingo says targeted instructions and predictable structure are needed to ensure learning value and character consistency.

“we can’t just let the model roam freely. Instead, we use targeted instructions and a predictable structure”article, stated

Put first-question instructions into the main conversation prompt

Rejected because: Combining those instructions overloaded the LLM and produced undesirable results.

“we can often overload the LLM and get undesirable results—like sentences that are overly complex or missing the vocabulary provided in the Conversation Prep.”article, stated

Force Lily to stick to the planned topic

Rejected because: Learners sometimes want to lead the conversation, so the system now checks when to ignore the planned topic.

“Earlier this year, we saw that sometimes, learners didn’t want to talk about the subject that Lily was instructed to focus on.”article, stated

Patterns

prompt-chaining (conversation architecture)

Duolingo separates conversation prep, main conversation, memory extraction, and mid-call evaluation into distinct LLM prompt stages.

“And since we want everything fully baked, we prepare the first question on its own.”article, stated
“In the mid-call evaluation, the System looks at what you’ve said and asks Lily questions to keep the conversation engaging and on track:”article, stated

agent-memory (personalization)

The system extracts learner facts from prior transcripts and includes them in future calls for personalized follow-ups.

“The information gleaned is then added to a List of Facts. The updated list becomes part of the instructions that the System gives to Lily during your next call.”article, stated

structured-output-contract (prompt control)

The system uses a three-character System/Assistant/User structure and a conversation blueprint to constrain free-form LLM behavior.

“To achieve the right balance, we create a prompt (or set of instructions) for the LLM. You can think of the prompt like a conversation involving three characters:”article, stated
“Also, very importantly, we include a basic blueprint for the conversation. Though each conversation you have with Lily is unique, they all follow a similar format:”article, stated

Tradeoffs

Separate conversation prep from live conversation.

Chose Two-stage prompting over One large prompt for question generation and conversation management.

Rationale: Separating the first question avoids overload and preserves vocabulary, difficulty, and conversation quality.

“The first question is an important launchpad for the conversation. We want to get it right: It needs to be relevant to what you’re learning, it needs to be the right difficulty, and it needs to set the scene for a good conversation.”article, stated
“And since we want everything fully baked, we prepare the first question on its own.”article, stated

Use memory facts for personalization.

Chose Transcript-derived List of Facts over Stateless conversations.

Rationale: Memory allows Lily to reference prior learner facts and make calls feel personalized.

“That way, Lily might mention “How are your dogs doing?” or “Have you tried any good tacos lately?” to make the call seem personalized”article, stated

Gotchas (what bit them)

A single overloaded prompt degrades conversation quality.

Root cause: First-question generation and full conversation management ask the LLM to satisfy too many constraints at once.

Resolution: Prepare the first question separately and feed it into the main conversation prompt.

“When we include the instructions for the first question with the instructions for the rest of the call, we can often overload the LLM”article, stated
“And since we want everything fully baked, we prepare the first question on its own.”article, stated

Rigid topic plans can ignore learner intent.

Root cause: Learners may introduce a more meaningful topic than the planned focus.

Resolution: Add mid-call evaluations that let Lily follow the learner when appropriate.

“Earlier this year, we saw that sometimes, learners didn’t want to talk about the subject that Lily was instructed to focus on. You’d say “You won’t believe it, Lily! I just completed the entire Spanish course!” and Lily would respond “That’s nice. Have you heard about Swiss folk music?” 🫣”article, stated
“If yes, ignore what you originally were going to talk about.” We have high hopes for these mid-call evaluations, as the LLM is always working—even during the Video Call itself—to ensure a great experience.”article, stated

Evaluation

Duolingo reports qualitative product-learning checks: prompt overload symptoms, mid-call evaluation behavior, CEFR-level alignment, and conversation continuation/end controls.

Metrics: CEFR-level alignment. · Mid-call learner-lead detection. · Conversation length control after a certain number of turns.

“It needs to be at the appropriate CEFR level.”article, stated
“The first question isn’t the only one that matters—we want Lily to react dynamically throughout the call, at the drop of a hat!”article, stated

Outcomes

The article describes product architecture and design decisions, not usage volume, latency, or learning-outcome metrics.

“All this may seem complicated—because it is! As our team continues to tinker and as AI continues to forge new paths, we’re teaching Lily to meet you at your level and allow you to practice speaking without fear.”article, stated
“If yes, ignore what you originally were going to talk about.” We have high hopes for these mid-call evaluations, as the LLM is always working—even during the Video Call itself—to ensure a great experience.”article, stated