Skip to main content Skip to page footer

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:

  1. Open the backend module “AI Suite”
  2. Switch to the “Global Instructions” section
  3. 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.

  • Show larger version The “Global instructions” section: The “AI Suite” module

    In the AI Suite module, we open the “Global Instructions” section on the page where the instructions are stored. Two examples already exist.

2. Structure of the initial input mask

  1. Set a meaningful name or edit the existing name
  2. Create your global instructions or edit them
  3. 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
  4. Select the area to which the instruction should apply.
    1. 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
    2. 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)”
    3. 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)”
  5. 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
  6. 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
  7. 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
  8. 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
  9. 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
  10. Save the record
  • Show larger version Create the instruction: Create

    We enter a name and the instruction and define where it applies: when editing texts in the editor, for the page “Über uns” and its subpages.

  • Show larger version New global instruction Brand voice with the scope General (everywhere) and the option Also for files enabled

    In the context “Global (all pages of the site)”, we create the instruction “Brand voice” for the scope “General (everywhere)”. It applies to all pages of the site without selecting pages. With “Also for files”, it applies in the file list as well.

    3. Updated list view of the global instructions

    After saving, the created global instruction appears in the list.

    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.

    • Show larger version The effect in the AI plugin: The “Layout” module

      On the page “Über uns”, we open a text and the “Adjust content with AI” dialog. The eye above the prompt field shows which global instructions are sent along.