> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/ai-workbench-qore/control-center/ai-gateway.md).

# AI Gateway

Every model request an agent makes passes through AI Gateway. Configure the model families your organization approves once, and agents then request a capability **tier** — Economy, Smart, or Premium — rather than naming a model.

That indirection is the point. When a better model arrives, an administrator remaps the tier and every agent picks it up. No agent is edited, and no model name is hard-coded in an application.

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td><strong>How Model Routing Works</strong></td><td>Families, providers, gateways, credentials, and tiers — read this first.</td><td><a href="/ai-workbench-qore/control-center/ai-gateway/how-model-routing-works.md">How Model Routing Works</a></td></tr><tr><td><strong>Model Catalog</strong></td><td>Check which models and providers are available, and their context windows.</td><td><a href="/ai-workbench-qore/control-center/ai-gateway/model-catalog.md">Model Catalog</a></td></tr><tr><td><strong>Gateway Settings</strong></td><td>Enable families, authenticate providers, and map a model to each tier.</td><td><a href="/ai-workbench-qore/control-center/ai-gateway/gateway-settings.md">Gateway Settings</a></td></tr></tbody></table>

## Configure and verify

{% stepper %}
{% step %}

#### Choose the families

Enable each approved family in [Gateway Settings](/ai-workbench-qore/control-center/ai-gateway/gateway-settings.md) and designate one as the default. The default serves any request that doesn't name a family.
{% endstep %}

{% step %}

#### Connect providers and credentials

For each family, choose a gateway, then authenticate its providers with a **UPTIQ managed key** or **Bring your own key**.
{% endstep %}

{% step %}

#### Map the tiers

Assign a model to Economy, Smart, and Premium. Save one family before moving to the next — unsaved changes are discarded.
{% endstep %}

{% step %}

#### Audit before you deploy

Open [Model Catalog](/ai-workbench-qore/control-center/ai-gateway/model-catalog.md) and confirm each provider you rely on shows `Enabled` before agents depend on it.
{% endstep %}
{% endstepper %}

## At a glance

| Question                     | Answer                                                                                                     |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| What it controls             | Which model families, providers, and models agents can reach                                               |
| Who configures it            | An administrator with Control Center access                                                                |
| Scope                        | Account. Family availability, credentials, and tier mappings apply to all account activity                 |
| Where usage appears          | [Credit Usage](/ai-workbench-qore/control-center/cost-control/credit-usage.md) for managed-key spend       |
| Where a served request shows | [Runs & Traces](/ai-workbench-qore/control-center/observe/runs-and-traces.md) shows the model and provider |
| Where changes are recorded   | [Audit Trails](/ai-workbench-qore/control-center/observe/audit-trails.md)                                  |

{% hint style="info" %}
Model Catalog reports status only. Every change to provider configuration happens in Gateway Settings.
{% endhint %}

## Where requests run

The provider you authenticate decides which cloud account and region serves the inference, and a bank-owned deployment can keep the whole runtime inside its own perimeter. See [Security FAQ](/ai-workbench-qore/control-center/detailed-security-and-runtime-faq.md) for deployment architecture, data residency, and what the platform logs.

For common questions and fixes, see [AI Gateway: FAQs & Troubleshooting](/ai-workbench-qore/control-center/ai-gateway/ai-gateway-faqs-and-troubleshooting.md).

## Related

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td><strong>Cost Control</strong></td><td>Track credits and set usage limits against model spend.</td><td><a href="/ai-workbench-qore/control-center/cost-control.md">Cost Control</a></td></tr><tr><td><strong>Observe</strong></td><td>Inspect runs, LLM calls, and configuration history.</td><td><a href="/ai-workbench-qore/control-center/observe.md">Observe</a></td></tr><tr><td><strong>Agent Controls</strong></td><td>Stop selected agents or all agents during an emergency.</td><td><a href="/ai-workbench-qore/control-center/govern/agent-controls.md">Agent Controls</a></td></tr><tr><td><strong>Glossary</strong></td><td>Look up family, provider, gateway, tier, and credential terms.</td><td><a href="/ai-workbench-qore/start-here/glossary.md">Glossary</a></td></tr></tbody></table>

***

{% columns %}
{% column width="83.33333333333334%" %}

<p align="right"><em>Maintained by</em> <mark style="color:green;">Abhishek Paul</mark><br><code>AI-assisted, human-approved</code></p>
{% endcolumn %}

{% column width="16.666666666666664%" %}

<div align="left"><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-d034645b4f8f8ee661985f5306b60ded3289653c%2Fmaintainer-abhishek-paul.png?alt=media" alt="" width="60"></div>
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.uptiq.ai/ai-workbench-qore/control-center/ai-gateway.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.