Administration Guide

AI Actions

On this page

An AI Action is a named instruction that AI applies to selected text. Each action has a title, an instruction, an enabled state, and a rank. The Web App offers the enabled actions, in rank order, wherever writing assistance is available.

Some actions are system actions. When you open a system action in either administrative application, the fields for its caption and its instruction are disabled. The two applications handle deleting a system action differently, as described below.

An action can also carry retrieval settings: the classes of the vector index to search and the external context sources to read. They change what the model is given to read, not what it is asked to do. When the Web App runs an action, only the class names Knowledge Base and Incident select anything to search; any other class name retrieves nothing. The Settings App sets neither retrieval setting, and neither administrative application sets the external context sources.

The provider, the master switch, and the permission for AI pages are described in AI Configuration.

AI Actions in the Admin Center

The Admin Center lists the AI Actions sorted by rank. The list's Rank column is hidden by default.

Create or edit an action

  1. On the AI Actions page, create an action or open the one to edit.
  2. Enter the Caption and Instruction, and set Enabled to control whether the action is offered in the Web App.
  3. Save the action.

The action editor has three fields: Caption, Instruction, and Enabled. A new action opens in a drawer titled "New Action".

  • A new action is added after the last one: it gets the highest existing rank plus one. If no action has a rank, the new action gets no rank either. A new action is not a system action and has no classes to search.
  • Saving an action from its editor never changes its rank.
  • The editor has no control for the classes to search. Editing an action keeps its classes to search and its system state as they are.

Reorder actions

  1. Select exactly one action.
  2. Click Move Up or Move Down. Move Up is not available on the first row, and Move Down not on the last.

You can also drag a row to its new place. A move or a drag renumbers the whole list from 1 upward.

Delete actions

  1. Select one or more actions.
  2. Click Delete. With several actions selected, the confirmation reads "Are you sure you want to delete n selected items?".

Delete is not available when the only selected action is a system action. With several actions selected, Delete stays available even when system actions are among them, and every selected action is deleted, system actions included. Deleting does not renumber the remaining actions.

System actions

When you open a system action, the drawer shows "This is a system action. It cannot be modified or deleted." Caption and Instruction are disabled. Enabled stays editable, so you can switch a system action off or on.

AI Actions in the Settings App

In the Settings App tree, AI Actions is in the AI Integration branch, beside AI Configuration. The AI Integration permission gives access to the whole branch; there is no separate permission for editing actions.

Create an action

  1. In the navigation tree, select AI Integration > AI Actions.
  2. Click New, or press Insert in the list. New is available whenever the page is shown, whether or not a row is selected. The AI Action dialog opens.
  3. In Title:, enter the action's title. The title is mandatory.
  4. In Instruction:, enter the instruction, on one line. It is optional.
  5. Leave Enabled selected to offer the action in the Web App, or clear it. Enabled is selected for a new action.
  6. Click OK. Esc cancels the dialog.

If the title is empty or blank, OK shows "The "Title" field is mandatory, it can't be left blank." and returns you to Title:.

OK adds the action at the end of the list and saves it at once; you do not need to click Apply. Cancel saves nothing. The new action is not a system action and has no classes to search, because the Settings App has no control for them.

Edit, reorder, and delete actions

In the Settings App, you can change an action's title, instruction, enabled state, and rank, and you can delete actions.

  • The Settings App moves an action by swapping ranks, and it renumbers the ranks from 1 without gaps before every move and every delete.
  • When you try to delete a system action, the Settings App refuses. In a multi-row delete, it skips the system actions, deletes the rest, and reports "Only n of m records have been deleted. The system record "name" cannot be deleted."
  • When you open a system action, its title and instruction fields are disabled.

AI Actions in the Default Workflow

A new 2026.1 database created with the Default Workflow (see Default Workflow Configuration) contains three AI Actions, in this rank order: Summarize, Improve, and Translate to English. All three are enabled in the supplied configuration. None of them has retrieval settings, so they run with no retrieval at all.

An upgraded database need not contain these actions, and an administrator may have changed them.