Skip to main content

​
Overview

Echoes of the Past offers interactive quizzes that test your knowledge about historical figures through AI-powered voice conversations. After completing a quiz, you receive detailed feedback analyzed by AI.

​
Access Quizzes

Navigate to the quiz section and browse available quizzes.
1

Navigate to Quizzes Page

From the main dashboard, go to /app/quizzes.Screenshot description: The quizzes page displays “Historical Figures Quiz” as the heading with a “Create Quiz” button in the top-right corner.
2

Browse Available Quizzes

The page shows a list of all available quizzes:
  • Each quiz is associated with a specific historical figure
  • Quizzes display the figure’s image and information
  • Click on any quiz to view details or start
3

Create a New Quiz (Optional)

To create a quiz for a historical figure:
  • Click the “Create Quiz” button
  • You’ll be redirected to /app/quizzes/create
  • Select a historical figure
  • Choose between AI-generated or manual quiz creation

​
Create an AI-Generated Quiz

Generate quiz questions automatically using AI.
1

Select Historical Figure

On the create quiz page:
  • Browse or search for a historical figure
  • Click on the figure you want to create a quiz about
2

Choose Difficulty Level

The AI quiz interface presents three difficulty options:Easy:
  • Icon: Lightbulb
  • Description: “Basic questions about key facts”
  • Color: Green background
Medium:
  • Icon: Brain
  • Description: “Moderate complexity and detail”
  • Color: Blue background
Hard:
  • Icon: Trophy
  • Description: “Advanced knowledge required”
  • Color: Purple background
Screenshot description: Three cards displayed in a grid, each with an icon, difficulty label, and description. Selected difficulty shows a ring border.
3

Generate Questions

After selecting difficulty:
  • Click the “Continue” button
  • The system displays “Generating Questions…” with a loading spinner
  • AI generates questions based on the figure’s life, work, and achievements
  • Wait 5-10 seconds for generation to complete
4

Review Generated Questions

Once generated, you’ll see:
  • A list of AI-created questions
  • Each question appears in a bordered card
  • Options to edit or delete individual questions
  • “Change Difficulty” button to regenerate with different difficulty
5

Edit Questions (Optional)

To modify generated questions:
  • Click the “Edit” button (pencil icon) on any question
  • The text becomes editable in an input field
  • Make your changes
  • Click “Save” to confirm changes
6

Add Custom Questions (Optional)

To add additional questions:
  • Use the input field at the bottom: “Add a new question…”
  • Type your custom question
  • Click the “Add” button (plus icon)
  • The question is added to the list
7

Delete Questions (Optional)

To remove unwanted questions:
  • Click the “Delete” button (trash icon) on any question
  • The question is immediately removed from the list
8

Save and Start Quiz

When satisfied with your questions:
  • Click “Save & Continue” button at the bottom
  • Questions are saved to the database
  • You’re redirected to /app/quizzes/[id]/start to begin the quiz
You can change the difficulty level at any time before saving, which regenerates all questions with the new difficulty setting.

​
Answer Quiz Questions

Engage in a voice-based quiz conversation with the historical figure.
1

Start the Quiz

From the quiz detail page, click “Start” or navigate directly to /app/quizzes/[id]/start.The quiz interface loads with a split-screen layout similar to regular calls.
2

Understand Quiz Interface

The quiz call interface includes:Left Panel:
  • Historical figure’s avatar and name
  • Connection status
  • Audio visualization
  • Feedback button (unique to quizzes)
  • End call button
Right Panel:
  • Live transcript of questions and answers
  • Real-time conversation display
3

Wait for First Question

Once connected:
  • The historical figure introduces themselves
  • They present the first quiz question verbally
  • The question also appears in the transcript
  • Siri visualization shows when the AI is speaking
4

Provide Your Answer

Respond to each question verbally:
  • Speak your answer clearly into the microphone
  • Your response is transcribed in real-time
  • The AI processes your answer
  • Be as detailed or brief as appropriate for the question
5

Receive Next Question

After answering:
  • The historical figure may acknowledge your response
  • They proceed to the next question
  • Continue answering until all questions are covered
  • The AI adapts to your responses naturally
6

Complete All Questions

Progress through all quiz questions:
  • Questions are asked based on the generated/created list
  • System prompt guides the AI to ask all prepared questions
  • Conversation flows naturally like a real interview
Quiz conversations require good microphone quality for accurate transcription. Speak clearly and minimize background noise.

​
Receive AI Feedback

