Global Instructions
Since versions 13.8.0/12.14.0, you can create global instructions. The AI Suite automatically adds them before your prompt in every matching request, i.e. when context, area and page match the instruction. You create global instructions for different areas and pages. You can also combine multiple global instructions within a page tree or overwrite previous ones. Since versions 14.8.0/13.20.0/12.26.0, you can also create a global instruction for a whole site without selecting pages or folders.
1. Where can I find the function?
You can access the input mask as follows:
- Open the backend module “AI Suite”
- Switch to the “Global Instructions” section
- Click “Create global instructions”
Global instructions are stored on a page. Since versions 14.7.0/13.19.0/12.25.0, the create buttons are therefore disabled on the root level, and a notice asks you to select a page.
Since versions 14.8.0/13.20.0/12.26.0, the overview is split into the sections “Global”, “Pages” and “Files”. Each section has its own create button and opens the form directly in its context, so a record no longer moves to another section by accident.
2. Structure of the initial input mask
- Set a meaningful name or edit the existing name
- Create your global instructions or edit them
- Since versions 14.8.0/13.20.0/12.26.0, the context of the global instruction follows from the section of the overview in which you create it: “Global (all pages of the site)”, “Page/List/AI Suite Web Module” or “Filelist/AI Suite Filelist Module”. Depending on the context, different areas are available
- Select the area to which the instruction should apply.
- For the context “Global (all pages of the site)”, there are: “General (everywhere)”, “PageTree”, “ImageWizard (pages and files)”, “ContentElements”, “News Records”, “RTE Content Editing”, “Metadata (pages and files)” and “Translations (pages and files, DeepL and Google Translate are excluded)”. An instruction in the area “General (everywhere)” applies in addition to those of the respective area
- For the context “Page/List/AI Suite Web Module”, there are: “General (Pages)”, “PageTree”, “ImageWizard (Pages)”, “News Records”, “ContentElements”, “RTE Content Editing”, “Metadata (Pages)” and “Translations (DeepL and Google Translate are excluded)”
- For the context “Filelist/AI Suite Filelist Module”, there are: “General (Files)”, “ImageWizard (Files)”, “Metadata (Files)” and, since versions 14.7.0/13.19.0/12.25.0, “Metadata translations (Files, DeepL and Google Translate are excluded)”. Since then, the translation of file metadata uses the instructions of this area instead of those of “Metadata (Files)”
- With the option “Use for subtree (pages/directories)”, you define that the global instruction also applies to all child pages. In the context “Global (all pages of the site)”, the option is not shown, because the instruction applies to all pages of the site it is stored in anyway
- With the option “Also for files” (only in the context “Global (all pages of the site)”), the instruction also applies in the file list, the file workflows and file metadata, independent of the site
- With the option “Extend previous instructions”, you define that existing global instructions from previous or parent pages are extended. Since versions 14.7.0/13.19.0/12.25.0, the AI Suite applies page instructions from the root down to the page: without this option, the instruction of the deepest page applies, and an extending instruction follows those of the parent pages, regardless of when it was created. An instruction in the context “Global (all pages of the site)” comes first: an instruction of a page or folder with this option adds to it, without the option it replaces it
- With the option “Use Global Instruction (instead of predefined server prompt)”, you define that the AI Suite uses the global instruction instead of the predefined server prompt
- With “Selected Pages” or “Selected Directories”, you specify the pages or folders to which the global instruction applies. Since versions 14.8.0/13.20.0/12.26.0, you can also select pages below a menu separator, link pages, mount points and custom page types there. In the context “Global (all pages of the site)”, there is no selection
- Save the record
4. Availability and display of the global instructions
If global instructions exist for the selected page or folder and the area, a corresponding button appears above the input field for the respective prompt. When you hover over this button, you see the content of the stored global instruction.
Since versions 14.7.0/13.19.0/12.25.0, this button sits next to the “Use own prompt” toggle in the metadata generation and in the WorkflowManager. So you see that global instructions apply even while the prompt field is collapsed. In addition, images in content elements (file references) now receive the global instructions of the folder the file is stored in, just as when you edit it in the file list.