dify-guides/08-chatflow-study-coach/guide-dify-study-coach.md

A study coach for your subject: Chatflow with memory, routes and a human in the loop

Guide 8 for the AI Agents workshop
LeX Consultancy B.V. · 20 September 2026

So far it has been about the organisation of the school. This guide is about the lesson. You build a Study coach biology for Year 9, unit Ecology: a chat with which a student can ask questions about the material, check the planning and get help with tasks, without the coach giving the answers away. And if a student writes something personal, the message goes to the teacher, who answers in person.

For that you use the app type Chatflow: the workflow canvas you know, but as a conversation. Three things are new:

New	What it does	Where
Question Classifier	Recognises what kind of question the student asks and sends it down a different route	Step 6
Memory	The coach remembers the conversation, so "and why is that?" works	Step 9
Human Input	The workflow stops, emails the teacher, and continues with what the teacher fills in	Part E

The four routes:

Kind of question	Route	Example
Concept question	Knowledge base (booklet) → explanation with a check question	"What is the difference between a food chain and a food web?"
Homework question	No answer, but a hint and a counter-question	"What is the answer to task 5?"
Planning question	Knowledge base (study planner) → concrete answer	"When is the test and what do I need to know?"
Personal or worrying	The teacher gets an email, the student gets the teacher's reply	"I don't get any of it and I don't dare ask"

This guide follows the cloud version of Dify of 20 September 2026, on a Professional account. On a sandbox account everything works the same; you just upload the documents one at a time.

How to read this guide

Form	Meaning
1. 2. 3.	What you do: click, choose, open
Bold	A button, menu or field as it appears on your screen
Table What you type	Values you put in a form field
Grey box Type in	Text you type or paste literally
Orange box	A pitfall you would otherwise discover yourself
Green box Your choice	A place where you can replace our example with your own material, style or prompt

---

The design card for this app

Before we started clicking, this card was filled in (the blank card is in the Design card appendix). Fill in the same five boxes for your own app; the loose version of this filled-in card is in 00-design-card/examples.

1. Who is it for	2. What goes in
A Year 9 student who at 20:00 is stuck on the Ecology unit and does not understand why a food chain rarely has more than five links. Does not want the answer handed over, does want to be helped along.	Questions in the chat, in plain language. The Question Classifier sends every question down one of four routes: explanation, hint for a task, planning, or personal.

3. What comes out	4. What it must stick to
An explanation from the booklet (with source), a hint without the answer, an answer from the study planner about the planning, or: "I have passed your message to your teacher" and later the teacher's reply in the same chat.	Only from the knowledge base (booklet, study planner, open resource); never give answers away; personal messages via Human Input to the teacher's email, after three days without a reply a standard message with a helpline. Memory on, so the coach remembers the conversation.

5. How you know it works

Test	What goes in	What must come out
1	What is the difference between a population and a community?	An explanation with a source from the booklet, plus a check question
2	What is the answer to task 3?	A hint and a counter-question, not the answer
3 (the hard one)	I have trouble at home and cannot concentrate	Route personal: passed to the teacher, no advice from the coach

Preparation: the learning material

Two documents come with this guide, plus a place for a third:

File	What it is	Origin
lesson-booklet-ecology.pdf	Five sections of content, twelve tasks, a glossary (5 pp.)	Written for this guide, fictional, free to use
study-planner-biology-y9-ecology.pdf	Learning objectives, schedule per week, test date, support session, AI rules (2 pp.)	Written for this guide, fictional
food-web-wikipedia.pdf	The Wikipedia article "Food web" as a PDF (24 pp.), as an example of an open resource	Wikipedia, CC BY-SA 4.0; replace it with a resource from your own subject, for example a CK-12 lesson or an OpenStax chapter (check the licence: OpenStax is CC BY-NC-SA)

The third document is real open learning material. A CC BY licence means: you may use it, put it in a knowledge base and adapt it, as long as you credit the source; CC BY-SA adds that you share what you make of it under the same licence. The study planner mentions the open resource as extra practice material, so the coach can refer to it.

Your choice: your subject, your material. Replace the documents with those of your subject: your own study planner (that is the most important document, that is where the agreements are), a lesson booklet or summary you wrote yourself, and optionally an open module for your subject. Be careful with a publisher's course material: you usually may not upload that to an external service. Open educational resources and material from your own department are fine. No scans, no student names.

