> ## Documentation Index
> Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM providers & models

> Register the AI models your agents can use

The **LLM providers & models** page lists every AI model available on your AGO instance. Models
registered here can then be selected as the default model for the platform or as a custom model on
an individual agent.

<Note>
  This page is reserved for superadmins. It appears under **Settings** in the admin menu only if your
  account has superadmin rights.
</Note>

## Add a model

1. Go to **Settings** > **LLM providers & models**.
2. Click **Add model**.
3. Choose a **Provider** from the list (OpenAI, Anthropic, Mistral, Google (Vertex AI), Azure
   OpenAI, AWS Bedrock, OpenRouter, Groq, Cerebras).
4. Choose a **Model ID** from the suggestions. If the model you need is not listed — for example a
   model released after your AGO version — pick **Other (enter manually)** and type its ID.
5. Adjust the **Display name** if needed. This is the name shown when picking a model for an agent,
   and it must be unique.
6. Click **Save**.

The provider is registered automatically the first time you add one of its models, so there is no
separate step to create it.

### Model ID vs display name

* **Model ID** is the identifier sent to the provider's API (for example `gpt-4.1`). For Azure
  OpenAI, this is the name of your **deployment**, not the underlying model.
* **Display name** is the label your team sees inside AGO (for example `GPT-4.1 (fast)`).

### Reasoning effort

Providers that support reasoning (OpenAI, Mistral, OpenRouter) show a **Reasoning effort** field.
Leave it on **No reasoning** unless the model you registered is a reasoning model — sending a
reasoning setting to a model that does not support it makes every call fail.

### Azure credentials

Azure OpenAI models can carry their own **Endpoint**, **API version** and **API key**. All three are
optional: leave them empty and AGO falls back to your tenant's Azure settings, then to the
instance-level Azure configuration. The API key is stored encrypted and is never displayed again —
the field stays empty when you reopen the model, and typing a new value replaces the stored one.

## Edit a model

Click any row to open it. You can rename it, point it at a different model ID, change its reasoning
effort, or move it to another provider. Switching a model away from Azure removes its stored Azure
credentials.

## Delete a model

Open the row menu and choose **Delete**. A model that is still in use cannot be deleted: the **Used
by** column shows where it is referenced (the platform default, fast or reasoning model, or a
specific agent). Point those settings at another model first, then delete it.