Migrating to AI-Service 3.x

AI-Service version 2.6.x is not compatible with App Suite UI versions 8.34 or later. If you plan to upgrade to App Suite 8.34, you must use AI-Service version 3.0.x or higher.

When upgrading to 3.x, there are some mandatory configuration changes that need to be applied.

Helmchart

Model configuration

You need to add your models to the modelsConfig value in your helm chart, like so:

modelsConfig:
  defaultModel: "gpt-4o"
  models:
    gpt-4o:
      displayName: "ChatGPT 4o"
      service: "openai"
      model: "gpt-4o"
      maxTokens: 128000

This would be a super simple configuration with only one model. For further information check the Models Configuration chapter in the documentation.

Database

A database connection is now mandatory and needs to be configured. See database setup or take a look at the Helm Readme

Consent dialog

The settings path has changed, the former io.ox/core//ai/config/custom path has changed to io.ox/core//ai/config/default

io.ox/core//ai/config/default/serviceName = 'OpenAI',
io.ox/core//ai/config/default/serviceLink = 'https://openai.com/about',
io.ox/core//ai/config/default/dataUsagePolicy = 'https://openai.com/policies/api-data-usage-policies'

Those links will be used in the consent dialog and should direct the user to the proper documents.

For more complex setups and configurations check the Models Configuration Chapter and the Model selection settings Chapter in the documentation.

Model setting

io.ox/core//ai/model = 'default' or empty

If your io.ox/core//ai/model setting is empty you are already done. Otherwise set it to 'default' or just unset it. See Model selection settings for more information.