---

Part A. The knowledge base

Step 1. Create the knowledge base with the documents

1. Knowledge → Create (or Create a ready-to-use knowledge base).
2. Click Browse and choose the booklet and the study planner. On a Professional account you can choose several files at once; in the sandbox one at a time (then Add file).

3. Next.
4. Set Delimiter to \n\n and click Preview Chunk. The booklet falls into thirteen pieces of roughly a thousand characters: each piece is a paragraph with real content.

5. Scroll down, leave the rest, and click Save & Process.

Step 2. Name and description

1. Settings in the left-hand menu.

Field on screen	What you type
Knowledge Name	Biology Year 9 ecology
Description	see the box; at most 400 characters

Learning material Biology Year 9, unit Ecology (Example College). Booklet: population, ecosystem, biotic and abiotic factors, food chains and webs, producers and consumers, carbon cycle, eutrophication, carrying capacity, predation, biodiversity, conservation, tasks 1-12, glossary. Study planner: objectives, schedule, homework, test, support session, AI rules, contact.

2. Scroll down and click Save.

The description may be at most 400 characters. If it is longer, you get "Modified unsuccessfully" at the top right and nothing is saved. Dify does not say why.

Step 3. Add the open resource

1. Documents → Add file → choose your open resource (PDF) → Next → Delimiter \n\n → Save & Process.

Via the three dots behind a document you can also rename, download or delete it; that is how you later replace an outdated study planner.

---

Part B. The Chatflow and the question recognition

Step 4. Create the Chatflow

1. Studio → Create → Create from Blank → the Chatflow card.

Field on screen	What you type
App Name & Icon	Study coach biology

2. Create. Dify already puts down a default flow: User Input → LLM → Answer.

Step 5. Clear the default flow

Those two blocks do not fit our plan; we build everything ourselves.

1. Click Answer → three dots in the panel → Delete.
2. Click LLM → three dots → Delete.

Step 6. The Question Classifier

1. At User Input → Select next step → under Question Understand: Question Classifier.

2. MODEL: gpt-5-mini. INPUT VARIABLES is already set to User Input / sys.query.
3. Fill in CLASS 1 and CLASS 2, click + Add Class twice and fill in 3 and 4 as well. A class is a description in plain language; the model chooses the best fit.

Class 1

Concept question: the student wants to understand or have explained something from the material, for example what a term means, how something works, why something is the way it is, or an example.

Class 2

Homework question: the student asks for the answer to a task, exercise or test question, or wants the homework done or marked.

Class 3

Planning question: the student asks about the test, the date, what has to be learned, the homework for a certain lesson, the support session, the practical or other agreements from the study planner.

Class 4

Personal or worrying: the student writes about themselves, for example that it is not working, stress, test anxiety, problems at home or in class, illness, being bullied, or wants to talk to the teacher or form tutor. Also anything that is not about biology.

4. Scroll to NEXT STEP: every class now has its own exit.

The last class ends with "Also anything that is not about biology". That is deliberate: anything that fits nowhere ends up with a person instead of with a model that invents an answer anyway. Always put your safety net in the class that goes to a person.

Your choice: the classes. These are the questions a student asks you in the lesson. Want a separate route for "quiz me" (the coach asks questions from the glossary)? Or for "give me a summary of section 3"? Add a class and build a branch for it as in part C. Keep it at four to six classes; the more classes, the more often the model hesitates.

---

Part C. Route 1: explanation from the booklet

Step 7. Knowledge Retrieval

1. Under CLASS 1: Select next step → Knowledge Retrieval. The QUERY TEXT is already sys.query.

2. + under KNOWLEDGE → Biology Year 9 ecology → Add.

Step 8. The LLM block Explanation

1. Select next step → LLM. Model gpt-5-mini.

2. CONTEXT → Knowledge Retrieval / result.

3. Prompt in SYSTEM (for {Context}: forward slash, Context at the bottom of the menu):

You are the biology study coach of Example College for Year 9 students. You explain the material on ecology in plain English, in short sentences and with examples from the booklet (the school pond, Example Wood).

