Documentation › The built-in assistant
The built-in assistant (AI help button)
On every page, the round button at the bottom right (Ask the assistant) opens a conversation with the AI assistant of SerenForce. It finds your processes, artifacts, process instances and tasks, explains how a process works and drafts new processes or artifacts. It never changes anything by itself: it offers buttons, and nothing happens until you click one.
Open the assistant
- Click the round button
At the bottom right of the screen, Ask the assistant opens a side panel. The page stays usable behind it.
- Ask your question
Type in the field at the bottom of the panel and press Enter (Shift+Enter starts a new line). You can also click one of the suggestions.
- Keep talking
The assistant remembers the conversation until you click New conversation, even when you move to another page. It knows which page you are on.
What to ask
- Find: “Where is the onboarding process?”, “What are my open tasks?”, “Show me Marie’s process instance”.
- Understand: “Explain the Onboarding process”: the assistant describes its steps in order, who does them and what they produce. In the editor, it explains the drawing that is open, even before it is saved.
- Create: “Create an onboarding process with the desk preparation, a welcome email and a review after a month”, or “Create a Contract artifact asking for the name and the salary”. The assistant draws the participants, the variables and the steps.
- Create with choices: “Create a purchase process: above €100 the director approves, otherwise the manager”. The assistant draws a Condition block with one path per case (and a default path when needed), each path leading to its own steps.
- Check: “Is my process right?”: the assistant reads the drawing and points out blocks nothing reaches, paths that lead nowhere, tasks with nobody assigned, rules that compare a deleted variable and loops.
- Change: in the editor, “Add a step to create the accounts before the end” or “Rename the step Prepare the desk”.
- Start: “Start the onboarding for Marie”: the assistant prepares the start form.
Proposals
Below its answer, the assistant shows cards with a button. Once used, the button reads Done.
- Open: opens the page, the process or artifact (in the editor), the process instance or the task it found.
- Create and open: creates the process or artifact it drew (you are its owner) and opens it in the editor. Check it, complete it, then save the draft and publish it as usual.
- Apply in the editor: replaces the drawing open in the editor with the changed one. Nothing is saved: check it, then click Save draft. To cancel, leave the editor: SerenForce asks you to confirm (Unsaved changes), choose Leave without saving. The button only works in the editor of that process or artifact.
- Open the start form: opens Create New Process instance with the process and the name already chosen; you pick the people and start the process instance.
Good to know
- The assistant only sees what you can see and only proposes what your permissions let you do. When something is not allowed for you, it says so.
- It never deletes or publishes anything: publishing and starting stay your decisions.
- A process drawn by the assistant stays simple (tasks, emails, meetings, milestones, waits and conditions): add phases, attachments or API calls in the editor. A condition compares one variable with one value per path: complete richer rules in the editor.
- The assistant answers in the language you write in. It can be wrong: read what it proposes before applying it.
- Not to be confused with an external AI assistant (Claude, Copilot) connected through MCP.
Tokens
The assistant is paid with tokens: a question costs about 3 to 4 tokens. Each license brings free tokens every month (200 with Team, 400 with Pro, 600 with Business), pooled for the whole organization. The small circle next to your question fills with the share of the monthly tokens already used. Click the circle to see Your AI usage this month: your requests to the AI and the tokens they cost (never an amount of money).
An administrator of the organization can turn off the AI of one member on the Administration page. The assistant then tells that person their AI is turned off, and answers again once it is turned back on.
- Order of use: first the organization's monthly tokens, then those of its top-ups, then your own tokens, bought on the My license page (My tokens card).
- Tokens almost used: from 80% of the monthly tokens, the assistant says so, the circle changes color, and the administrators get an email, each in their own language. If the tokens left would not cover the end of a long answer, the assistant stops before the limit and says so.
- Tokens used up: the assistant stops answering; the rest of the application keeps working. An administrator sees Add tokens, which opens the Subscription page to top up the organization; a member sees Buy my tokens, or can ask an administrator for tokens. Nothing is ever billed extra for usage: only the tokens bought are paid for.
Permission
- The button only shows with the Use the assistant permission (Assistant area), given by default to the User and Administrator roles. Each question uses tokens: an administrator can remove it from a role in Users and roles.
- The buttons then need the same permissions as in the application (Create processes, Edit artifacts, Start process instances...).