A problem page and its analysis screen offer three AI aids: Suggest the probable cause, Assisted writing of the workaround and Propose the 5 whys. The AI assistant instructions screen (menu Problems › AI assistant instructions, or the button of the same name at the bottom of Problem settings) sets the instructions Portail ZAPP sends to the AI provider for these aids. It is reserved for administrators.
The instructions
The screen shows one card per instruction, each with the {languageCode} variable:
- Probable cause: used by Suggest the probable cause;
- Workaround writing: used by Assisted writing, next to the workaround;
- 5 whys: used by Propose the 5 whys, on the analysis screen.
{languageCode} is replaced by the user's language (or else the instance's): the assistant answers in that language.
Change an instruction
- Type your text in the card. When the field is empty, the default instruction applies; it is shown greyed out in the field (it is written in English).
- Click Save: Instruction saved.
- To drop your text, click Restore the default instruction (the button only appears when a custom instruction is saved): Default instruction restored.
The change applies from the next request, without a restart.
Good to know
- Keep the response format of the Probable cause and 5 whys instructions: the default instruction asks for a structured answer (the cause and its justification; a list of 1 to 5 answers). If your instruction no longer asks for it, every proposal fails with The AI assistant returned an unusable answer: try again or add more details. The safest way is to start from the default text and change only its substance.
- The assistant never changes a problem on its own: each proposal is shown for review, with Apply (or Replace the whys) and Dismiss.
- When AI is disabled (provider None (AI disabled) in the AI configuration), the three buttons do not appear and all of problem management works. The instructions screen stays available: what you save there is kept and will be used as soon as AI is turned back on.
See also
- "Managing a problem": the AI assistant on the problem page and the analysis screen.
- "Set up problem management": KEDB and trend detection.
- "Configure AI": choose the AI provider or turn AI off.