Coach Playbook
Most activities run without problems. In late September 2026, only about 3 in every 100 activity attempts across the network had a minor issue reported. When one comes up, the aim is to get them working again quickly and to report the problem so it can be fixed.
Before running a session, coaches should test all the activities themselves with a student account in your center's training location.
Troubleshooting during a session
Getting an activity unstuck is often a matter of telling Colo and the AI Coach to move it along. We're working on making this smoother, but in the meantime, have the learner type one of these into the chat, in their own language:
| Situation | What to type |
|---|---|
| Not sure what to do next, or the chat went quiet | What do I need to do now? |
| The AI Coach seems to be waiting for them | I'm ready, let's continue. |
| They already did something, but the AI Coach doesn't move on | I've already done this, let's continue. |
| The AI Coach says the activity is finished, but progress isn't 100% | We haven't finished yet. The progress bar isn't at 100%. |
| Colo says it did something in its workspace, but nothing is there | Colo, please do it in your workspace. It's still empty. |
| Colo or the AI Coach says a tool is disabled | It's not disabled, please try again. |
| The AI answers in the wrong language | I don't understand, please answer in [language]. |
| The instructions are too long | Can you explain this step more briefly? |
Common issues
Can't type in the workspace, or the input is grayed out
Refresh and check where the learner is typing. In Bot Mod, the system-prompt and knowledge-base editors stay locked until they click Edit system prompt and clear chat.
If it persists: have them type "What do I need to do now?" in the chat. If that doesn't work, report it.
Colo or the AI Coach doesn't answer
Wait 10–15 seconds, then refresh.
If it persists: report it, and say if several learners are affected.
The Check or Submit button does nothing
Click once, wait a few seconds, then refresh.
If it persists: have them type "I've already done this, let's continue."
The activity says it's finished, but progress is below 100%
This happens most often in Bot Mod. Have the learner type "We haven't finished yet. The progress bar isn't at 100%."
If it persists: report it. If it's keeping them out of a workshop, see moving a learner forward.
Image generation fails
Click Try again in the workspace. Check that the step asks for an image, as some steps ask for a written description instead.
If it persists: if several learners are affected, the AI provider may be down. Report it and have the learner switch to another GenAI activity for now.
The workspace won't load
Hard refresh (Ctrl+Shift+R, or Cmd+Shift+R on a Mac), or close the tab and open the activity again.
If it persists: if it affects the whole group, report it as urgent.
The AI replies in another language
Have the learner type "I don't understand, please answer in [language]", once or twice.
If it persists: report it.
What you can do, and what TUMO support does
Move a learner past a broken step
Report it in Freshdesk with the learner's TUMO ID and the activity, and TUMO support will move them forward. While it's being fixed, the learner sees a "we're debugging the issue" screen. Once it's fixed, they refresh and continue from the next step. Nothing they did is lost.
Mark an activity as completed
If a learner finished but the activity isn't marked complete on Path, report it and TUMO support will complete it.
Let a learner into the workshop
If a platform problem is the only thing keeping a learner out of their Level 1 workshop, you can subscribe them to the workshop manually, as you would for any workshop. Then report the issue so their Path is corrected.
Restart an activity
The ability to restart activities is coming soon.
See where each learner is, and unblock them yourself
GenAI controls for coaches are planned for the Coach Tool. Until then, TUMO support can do it for you.
If the activity can't continue today
Coaches can't skip a step. If an activity is blocked and the steps above don't help:
- Report it (see below).
- Have the learner switch to another GenAI activity on their Path, or another activity in their skill area.
- When the problem is fixed, the learner returns to the blocked activity at the same step.
If something concerning comes up
If the AI says something inappropriate, or a learner shares something worrying, take a screenshot, stop the activity, follow your center's safeguarding procedure, and report it in Freshdesk as urgent.
How to report an issue
Open a ticket in Freshdesk and tag it GenAI. Include:
- The learner's TUMO ID and your center
- The activity name and roughly which step
- What happened, with a screenshot of the whole screen
- The date and approximate time
- Whether one learner or several are affected. If several are, mark it urgent.
When a learner describes a problem to the AI Coach in the chat, it's reported automatically, and many are fixed within minutes. Use Freshdesk when that doesn't work, when several learners are affected, or when the problem keeps coming back. Report problems even when you've found a workaround, so we can improve the platform.
Supporting learners
- Never give learners the answers. Help them think through their prompt instead of writing it for them.
- When a result disappoints, remind them that the AI works from what they tell it. They can change their prompt and try again.
- If instructions feel long, learners can ask the AI Coach to explain the step more briefly.
- Encourage learners to reply in their own words rather than copying the AI Coach's hints.
Building the platform together
Remember, we're building the Colearner platform together, and every piece of feedback helps. Let learners know the platform is new, their work is saved, and that if something doesn't work, you'll find another way to keep going. When the AI gets something wrong, it's a good moment to talk about why.