Creating custom AI behaviours
Administrators and assistant administrators can create new AI behaviours to support discipline-specific or organisation-specific training, and so can authors and cohort leads unless your organisation has turned this off. Custom AI behaviours allow you to define how the avatar acts once, and then reuse it across many scenarios.
To create a custom AI behaviour:
- Go to Scenarios → AI behaviours
- Select Add AI behaviour
- Enter a name and description
- Choose Who can edit this AI behaviour?
- In the Avatar instructions section, describe how the avatar should play its role
- Select Create AI behaviour
Your new AI behaviour will appear under your organisation name on the AI behaviours page and can be used immediately when creating scenarios.

Basic settings
When creating an AI behaviour, you must provide:
Name
The display name learners and authors will see (e.g. "Breaking bad news", "Safeguarding conversations", "Technical support").
Description
A short explanation of what this AI behaviour is used for.
These details help authors choose the appropriate AI behaviour when building scenarios.
Who can edit this AI behaviour?
Decides who can change the AI behaviour later. See Who can edit an AI behaviour below.
Avatar instructions
The Avatar instructions section defines how the avatar should act in every scenario that uses this AI behaviour. Use it to describe tone, personality and boundaries.
This becomes the foundation for all scenarios assigned to this AI behaviour.
What to put in avatar instructions vs scenario scripts
Think of your AI behaviour as the reusable playbook for a kind of conversation. Each individual scenario then supplies the specific case.
Put in avatar instructions (AI behaviour level) | Put in the scenario script (per scenario) |
|---|---|
How the character should speak and respond in general | Who the character is, their situation and background |
How quickly they share information | Specific facts, symptoms, concerns or plot points |
Rules that apply to every scenario using this AI behaviour | How this character reacts to this case |
What the character must never do | Dialogue or details unique to one scenario |
If something only applies to one scenario, keep it in that scenario's script, not in the AI behaviour's instructions.
Suggested structure
Guidelines:
- How should the character speak and respond?
- How much detail should they give, and when?
Restrictions:
- What must they never do? (e.g. break character, coach the learner, give medical diagnoses)
Conversation style:
- How should they handle brief replies (e.g. "OK"), summaries, or unclear questions?
Write short bullet points in everyday language. Be specific about behaviour, not just adjectives. For example, "acknowledge how the learner feels in one sentence before answering" is more useful than "be empathetic" on its own.
Patterns by conversation type
You do not need a different approach for every AI behaviour, but the role the avatar plays should shape your instructions:
When the AI is being questioned (e.g. history taking, interviews, customer complaints)
- Answer only what was asked; do not volunteer extra information upfront
- Use plain language appropriate to the character, not jargon unless the script says they would use it
- If the learner summarises incorrectly, correct them politely
When the AI is seeking help or advice (e.g. counselling-style conversations, a colleague asking for guidance)
- Do not front-load every concern in the opening message
- Raise one question or worry at a time at natural moments in the conversation
- Reflect the emotional tone described in the script
When the AI is explaining or presenting (e.g. teaching a concept, delivering structured information)
- Present information in a logical order and pause for the learner to respond
- Check understanding when it feels natural, based on the script
- Stay in the character's role. Do not slip into "helpful assistant" language
These are starting points. Adjust them to match your training goals.
Common mistakes to avoid
- Repeating the script: character details belong in each scenario, not in the AI behaviour's instructions
- Being too vague: "Act realistically" does not tell the AI what to do; describe the behaviour you want instead
- Coaching the learner: the character should stay in role, not guide the learner through the exercise
- Overriding default AI behaviours unnecessarily: SimChat's built-in AI behaviours (History taking, Interview, and so on) are already tuned for those interactions. Create a custom AI behaviour when you need something genuinely different. To adjust a default for some of your scenarios, duplicate it and edit the copy
- Setting and forgetting: test at least one scenario using the new AI behaviour yourself, then refine the instructions if the character feels too chatty, too guarded or off-tone
Marking, feedback and generation (optional)
As well as avatar instructions, a custom AI behaviour can include:
Marking instructions
Optional guidance on how the AI should award marks when reviewing conversations against the checklist. Leave blank to use SimChat's defaults.
Feedback instructions
Optional guidance on the focus, style and structure of the AI-generated feedback. Leave blank to use SimChat's defaults.
Generation instructions
Optional guidance for the AI scenario generator when writing new scenarios that use this AI behaviour, so you don't have to repeat it each time you generate one.
Who can edit an AI behaviour
Each AI behaviour has a Who can edit setting, shown as a badge on its card:
Setting | Who can edit it |
|---|---|
Administrators only (lock badge) | Administrators and assistant administrators |
Its creator and administrators (creator's name on the badge) | The person who created it, plus administrators and assistant administrators |
Authors and cohort leads | Every author and cohort lead, plus administrators and assistant administrators |
- New AI behaviours start as Its creator and administrators
- SimChat's default AI behaviours, and any created before this setting was introduced, are Administrators only
- Administrators can choose any setting. A creator can choose between the last two
- AI behaviours with no creator, such as SimChat's defaults, don't offer Its creator and administrators
- To change the setting later, select the pencil icon next to the AI behaviour's name
Everyone who creates scenarios can choose any AI behaviour for a scenario, whoever can edit it. When you can't edit an AI behaviour, its card shows Configure, Duplicate and its edit history only.
If you can't edit an AI behaviour
If you open an AI behaviour you can't edit, for example from a link someone shared, SimChat shows a page explaining why and who to ask:
- Administrators only: ask an administrator to make the change, or to change who can edit it
- Its creator and administrators: ask the person named on the page, or an administrator
- Turned off for your organisation: if your organisation only lets administrators create and edit AI behaviours, ask an administrator
- Deleting: if your organisation doesn't let authors delete content, ask an administrator to delete it for you
Where it helps, the page also offers Duplicate, so you can make your own copy to edit instead.
Changing an AI behaviour that scenarios use
Changes to an AI behaviour apply straight away to every scenario that uses it, including published ones. When scenarios use the AI behaviour you're editing, the edit page shows how many, and how many of those are published. Select View these scenarios to see them.
To try changes without affecting those scenarios, duplicate the AI behaviour and test the copy on a draft scenario first:
- Select Duplicate on the AI behaviour's card, or in the warning on its edit page
- Review the pre-filled details and rename the copy if you like, then select Create AI behaviour
- Edit the copy, and choose it for a draft scenario to test it
- When you're happy, switch your scenarios over to the copy one at a time. For published scenarios, that change goes through Propose an update
You can duplicate any AI behaviour, including ones you can't edit, and the copy is yours to edit. A copy of a default AI behaviour keeps using SimChat's built-in instructions until you write your own to replace them.
Managing AI behaviours after creation
On Scenarios → AI behaviours, select Configure on any AI behaviour to expand its settings. The Edit buttons only appear on AI behaviours you can edit.
Avatar
How the avatar plays its role during the conversation: tone, personality and boundaries. For default AI behaviours, SimChat shows a warning before you edit: your custom instructions replace SimChat's built-in behaviour, and future product updates to the default will not apply to your version.
Marking
How the AI awards marks when reviewing the conversation against the scenario's checklist. If you haven't customised this, SimChat uses its defaults.
Feedback
The focus, style and structure of the AI-generated feedback learners receive.
Generation
How the AI scenario generator writes new scenarios that use this AI behaviour.
Each section shows whether it is using the SimChat default or has been Customised.
An AI behaviour can't be deleted while any scenario, template or proposed update uses it. The delete button's tooltip shows how many.
Edit history
SimChat records every change to an AI behaviour: who made it, when, and which instructions or settings changed, including Who can edit. To see it, select the clock icon next to Configure on Scenarios → AI behaviours.
Select View changes on any entry to compare the text before and after. Removed lines are marked − on a red background and added lines + on a green background, as shown in the key at the top of the page. If instructions were reset, the entry notes that SimChat's default is now used.
Anyone who can open the AI behaviours page can see the edit history of any AI behaviour, including ones they can't edit, so you can check what changed in an AI behaviour your scenarios use. The history is kept even if the AI behaviour is later deleted.
When to use custom AI behaviours
Create a custom AI behaviour when you need:
- A specific communication structure (e.g. "escalation discussions", "performance review conversations")
- Unique rules or restrictions for the AI character
- Specialised marking or feedback settings
- A consistent approach across multiple related scenarios
AI behaviours ensure your AI interactions behave consistently and support your organisation's training goals.
If you need help configuring AI behaviours or designing behaviour rules, the SimChat team can support you.
Updated on: 30/09/2026
Thank you!
