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

Refresh the learner's pageRefresh their tab, not your own. Their progress is saved, and they'll return to the same step.
Check where the learner is typingLearners talk to Colo and the AI Coach in the chat. The workspace is the panel where the task is done, and they can only type there when the step asks for it. Colo has its own workspace, which they can't edit.
Have the learner tell the AI Coach what's wrong, in the chatThis is usually the fastest fix. The AI Coach can often put the activity back on track itself, and when it can't, it reports the problem to TUMO's support system, which often resolves it within minutes. Have the learner refresh after a few minutes to check.

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:

  1. Report it (see below).
  2. Have the learner switch to another GenAI activity on their Path, or another activity in their skill area.
  3. 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.