Table of Contents

Stages Assistant Configuration

The Stages Assistant is a chatbot that uses Generative AI to answer all kinds of questions using the process content defined in Stages.

You can find more on its basic usage and functionality here.

The sections below describe how to set up, train, and maintain the Stages Assistant.

Acknowledgement of AI-enabled Features

The Stages Assistant uses Generative AI to implement its various capabilities. Although our implementation aims to minimize mistakes through the use of knowledge-graph technology, AI-based systems can be imprecise or incorrect, a phenomenon usually known as “hallucinating”.

To make users aware of this fact, each user is required to accept an AI disclaimer before first use.

See here for more info on this subject.

Views and Workspaces

Processes in Stages exist in many different workspaces and versions, including variants and specific project instances. AI technologies work best if the scope of the underlying information is clear and well-defined; combining the information from all Stages processes would result in imprecise or even misleading answers.

Therefore, you must define one or more views of the process landscape that scope the processes considered by the Stages Assistant.

Examples of a process view might include:

Views consist of a single workspace or a collection of workspaces. For example, if you have separate workspaces for the standard development process and other organizational workspaces, you can group them into a workspace collection to include all of that process content in a single view.

Note: The Stages Assistant is always trained on the Valid Version of the process content in each workspace. The Valid Version must be different than the Working Version; if the Working Version is set to be the Valid Version, the training will fail.

Required Permissions

End users require the following permissions to use the Stages Assistant:

To configure the AI assistants, the following permissions are needed:

In both cases, the permission scope must include the workspaces for the defined view. If the view includes a workspace collection, the permissions must apply to all workspaces within the collection.

In the Assistant, users will only see the views for which they have read permissions.

Configuring the Stages Assistant

Configure the Stages Assistant in the Administration > AI > Chatbot menu. The main screen shows the currently configured assistant views.

In addition to the name, you can see the following information for each view:

Use the 3-dot menu to the right of the view to:

Clicking on the view name or selecting the Edit action opens the following configuration screen:

In the configuration screen, you can modify:

Please note: You must successfully train and then enable each view in order for end users to access it.

Defining Acronyms

Company-specific acronyms that are not described in the process models must be defined for the Stages Assistant using the Administration > Acronyms section. Managing acronyms requires administrator access and edit permissions for the “Acronyms” domain.

For each acronym, you can provide both its expansion and a longer multi-language explanation.

For mass updates, you can import and export CSV files using the “…” context menu.

Limitations

Large Language Models (LLMs) have a so called context window which has a limited size. To accommodate that limit, Stages never sends the process models to the LLM in their entirety, but only in select segments that are required to answer the user questions. As a consequence, questions that address whole process models, e.g. “List all work products of all processes”, currently cannot be answered.

During the training of the Assistant, all process elements are transformed into a knowledge graph and stored in special databases. The following elements are currently excluded in this transformation:

Such elements might be included in future revisions of assistant training scripts.

Process interfaces to elements outside of the training view (workspace or workspace collection) are ignored.

To customize the training scripts, e.g. to have them adjusted to your specific metamodel, please contact your Stages consultant.