Applies to SUSE AI 1.0

5 Managing custom AI models #

In Open WebUI, you can create custom AI models based on existing models. Later on, you can modify its settings, or share, clone or delete it.

5.1 Creating custom AI models #

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace in the upper part of the left panel.
2. Select Models in the top menu and click the small "plus" icon in the top-right corner of the screen.
  Figure 5.1: Managing AI models #
3. Click the default logo image in the top-left corner of the form to upload an avatar image for your model.
4. Enter the Name of your new model and change the Model ID if you are not happy with the provided one.
5. Specify the base AI model on which your model will be based on.
6. Enter a short description of your AI model.
7. Describe the model with custom tags so that other users can identify it easily.
8. To direct the AI model’s responses, specify a System Prompt. Find more details about system prompts in https://documentation.suse.com/suse-ai/1.0/html/AI-system-prompts/index.html.
  Tip
  By clicking the small Show option below the system prompt field, you can fine-tune the model’s behavior by modifying its advanced settings.
9. Specify one or more Prompt suggestions. They will be shown on the model’s chat welcome screen.
10. To extend the model’s knowledge base, select one or more documents or collections of documents from the preconfigured list.
11. In the Tools , Filters , Actions and Capabilities sections, activate the items that you want your model to use.
  Tip
  To view the JSON representation of your model, click the small Show option to the right of the JSON Preview label.
12. Save your changes with the Save & Create button.

5.2 Modifying existing AI models #

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. In the list of AI models, hover the mouse over the model that you want to modify and click the pen icon on its right.
3. On the model editing screen, you can modify the settings that are described in Section 5.1, “Creating custom AI models”.
4. On the model editing screen, you can modify the settings that are described in.
5. Save your changes with the Save & Update button.

5.2.1 Enabling the default MCP services #

To enable selected MCP services so that they are automatically enabled for a model, follow these steps:

Requirements #

At least one MCP server must be preconfigured. Refer to Installing mcpo to learn how to configure one.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. In the list of AI models, hover the mouse over the model that you want to modify and click the pen icon on its right to edit its properties.
3. In the Tools section, select the MCP tools you want to enable by default and confirm with Save .
  Figure 5.2: Enabling the default MCP tools #

5.3 Cloning existing AI models #

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. In the list of AI models, hover the mouse over the model that you want to clone and click the three dots on its right.
3. From the contextual menu, select Clone to open the same form as described in Section 5.1, “Creating custom AI models” with all settings copied from the original model. The Name field has (Clone) appended.
4. From the contextual menu, select Clone to open the same form as described in with all settings copied from the original model. The Name field has (Clone) appended.
5. Review the settings and create the cloned AI model with Save & Create.

5.4 Importing exported models #

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. Click the Import Models button at the bottom of the screen.
3. In the file selector, specify the path to the JSON file with the exported models' definitions. Confirm with Open .
  Models with identical IDs. IMPORTANT

AI models with IDs identical to existing models will not be imported.

5.5 Exporting existing AI models #

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. In the list of AI models, hover the mouse over the model that you want to export and click the three dots on its right.
3. From the contextual menu, select Export .
4. In the file selector, specify the path where you want to save the exported JSON file. Confirm with Save .

5.6 Exporting all existing AI models #

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. Click the menu:"Export Models"[] button at the bottom of the screen.
3. In the file selector, specify the path where you want to save the exported JSON file. Confirm with Save .

5.7 Deleting existing AI models #

Using the Open WebUI interface, you can delete previously created AI models.

Requirements #

You must have Open WebUI administrator privileges to access configuration screens or settings mentioned in this section.
1. In the Open WebUI interface, click Workspace at the top of the left panel and select Models .
2. In the list of AI models, hover the mouse over the model that you want to delete and click the three dots on its right.
3. From the contextual menu, select Delete and then apply with Confirm .