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:configure_stages [2025/09/22 12:57] – [Modify secret.properties settings] Linz, Andreas712:configure_stages [2025/09/25 14:22] (current) – [Modify secret.properties settings] Linz, Andreas
Line 376: Line 376:
 Please find the details [[ldap|here]]. Please find the details [[ldap|here]].
  
-===== AI Chat Assistant Configuration ===== +===== AI Feature Configuration: Chatbot Assistant and Content Generation ===== 
 +To activate the AI chatbot and the content generation feature in Stages, the following steps are required.
 ==== Stages version ==== ==== Stages version ====
-The chatbot will only work with Stages v7.12 or higher. +The chatbot will only work with Stages v7.12 or higher. The content generation feature works with Stages v7.11 or higher. 
  
-==== Stages license ==== 
-A license feature is required to activate the chatbot feature. Please contact [[stages-support@ul.com]] to issue a modified license.  
  
 ==== Metamodel ==== ==== Metamodel ====
  
-A new unified configuration metamodel for Stages v7.12 is also requiredThis version gets delivered with Stages 7.12. Please contact[[ stages-support@ul.com]] for further metamodel update instructions - depending on your Stages server operating system. If you use a customized metamodel, please contact your Stages product consultant to extend your metamodel. +A new unified configuration metamodel for Stages v7.12 / v.7.11 is required to support the AI features. Please contact [[stages-support@ul.com]] for further metamodel update instructions - depending on your Stages version and server operating system. If you use a customized metamodel, please contact your Stages product consultant to extend your metamodel. 
  
 ==== User permissions ==== ==== User permissions ====
-Depending on the activities performed with a Stages user - the following user permissions are required:+Depending on the activities performed by the Stages user with the chatbot assistant - the following user permissions are required:
   * Use chatbot assistant:    * Use chatbot assistant: 
       * Permission Domain Chatbot > Permission: Read       * Permission Domain Chatbot > Permission: Read
Line 401: Line 400:
   * Default file path on windows server: /methodpark/stages/conf/config.xml   * Default file path on windows server: /methodpark/stages/conf/config.xml
   * Default file path on linux server: /opt/stages/conf/config.xml   * Default file path on linux server: /opt/stages/conf/config.xml
 +AI Chatbot Assistant feature:
 <code xml> <code xml>
 <chatbot> <chatbot>
Line 467: Line 467:
     </chatbot-stage>     </chatbot-stage>
 </chatbot> </chatbot>
 +</code>
 +AI Content Generation feature:
 +<code xml>
 <cg> <cg>
     <cg-type name="azureOpenAI">     <cg-type name="azureOpenAI">
Line 474: Line 477:
             <cg-property name="deployment_name" value="gpt-4o"/>             <cg-property name="deployment_name" value="gpt-4o"/>
             <cg-property name="version" value="2024-05-01-preview"/>             <cg-property name="version" value="2024-05-01-preview"/>
-            <cg-property name="costsPerInputToken" value="2.5"/> <!-- 2,50$ per 1 million token --+            <cg-property name="costsPerInputToken" value="2.5"/>  
-            <cg-property name="costsPerOutputToken" value="10.0"/> <!-- 10$ per 1 million token -->+            <cg-property name="costsPerOutputToken" value="10.0"/> 
         </cg-host>         </cg-host>
         <cg-host ident="gpt-4o-mini" url="${ai.model.url}" displayName="Azure OpenAI GPT-4o-mini">         <cg-host ident="gpt-4o-mini" url="${ai.model.url}" displayName="Azure OpenAI GPT-4o-mini">
Line 481: Line 484:
             <cg-property name="key" value="${ai.model.key}"/>             <cg-property name="key" value="${ai.model.key}"/>
             <cg-property name="deployment_name" value="gpt-4o-mini"/>             <cg-property name="deployment_name" value="gpt-4o-mini"/>
-            <cg-property name="costsPerInputToken" value="0.15"/> <!-- 0,15$ per 1 million token --+            <cg-property name="costsPerInputToken" value="0.15"/>  
-            <cg-property name="costsPerOutputToken" value="0.6"/> <!-- 0,60$ per 1 million token -->+            <cg-property name="costsPerOutputToken" value="0.6"/> 
             <cg-property name="logRequestsAndResponses" value="true"/>             <cg-property name="logRequestsAndResponses" value="true"/>
         </cg-host>         </cg-host>
Line 489: Line 492:
             <cg-property name="key" value="${ai.model.key}"/>             <cg-property name="key" value="${ai.model.key}"/>
             <cg-property name="deployment_name" value="gpt-4o"/>             <cg-property name="deployment_name" value="gpt-4o"/>
-            <cg-property name="costsPerInputToken" value="2.5"/> <!-- 2,50$ per 1 million token --+            <cg-property name="costsPerInputToken" value="2.5"/> 
-            <cg-property name="costsPerOutputToken" value="10.0"/> <!-- 10$ per 1 million token -->+            <cg-property name="costsPerOutputToken" value="10.0"/>
             <cg-property name="logRequestsAndResponses" value="false"/>             <cg-property name="logRequestsAndResponses" value="false"/>
         </cg-host>         </cg-host>
Line 498: Line 501:
             <cg-property name="deployment_name" value="text-embedding-3-large"/>             <cg-property name="deployment_name" value="text-embedding-3-large"/>
             <cg-property name="dimensions" value="512"></cg-property>             <cg-property name="dimensions" value="512"></cg-property>
-            <cg-property name="costsPerInputToken" value="0.13"/> <!-- 0,00013$ per 1000 token --+            <cg-property name="costsPerInputToken" value="0.13"/> 
-            <cg-property name="costsPerOutputToken" value="0"/> <!-- no costs -->+            <cg-property name="costsPerOutputToken" value="0"/>
             <cg-property name="isEmbeddingModel" value="true"/>             <cg-property name="isEmbeddingModel" value="true"/>
         </cg-host>         </cg-host>
Line 517: Line 520:
  
 ==== Modify secret.properties settings ==== ==== Modify secret.properties settings ====
-Please add the following section to your secret.properties file and replace the url and key values with your personal Azure AI subscription data. If you don't have an own AI subscription, please contact UL for an subscription offer.+Please add the following section to your secret.properties file and replace the url and key values with your personal Azure AI subscription data. Details on the subscriptions required can be found here: [[712:ai_privacy|]] 
   * Default file path on windows server: /methodpark/stages/conf/secret.properties   * Default file path on windows server: /methodpark/stages/conf/secret.properties
   * Default file path on linux server: /opt/stages/conf/secret.properties   * Default file path on linux server: /opt/stages/conf/secret.properties
Line 527: Line 530:
   ai.translateservice.url = [azure_translate_service_url]   ai.translateservice.url = [azure_translate_service_url]
   ai.translateservice.key = [azure_translate_service_key]   ai.translateservice.key = [azure_translate_service_key]
 +  
 +If you use Stages as managed service and you don't have an own AI subscription, please contact UL for an subscription offer.