Get personalized analysis of your quiz performance.
1

End the Quiz Call

After answering all questions:
  • Click the End Call button (assistant button at bottom)
  • Call status changes to “INACTIVE”
  • The system prepares to generate feedback
2

Automatic Feedback Generation

The feedback process triggers automatically:
  • Feedback Button appears at the bottom of the interface
  • It shows a message square icon (speech bubble)
  • When the call ends, feedback generation begins automatically
  • Button displays loading spinner during generation
Screenshot description: A circular button with the MessageSquare icon, which changes to a spinning Loader icon during processing.
3

Wait for AI Analysis

The system analyzes your conversation:
  • Reviews the complete transcript of questions and answers
  • Evaluates your responses for accuracy and depth
  • Generates scores across multiple categories
  • Identifies strengths and areas for improvement
  • Processing takes 10-30 seconds depending on conversation length
4

Automatic Redirect

After feedback generation completes:
  • You’re automatically redirected to /app/analytics
  • Your new feedback appears in the analytics dashboard
  • Scores and insights are immediately visible
The feedback generation uses AI to provide detailed analysis. You cannot proceed until the feedback is generated and saved.

​
View Quiz Scores

Understand your performance metrics and feedback.
1

Navigate to Analytics

After feedback generation, you’re on the analytics page.Alternatively, manually navigate to /app/analytics at any time.
2

Review Overall Metrics

The analytics page displays four key metric cards:
  • Total Score: Overall interview performance (0-100)
  • Category Score: Average across evaluation categories
  • Strengths: Number of identified strong points
  • Areas to Improve: Number of identified improvement areas
Each card shows:
  • Current value
  • Trend indicator (↑ or ↓)
  • Trend percentage
  • Contextual message
3

Find Your Recent Quiz

In the “Recent Interviews” section on the left:
  • Quizzes are listed by completion date
  • Shows total count: “Recent Interviews (X)”
  • Each entry displays:
    • Historical figure’s avatar
    • Figure’s name
    • Quiz completion timestamp
    • Overall score
4

Select Quiz for Details

Click on a quiz entry to view detailed feedback:
  • On desktop: Details appear in the right panel
  • On mobile: Details open in a bottom sheet
The feedback card displays:
  • Historical figure information
  • Total score with visual indicator
  • Category-specific scores
  • Detailed strengths list
  • Detailed areas for improvement list
5

Analyze Category Scores

Review performance across different evaluation dimensions:
  • Each category shows a specific score
  • Categories vary based on the quiz and figure
  • Helps identify specific knowledge gaps
6

Read Strengths and Improvements

The feedback includes:Strengths:
  • Specific aspects where you performed well
  • Accurate answers or deep understanding
  • Positive patterns in your responses
Areas for Improvement:
  • Topics that need more study
  • Incomplete or inaccurate responses
  • Suggestions for knowledge enhancement

​
Quiz Feedback Structure

​
Quiz Best Practices

Preparation

Research the historical figure before taking the quiz to maximize your learning and score.

Clear Responses

Speak clearly and provide complete answers. Detailed responses receive better AI evaluation.

Question Variety

Mix difficulty levels when creating quizzes to challenge yourself appropriately.

Review Feedback

Study your feedback carefully to identify knowledge gaps and track improvement over time.

​
Troubleshooting

  • Verify the quiz was properly created and saved
  • Check that questions exist in the database for this figure
  • Refresh the page and try starting the quiz again
  • Ensure you have an active internet connection
  • Wait at least 30 seconds as AI analysis takes time
  • Check your internet connection during generation
  • Ensure the conversation had sufficient content to analyze
  • Verify you answered multiple questions (not just one)
  • Click the Edit button (pencil icon) to enable editing mode
  • Click Save after making changes to commit them
  • If editing fails, try deleting and re-adding the question
  • AI evaluation is based on transcript accuracy
  • Ensure microphone captured your full responses clearly
  • Review the conversation transcript for accuracy
  • Retake the quiz if transcription issues occurred
  • Verify the historical figure ID is valid
  • Check browser console for error messages
  • Ensure questions were saved before starting
  • Try creating the quiz again if problems persist

​
Next Steps

After completing quizzes:
  • View detailed analytics to track progress
  • Take quizzes about different historical figures
  • Challenge yourself with harder difficulty levels
  • Review feedback to improve knowledge areas
  • Compare scores across multiple quiz attempts

Build docs developers (and LLMs) love

Get started for freeTalk to us