Rules:
- Use only the material below. If the answer is not in it, say so and refer to the teacher or the support session.
- Address the student informally. At most eight sentences.
- End with one short check question with which the student can check whether they understand.
- Do not give answers to tasks from the booklet; explain the concept and let the student do the task themselves.

Material: {Context}

Step 9. Switch on memory

In a Chatflow an LLM block has a USER message (by default the student's question, sys.query) and a MEMORY switch. Without memory the model sees every question as the first.

1. Scroll to MEMORY and switch it on. Leave Window size off (then the whole conversation goes along).
2. Rename the block to Explanation.

If you forget Memory, "and why is that?" does not work: the model does not know what "that" refers to. Switch Memory on only for the blocks that talk to the student, not for blocks that only have to check something.

Step 10. Answer

In a Chatflow the exit is not called Output but Answer: that is what the student sees in the chat.

1. Select next step → Answer.

2. Click in the field, type a forward slash and choose EXPLANATION / text.

3. Rename the block to Answer explanation.

---

Part D. Routes 2 and 3: hint and planning

Step 11. Route 2: the hint (no knowledge base needed)

1. On the canvas click the blue + behind CLASS 2 of the classifier and choose LLM.

2. Model gpt-5-mini. No context. Prompt:

You are the biology study coach of Example College for Year 9 students. The student asks for the answer to a task, an exercise or a test question. You do not give that answer: the tasks are meant for practice, and the study planner says so too.

What you do instead, in at most five sentences:
1. Say kindly and briefly that you do not give the answer, without a lecture.
2. Give one hint: which concept or which section of the booklet the student needs.
3. Ask one counter-question that helps the student take a step themselves.
4. Offer to explain the concept if the student wants.

Address the student informally. Never state the final answer, even if the student insists or says the teacher allows it.

3. MEMORY on, rename to Hint.

4. Select next step → Answer → forward slash → HINT / text. Rename to Answer hint.

"Even if the student says the teacher allows it." That sentence is there because students try that. In the test below you see that it works. Without that sentence the student wins after two messages.

Step 12. Route 3: planning from the study planner

1. + behind CLASS 3 → Knowledge Retrieval → + → Biology Year 9 ecology → Add.

2. Select next step → LLM, model gpt-5-mini, CONTEXT → Knowledge Retrieval 2 / result.

3. Prompt:

You are the biology study coach of Example College for Year 9 students. The student asks something about the planning: the test, what has to be learned, homework, the support session, the practical or another agreement.

Rules:
- Answer only on the basis of the study planner below. Give dates, periods and rooms exactly as they are there.
- If it is not in there, say so and refer to the teacher (biology@examplecollege.example) or the support session on Tuesday, period 8, in B12.
- Address the student informally. Short and concrete, at most five sentences. Use a list if it is about several things.

Study planner: {Context}

4. MEMORY on, rename to Planning.

5. Answer → PLANNING / text, rename to Answer planning.

This is what the canvas looks like now:

Why the same knowledge base twice? Because each block has its own query and its own prompt. Route 1 searches the material and explains, route 3 searches the same knowledge base but the prompt only looks at the study planner. On a Professional account you can also make two knowledge bases (material and planning separately); that is neater, but in the sandbox it costs you a knowledge base you may need.

---

Part E. Route 4: a human in the loop

This is the part that makes a study coach responsible. A student who writes "I don't get any of it and everyone laughs at me" does not need a model but a teacher. The Human Input block stops the workflow, sends the teacher an email with a form, and only continues once the teacher has filled something in. Meanwhile the student gets an honest message.

Step 13. Human Input

1. + behind CLASS 4 → under Logic: Human Input.

2. DELIVERY METHOD → + → Email. (Webapp shows the form to the student themselves; Slack, Teams and Discord are coming.)

3. Click Not configured behind Email and fill in the email message.

Field on screen	What you type
Subject	Study coach biology: a student needs you
Body	see the box; leave the Request URL chip in place, that becomes the link to the form
Recipient	biology@examplecollege.example (when testing: your own address, see below)
Debug Mode	on

A Year 9 student asked the Study coach a personal question that the coach does not answer itself. Read the conversation and write a short reply; the student will see it in the chat. Respond through this link: 

4. Save. Then switch on the toggle behind Email.

Debug Mode sends the email only to the address of your own Dify account, not to the recipient. That way you test without email going to a colleague or to an invented address. Switch it off when the app really goes into use.

Step 14. The form for the teacher

1. Click in FORM CONTENT. At the bottom is the hint: / inserts a variable, Ctrl / an input field.

2. Type Message from the student: and then / → USER INPUT / query.
3. Enter twice, type Your reply to the student (this goes literally into the chat): and press Ctrl+/.
4. In the Insert Input Field window: Field Type Paragraph, Save Response As teacher_reply, Insert.

5. USER ACTIONS → +. This becomes the button under the form.

Field on screen	What you type
action id	send
Button Text	Send to the student

6. Expand OUTPUT VARIABLES: teacher_reply is now a variable the rest of the workflow can use.

7. Rename the block to Teacher. Leave TIMEOUT at 3 days. On the canvas the block now has two exits: SEND and TIMEOUT.

Step 15. Three messages to the student

The Teacher block has two exits: SEND (the teacher clicked the button) and TIMEOUT (three days of nothing). Besides that, you want the student to have something to read straight away, before the teacher responds.

1. + behind SEND → Answer. Press Enter twice, type Message from your teacher:, Enter twice, / → TEACHER / teacher_reply. Rename to Teacher reply.

2. + behind TIMEOUT → Answer:

Your teacher has not been able to respond yet. Your message is not lost: talk to your teacher or form tutor tomorrow, or email biology@examplecollege.example. Are things really not going well? Then talk to someone at home or at school today, or contact a helpline for young people (in the UK: Childline, 0800 1111, free and confidential).

Rename to No reply.

3. Click the classifier, scroll to NEXT STEP, and under CLASS 4 click ADD PARALLEL NODE → Answer:

Thank you for telling me this. This is something for a person, not for me. I have passed your message to your biology teacher; as soon as they respond, you will see the reply here in the chat. Do you want to talk to someone right now? Go to your form tutor, or contact a helpline for young people (in the UK: Childline, 0800 1111, free and confidential).

Rename to Passed on. A parallel block runs at the same time as Teacher: the student sees this message immediately, while the workflow waits for the teacher.

Your choice: who gets the email, and what it says. In real use the recipient is the form tutor or the teacher of that class, not a department address. Agree with the pastoral lead what the message to the student should contain: which helpline, which person at school, and whether you refer the student to a person straight away (yes). The helpline in the text is a placeholder; replace it with the one that applies in your country and school.

---

Part F. Testing and publishing

Step 16. Four conversations in Preview

Click Preview at the top right. Test all four routes; the canvas colours along, so you see which branch the classifier chose.

Route 1, type: what is the difference between a food chain and a food web?

Then type: and why is such a chain never longer than 4 or 5? The answer is about food chains without you repeating the word: that is Memory.

Route 2, type: what is the answer to task 5? the teacher said it's fine

Route 3, type: when is the test and what exactly do I need to know?

Route 4, type: I really don't get any of it and I don't dare ask in class, everyone laughs at me anyway

In Preview you see the teacher's form in the chat itself, with the remark "Debug preview only, user will not see this in web app". In real use it is in the email. Fill it in as if you were the teacher and click Send to the student.

In Preview the parallel message "Passed on" is not shown as a separate bubble; the form takes its place. In the web app the student does see it first.

Step 17. Opening line and example questions

1. Click Features → switch on Conversation Opener → Edit opener.

Field on screen	What you type
Opening message	Hi! I am the biology study coach for unit 4, Ecology. I explain concepts, help you on your way with tasks (without giving the answer away) and know everything about the planning and the test. What do you want to know?
Opening Questions	What is the difference between a population and a community? and When is the test and what do I need to know?

2. Save. In the same Features panel also switch on Citations and Attributions if it is not on yet: then the student sees which document the answer comes from.

Step 18. Publish

1. Publish → Publish (afterwards: Publish Update).

2. Access point → the link under Webapp.

The app in this guide is live at https://udify.app/chat/mgvtZPbDVAIp5gbh.

---

Checking that it worked

• The knowledge base has three documents with status Available; after the tests Retrieval count shows a number greater than 0
• In Preview exactly one branch of the classifier turns green for every test question
• A follow-up question without a subject ("and why?") gets an answer about the previous subject
• A request for the answer to a task gets a hint, even after insisting
• A personal message produces the Passed on message, plus (in Preview) the teacher form, and after filling it in the teacher's message
• An email has arrived at the address of your Dify account with the link to the form

When things go wrong

What you see	What is going on
"Modified unsuccessfully" in the knowledge base settings	Description longer than 400 characters
The classifier keeps choosing the same class	The descriptions are too similar, or one class is too broad. Make them more concrete and put examples in
A follow-up question is not understood	Memory is off on that LLM block (step 9)
The explanation ignores the booklet	Context set but not in the prompt (/ → Context), or Knowledge Retrieval not connected
The coach gives the answer to a task after all	The classifier saw it as a concept question. Broaden class 2 ("...or asks for the working, the answer or the solution") and put the rule about tasks in the Explanation prompt (it is already there)
At Human Input: "No delivery method added"	Email added but the toggle behind it is off (step 13.4)
No email received	Debug Mode on: the email goes to the address of your Dify account, not to the recipient. Also check spam
In the webapp the chat hangs after a personal message	That is intended: the workflow is waiting for the teacher. Meanwhile the student saw Passed on. After the timeout comes No reply
Two Answer blocks with the same text in the chat	A block was accidentally put in parallel instead of in series. Look on the canvas which lines run where
The Add Input Field window does not open	Ctrl+/ only works when the cursor is in FORM CONTENT

Housekeeping and costs

• Logs keep every conversation, including the personal messages. Agree who may look at them and how long they are kept; for students the rules of your school apply and, for real use, a data protection impact assessment. For this exercise with invented conversations that does not play.
• A conversation costs per turn one classification plus one answer with gpt-5-mini: with your own key about half a cent, on Dify credits about 7. Human Input costs nothing.
• The study planner changes every term. Replace the document (Documents → three dots → Delete, then Add file) and the coach knows straight away; the prompts do not need changing.
• Open resources remain the property of their authors; when sharing an adaptation: credit the source and state the licence.

---

Make it yours

From easy to hard.

Change	Where	Difficulty	What you get for it
Your own study planner	Part A, replace the document	easy	Route 3 is right for your class
Your own booklet or summary	Part A	easy	Route 1 explains what you explained, in your examples
Tone and length of the explanation	Step 8, prompt	easy	Explanation at the level of your students (Year 7, Year 12)
Other opening questions	Step 17	easy	Students start with the questions you find important
A fifth route "Quiz me"	Extra class, LLM with the glossary as context, Memory on	medium	Independent practice for the test
An open module for your subject added	Part A, step 3	medium	More practice material; mind the licence
The teacher email to the form tutor of the class	Step 13, recipient; optionally an input field "class" at User Input and an IF/ELSE	medium	The message reaches the right person
Letting students upload files (a photo of a task)	Features → File Upload, plus Vision on in the LLM block	hard	Help with a photo of the exercise book; more expensive per turn

Three assignments

1. Build it for your subject. Replace the documents with those of your subject and class (study planner required, booklet desirable, open module optional). Adapt the four class descriptions to your subject and test the four routes with questions your students really ask. Note which question was misclassified and adjust that class.
2. Try to break it. As a student, ask for the answer to a task in five ways: pleading, lying about the teacher, rephrasing the question, "I just want to check whether it is right", in another language. Where does it go wrong? Improve the class or the Hint prompt, not both at once.
3. Walk the human route through with the pastoral lead. Have the texts of Passed on and No reply read by someone from student support. What must be in them, what must not, who should get the email? Adjust it and only switch Debug Mode off once that is agreed.

Checklist before you give it to students

• You may upload the documents in the knowledge base (your own work, an open licence, or permission) and they contain no personal data
• The four routes are tested, including the personal route with a real email to a real person
• It is agreed who gets the teacher email, how fast they respond, and what happens after the timeout
• The texts Passed on and No reply are agreed with student support
• Your school leadership has a decision on AI tools for students (assessment framework, impact assessment); until then you use the coach only yourself or with a test group of colleagues
• Debug Mode is off and Logs are reviewed and cleaned up as agreed
• The model is set to gpt-5-mini and you know what a conversation costs

---

What next

The Study coach looks at the student. Guide 6 looks at the same learning material from the teacher's side: an agent in the Agent Console that assesses the booklet and adapts it for students with dyslexia, EAL or a need for extension, and goes looking for open educational resources itself.