AI Features
On this page
The Web App offers technicians two AI capabilities: writing assistance on HTML fields, and AI-powered insights, which are workflow actions whose form holds an AI control. No license module gates AI features as a whole. Whether they are available depends on the AI master switch, an AI provider API key, and the switches of the individual features, which administrators set up as described in AI Configuration. The Self Service Portal offers an AI assistant; see AI Assistant.
What is switched on by default
A new database starts with AI features switched on but not connected:
- AI features are switched on, but no AI provider API key exists. Until an administrator supplies a key, the AI features that are on appear in their not-connected state, described in the sections below.
- Retrieval over Knowledge Base articles and tickets is unavailable, because embeddings are off by default. An administrator makes it available as described in AI Configuration.
In a new database created with the Default Workflow (see Default Workflow Configuration), three writing-assistance AI actions and a set of AI-powered insight actions are present and enabled; both are listed in the sections below. Until an API key is supplied, they appear in their not-connected state like the rest of the AI features. A database upgraded from an earlier version need not have this content, and an administrator may have changed it.
AI features in the Web App
Writing assistance on a field
An HTML field that is not shown read-only, on a record's form or on a workflow action's form, carries two AI buttons in its footer: an AI actions button and a voice-input button.
- The AI actions button opens a menu of the field's AI actions. Choosing an action opens a chat panel seeded with the field's text and images.
- The menu lists the AI actions that are enabled, in their configured order. The Web App caches the list of AI actions for one hour, so a change to them may not show in the menu at once.
- An AI action can also be set up to give the AI Knowledge Base articles, incidents, or both to read, and content from external context sources. This changes what the AI is given to read, not what it is asked to do. Retrieved articles and incidents follow your rights and the maximum search score, as described for AI-powered insights below.
- When text-to-speech is enabled for the AI provider, each answer in that chat panel also carries an audio player. The speech is requested only when you play it.
- The voice-input button records audio and returns a transcript of it.
Both buttons are hidden while AI features are switched off. While AI features are on but no AI provider key is configured, both buttons appear disabled, with a tooltip. The voice-input button is also hidden while transcription is not enabled, and appears disabled, without a tooltip, when the field is read-only.
In a new database created with the Default Workflow (see Default Workflow Configuration), the menu offers Summarize, Improve, and Translate to English, in that order, and none of the three retrieves Knowledge Base articles or incidents.
AI-powered insights
An AI-powered insight is a workflow action whose form holds an AI control, a form element with its own prompt. These actions are configured like any other workflow action; see Workflow Overview.
- The AI control sends its first request automatically and has copy, regenerate, and chat buttons. Depending on how the control is configured, you can continue in a conversation after the first answer.
- The control's prompt is sent behind a fixed instruction, which no administrator can edit, to answer in HTML only and without introductory phrases.
- A control can use retrieval: it searches Knowledge Base articles, incidents, or both, with text composed from the record's fields, and passes what it finds to the AI together with its prompt.
- Retrieval applies your own rights: an article or ticket you could not open is neither shown to you nor passed to the AI. Results beyond the configured maximum search score are left out.
- When a control uses retrieval and embeddings are disabled for the AI provider, the control answers without retrieved content, and the AI is instructed to end its answer with a note about the private vector index that lets AI search internal Service Desk content.
While AI features are on but no AI provider key is configured, the action's form still opens, but the AI control shows an explanation in place of the answer, worded for administrators or for other users, does not send its automatic first request, and disables its copy, regenerate, and chat buttons. The AI control is not hidden while AI features are switched off.
Action forms in the Self Service Portal can also hold an AI control, which the portal implements on its own; for how it works there, see Submit a Ticket.
In a new database created with the Default Workflow (see Default Workflow Configuration), the AI-powered insights are these workflow actions:
| Class | AI-powered insight actions |
|---|---|
| Incident | Summarize Incident, Suggest Solution, Suggest Category |
| Request | Summarize Request, Suggest Next Steps, Suggest Category |
| Problem | Summarize Problem, Suggest Solution, Suggest Category |
| Change Request | Summarize Request, Suggest Action Plan, Suggest Category, Analyze Risks |
| Work Order | Summarize Work Order, Suggest Next Steps, Suggest Category |
In that configuration, each action's condition requires AI features to be switched on. Suggest Solution and Analyze Risks search incidents and Knowledge Base articles, and Suggest Next Steps and Suggest Action Plan search Knowledge Base articles; each of them searches with the record's description. The summarize actions and Suggest Category retrieve nothing.
Related topics
- AI Configuration - connect an AI provider and set up AI features.
- AI Assistant - the AI assistant of the Self Service Portal.