# AI Model and Agents Availability Control

### Overview

AI Model Availability Control allows **bot owners** and **bot editors** to curate which LLMs and Agents are available to all bot users. By starring specific models in the bot settings, you can restrict the model selection to only the options you recommend — ensuring users get the best results from your bot while helping to prevent excessive token usage.

***

### Prerequisites

* You must have the **Bot Owner** or **Bot Editor** role for the bot you want to configure
* The LLMs and Agents you want to make available must already be enabled for your platform by your admin

***

### How It Works

The AI Model Availability Control uses the **star icon (★)** in the bot settings to determine which models are available to users. The behavior changes depending on whether any models have been starred:

| Scenario                        | Quick Model Selector Behavior              | "Show Detailed AI Model List" Link                                               |
| ------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------- |
| **No models starred** (default) | All LLMs and Agents available to everyone  | Visible and accessible to all users                                              |
| **One or more models starred**  | Only starred models are shown to all users | Hidden for all users; bot owners/editors see a quicklink to Bot Settings instead |

***

### Starring Models to Restrict Availability

Follow these steps to curate the LLMs and Agents available to your bot users.

#### Step 1 — Open Bot Settings

1. Navigate to the bot you want to configure.
2. Open the **Bot Settings**.
3. Select the **AI Models** section.

<figure><img src="/files/TNmmKKIdhn6xjinVn7B1" alt=""><figcaption></figcaption></figure>

***

#### Step 2 — Star the Desired LLMs or Agents

1. In the AI Models list, locate the LLM or Agent you want to make available.
2. Click the **star icon (☆)** on the right side of the model name. The star fills in (★) to indicate the model is now selected.
3. Repeat for each additional model you want to make available.

<figure><img src="/files/SdjbW24yuiaPCms14nlJ" alt=""><figcaption></figcaption></figure>

***

#### Step 3 — Verify the Quick Model Selector

1. Close the Bot Settings.
2. Click the **Quick Model Selector** in the top-left corner of the data room.
3. Confirm that only the starred models appear in the list.

<figure><img src="/files/RBj3vl8Q4q2MYE8Kk7zp" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
After starring at least one model, the "Show Detailed AI Model List" link is no longer displayed in the Quick Model Selector — for any user, including bot owners and editors. This is expected behavior.
{% endhint %}

***

### Removing Model Restrictions

To restore full model access for all users:

1. Open the **Bot Settings** and navigate to **AI Models**.
2. Click the **star icon (★)** on each starred model to **unstar it (☆)**.
3. Once **all stars are removed**, all users regain access to the complete list of LLMs and Agents available on the platform, including the "Show Detailed AI Model List" link.

<figure><img src="/files/UEMHla0gp34bFr4cEzbE" alt=""><figcaption></figcaption></figure>

***

### Behavior by User Role

The table below summarizes what each role can see and do when this feature is in use:

| Capability                                   | Bot Owner / Bot Editor                                  | Bot User                                                |
| -------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
| **Access Bot Settings → AI Models**          | ✅ Yes                                                   | ❌ No                                                    |
| **Star/unstar models**                       | ✅ Yes                                                   | ❌ No                                                    |
| **Quick Model Selector — no models starred** | All models visible + "Show Detailed AI Model List" link | All models visible + "Show Detailed AI Model List" link |
| **Quick Model Selector — models starred**    | Only starred models visible + quicklink to Bot Settings | Only starred models visible; no additional links        |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blockbrain.ai/for-builders/manage-bot-access/ai-model-and-agents-availability-control.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
