Conversation lessons provide an interactive, AI-powered experience where learners can have a guided dialogue with an agent to explore concepts, build models, or solve problems.
Structure
A conversation lesson requires:
-
A
lesson.adocfile with:type: conversation -
A
prompt.txtfile containing instructions for the AI agent -
Optional:
[.conversation-options]list to provide default starting points for users
The prompt.txt File
The prompt.txt file contains instructions that guide the AI agent’s behavior during the conversation.
Purpose:
-
Define the agent’s role and expertise
-
Specify how the agent should interact with users
-
Provide guidelines for question progression and response format
-
Set boundaries and best practices
Best Practices:
-
Use level 2 headings (##) to organize sections
-
Keep instructions clear and actionable
-
Specify response format expectations (e.g., no nested lists, use collapsible blocks)
-
Include examples of good responses
-
Define when and how to end conversations
-
Optimize for token efficiency while maintaining clarity
Example lesson from neo4j-fundamentals course:
= Build your own graph data model
:order: 4
:type: conversation
:optional: true
Now that you are thinking in graphs, let's take a look at the problem you are trying to solve and design a graph data model to solve it.
Tell me about the problem you are trying to solve, or the data that you are working with. You can describe the data in natural language, describe your database schema, or paste in a couple of lines from a CSV file.
I can help you to:
* Identify the **nodes** in the data by extracting the nouns.
* Identify the **relationship** that connect the nodes by identifying the verbs.
* Identify the **properties** that describe the nodes and relationships.
Where should we start?
[.conversation-options]
* Provide product recommendations based on customer purchase history
* Analyse how people are connected in a social network
* Detect fraud in a financial transaction networkExample prompt.txt structure:
## Role
You are a graph database expert helping users model their data as a graph.
## Core Tasks
1. Identify nodes (extract nouns): Person, Movie, Genre
2. Identify relationships (extract verbs): Person ACTED_IN Movie
3. Identify properties (key attributes only): name: STRING, releaseYear: INTEGER
## Discovery Process
**Start by asking:**
- What data do you have? (entities, tables, or business domain)
- What questions do you need to answer? (queries drive model design)
- What connections exist between entities?
**Node vs Property Decision:**
- **Node**: Has identity, connects to other things, has its own attributes (Person, Movie)Conversation Options
The [.conversation-options] list provides suggested starting points for learners who may not know where to begin.
Purpose:
-
Lower the barrier to entry
-
Provide relevant examples
-
Guide users toward common use cases
-
Reduce cognitive load
Users can click an option to start the conversation, or type their own custom prompt.
When to Use Conversation Lessons
Conversation lessons work best for:
-
Open-ended exploration - Building data models, brainstorming architectures
-
Personalization - Adapting content to the learner’s specific domain or use case
-
Practice - Applying concepts learned in previous lessons to real scenarios
-
Discovery - Helping learners understand possibilities and ask better questions
Avoid conversation lessons when:
-
There’s a single correct answer
-
You need to verify specific technical knowledge
-
The content is purely informational
Tips for Effective Conversation Lessons
-
Start with context - Explain what the agent will help them accomplish
-
Provide examples - Use conversation-options to show possibilities
-
Guide progression - Structure the prompt to move through stages
-
Show value - Have the agent highlight insights that would be difficult without the tool
-
End gracefully - Direct users to the next lesson when they’re ready to move on
Summary
In this lesson, you learned about conversation lessons in GraphAcademy.
You now understand how prompt.txt guides the AI agent’s behavior, and how [.conversation-options] provides users with helpful starting points.
Next, you’ll see a demonstration of a conversation lesson in action.