Zum Hauptinhalt springen

Create a New Model

Connecting a model is a one-time setup. Once a model is connected, every automation in the workspace can use it. This page walks through the generic flow; the provider-specific pages list what to enter in each field.

Before you start​

  • You need Editor, Manager, or Admin rights in the workspace.
  • For external providers (OpenAI, Anthropic, Mistral), you need an API token from that provider. See the relevant provider page for how to obtain one.
  • For self-hosted Ollama, you need a running Ollama instance reachable from the AI Kit server.

Step by step​

1. Open the Models tab and click Configure new Model​

The Models list shows every model already connected to the workspace. The Configure new Model button at the top right opens the wizard.

The Models tab with the Configure new Model button in the top-right corner.

2. Pick a provider​

The wizard's first step asks which provider this model belongs to. Pick one of: Ollama, OpenAI, Anthropic, Mistral.

After the click, the wizard expands the provider's configuration form below the provider cards.

3. Give the model a display name​

The display name is what users see when they pick a model in a step. Pick something descriptive:

  • "OpenAI GPT-4o" or "OpenAI GPT-4o mini" — keeps the provider visible.
  • "Default Model" — works fine when there is only one.

You can rename a model later without breaking any automation that uses it.

4. Add a description (optional)​

A short description helps colleagues understand which model is which. Useful when the workspace has several connected models.

5. Enter the API token​

For OpenAI, Anthropic, and Mistral, paste your API token into the API token field. The value is stored encrypted and is not shown again after you save it — you can only replace it.

For Ollama, replace the API token field with the endpoint URL of your Ollama instance (see Ollama (self-hosted)).

6. Pick the model from the provider's list​

Below the credential fields, the wizard shows a list of common models for the chosen provider, plus a Custom / Other option for IDs that are not pre-listed.

  • For OpenAI: gpt-4o (Recommended), gpt-4o-mini, gpt-4-turbo, gpt-3.5-turbo, o1, o1-mini, o3-mini, or Custom / Other.
  • For Anthropic, Mistral, Ollama: see the relevant provider page.

If you pick Custom / Other, the wizard exposes a free-text field where you type the exact model ID. Use this when the provider released a new model after the AI Kit was built.

7. Create​

Click Create. The model is saved and available to every automation in the workspace.

Editing a model​

After creation you land on the model editor, where the same fields are editable. You can change the display name, description, token, or even the model ID at any time — automations referencing the model do not need to be touched.

Recommendations​

  • ✅ Use descriptive display names. "Fast OpenAI" beats "Model 1".
  • ✅ Stick to the recommended models per provider unless you have a specific reason to pick another. The "Recommended" tag exists because we have tested them.
  • ✅ Connect a dedicated model per use case if cost matters (one small/cheap, one large/capable).
  • ⚠️ The API token is invisible after saving. Treat it like a password — store the original somewhere safe in case you need to rotate it.
  • ⚠️ Providers occasionally retire model IDs. If a model abruptly stops working, check the provider's deprecation notes.
  • ❌ Do not connect a model with a personal API token paid by an individual. Use a token tied to a billing account that is meant for shared use.

What to do next​