Stages Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
712:chatbot_config [2025/08/25 22:24] – [Limitations] Meier, Erich712:chatbot_config [2026/07/21 19:34] (current) – [Limitations] Meier, Erich
Line 17: Line 17:
 ===== Views and Workspaces ===== ===== Views and Workspaces =====
  
-Processes in Stages exist in many different versions, workspaces, variants, and process instances. AI technologies work best if the scope of the underlying information is clear and well-defined. Combining different process versions, variants, and instances would result in imprecise or even misleading answers. Therefore, multiple sets of processes can be defined, one for each //view// on the process landscape.+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.
  
-Possible process views are:+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:
  
   * Standard processes that everyone should follow   * Standard processes that everyone should follow
-  * Process variants, e.g. a development process for normal products, one for safety-critical products, one of cybersecurity-critical products, and one for both safety- and cybersecurity-critical products +  * A process variant – for example, you might have separate views for a development process for safety-critical products and the process without safety requirements 
-  * Processes that are especially tailored for specific programs or projects+  * A process tailored for a specific program or process
  
-Views can consist of a single workspace or a collection of workspaces. This way, the standard process view can consist of a workspace containing the standard development process, one or more workspaces containing all organizational processes that are not executed by projects or product teams, and a workspace containing the organizational policies.+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.
  
-Stages Assistants are always trained on the //Valid Version// of the process content in each workspace. This version __must be different__ than the Working Version.+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.
  
  
Line 78: Line 80:
  
   * Name of the view   * Name of the view
 +  * Domain of the processes contained in the view, e.g. "Product Development Processes". It is not required and can be left blank, unless the Assistant answers are too generic or misleading.
   * Welcome Message that end users see when they access the view in the Stages Assistant. The message should describe the scope of information the Assistant can answer questions about.   * Welcome Message that end users see when they access the view in the Stages Assistant. The message should describe the scope of information the Assistant can answer questions about.
   * Color used to display user questions in the Assistant, so users can visually distinguish between different views   * Color used to display user questions in the Assistant, so users can visually distinguish between different views
Line 95: Line 98:
 For mass updates, you can import and export CSV files using the "..." context menu. For mass updates, you can import and export CSV files using the "..." context menu.
  
 +===== Disable History =====
 +
 +In newer Stages Versions the chat history can be disabled, e.g., to comply with local policies or regulations. Chats and chat messages will not be stored in the database. To disable history, add the following property to conf/config.xml:
 +
 +<code xml>
 +<property name="ai.chatbot.history.enabled" value="false"/>
 +</code>
  
 ===== Limitations ===== ===== Limitations =====
Line 100: Line 110:
 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. 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:+During the training of the Assistant, all process elements are transformed into a knowledge graph and stored in special databases. This means that the Assistant is trained on the following information: 
 + 
 +  * Element names and abbreviations 
 +  * Element descriptions 
 +  * Associations between elements, e.g. "Role X is responsible for Activity A1" 
 + 
 +The following elements are currently excluded in this transformation:
  
   * Landing pages   * Landing pages
Line 116: Line 132:
 Process interfaces to elements outside of the training view (workspace or workspace collection) are ignored. 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 the Stages support team or your Stages consultant.+To customize the training scripts, e.g. to have them adjusted to your specific metamodel, please contact your Stages consultant.