Console messages and states
A message in the Console names a state, not always a fault. Each string the Console displays is mapped here to the condition behind it and the action that clears it. Errors returned to a client by the gateway are a separate surface, catalogued in Gateway behavior.
How to read a Console state
Three rules cover most confusion:
- A Console message reflects stored configuration, not what the gateway is serving. A saved value is displayed as soon as it is stored, whether or not the data plane has received it. See Configuration propagation.
- An empty list is a state, not an error. Most empty states in the Console mean a prerequisite has not been completed, and they name it.
- A message about the data plane is usually about registration, not connectivity. Nothing in Agent Router connects inbound to a data plane, so a message about a missing data plane URL never means a connection is failing.
Data plane states
"DP is not yet configured"
A badge shown wherever the Console names the active data plane, with the hover text The administrator needs to complete the DP URL configuration.
| Means | No gateway address has been recorded for the data plane. It is not a connectivity check and does not mean a connection was attempted and failed |
| Triggered when | The organization has no data plane at all, or has one whose gateway URL is unset. Where several data planes exist, the badge appears against each entry missing a URL rather than across the whole selector |
| Cleared by | Registering the URL under System → Settings → Data planes |
| Who can clear it | An administrator. The message is shown to developers, who cannot act on it themselves |
The field this refers to is described in the onboarding wizard as the URL the management plane uses to reach the AI Gateway. That description is misleading and has been read as an inbound connection requirement. It is not one. What the value is actually used for, and why it does not need to be externally reachable, is set out in The Data plane URL field.
"Data Plane Not Configured"
The same condition as above, rendered as a full placeholder in the Playground with the message The administrator needs to complete the DP URL configuration. The Playground sends real traffic through the gateway, so it cannot open until a gateway address exists.
"Degraded" on a healthy fresh install
| Means | The management plane sees the data plane, but nothing is currently routable through it. On a fresh install whose pods are all healthy, the usual cause is that no model has been granted to a project attached to this data plane: enabling a provider or model in the organization catalog makes it grantable, not routable |
| Triggered when | A data plane is connected before any project attached to it holds a model grant, or after the last grant is removed |
| Cleared by | Granting at least one model to a project attached to the data plane. See Add providers and models to projects |
| Who can clear it | An administrator, in project scope in the Admin Console |
tare doctor on the cluster reports the same condition as route warnings ("none found") on a report that is otherwise healthy, which is the confirmation that the install itself is done.
Playground placeholders
The Playground shows a placeholder rather than a prompt box until every prerequisite is met. Each names the missing one, and they are evaluated in this order, so the first unmet prerequisite is the one displayed.
| Title | Message | Condition | Action |
|---|---|---|---|
| Data Plane Not Configured | The administrator needs to complete the DP URL configuration. | No gateway URL is registered | Administrator registers the data plane URL |
| API Key Required | You need to create an API key to use Playground. | The account holds no API keys | Create one, from the placeholder's own button or from API Keys |
| API Key Required | Select an API key from the top bar to begin. | Keys exist, none is selected | Select a key in the top bar |
| Model Not Selected | Use the dropdown above to select a model. | No model is selected | Select a model. An empty dropdown is a separate condition, see below |
| Ready to Test | Select models, configure parameters, and click "Run Tests" to begin. | Everything is ready, in the comparison view | None. This is the ready state |
| Ready to Chat | Type a message below to start the conversation. | Everything is ready | None. This is the ready state |
"Not available here" in the model picker
The model picker offers what the selected API key can actually reach, which is not the same as what the organization has enabled. Since 0.3.0 the difference is shown rather than hidden: models the panel will not let the key call are listed under Not available here, dimmed and unselectable, each carrying its reason (the model is turned off, its provider is turned off, or its mode is not one the panel sends), and hovering a row explains where to fix it. Searching finds these models too, so a configured-but-unreachable model no longer returns "no model found". Models enabled elsewhere on the deployment but not added to the key's project are counted rather than listed while browsing, and appear when searched by name.
A key that reaches fewer models than the catalog shows is the normal appearance of a project grant, not a fault. Enabling a model in the organization catalog makes it available to assign; it does not make it callable. The model and its provider must also be assigned to the project the key belongs to, covered in Add providers and models to projects.
A model saved without a mode is offered in the chat picker rather than hidden: the gateway already routes such a model as chat, so before 0.3.0 it could be called with curl while being impossible to select in the Playground.
To see what a key can reach without going through the Console, call GET /v1/models with that key. It returns exactly the routable set.
Provider and model states
| State | Means | Next step |
|---|---|---|
| A provider is enabled but no model behind it is callable | The provider most likely has no working credential. Agent Router Enterprise supplies no Tetrate-managed provider keys, so a credential is a day-one prerequisite rather than a cost optimization | Add providers and models to projects |
| A model is enabled in the catalog but a request returns 404 | The model is not assigned to the project the key belongs to | Create a project and grant models |
| A model expected on a key's Fallback or Traffic Splitting picker is not listed | Those pickers answer for the project the key belongs to, not the project the switcher is on. The model is not assigned to the key's project | Add providers and models to projects |
| A fallback or traffic-splitting save is rejected with an error naming a model | The policy names a model that is not assigned to the project the key belongs to | Add providers and models to projects |
| A model was enabled moments ago and is not yet callable | The change has not reached the data plane. The Console reads the catalog and shows it immediately; the gateway serves delivered configuration | Configuration propagation |
| The Console shows a provider as enabled while the data plane does not serve it | The same divergence, seen from the other side. It is expected briefly and worth investigating after a full sync interval | When a change has not taken effect |
The Console cannot be used to tell "applied" from "saved": it displays a stored value either way. A change is confirmed by sending a request through the gateway.
Where the running version is read
Since 0.3.0 the release version in service is read from the product itself, which is the answer a support conversation asks for first:
- Both consoles show the management plane's release version in the user menu. The web app's own build number is still shown, labeled as a build; it is tagged per commit and reused across releases, so on earlier releases it was the only number shown and could not say which release was serving.
- The Admin Console data plane list carries a Version column with the version each data plane last reported. A data plane that has stopped reporting shows its version marked as last-reported, so history is not presented as current.
The walkthrough, including the in-product Releases page behind the user menu's Release link, is Check the management plane version and release notes.
Announcement banners
Banners at the top of the Console with an information, warning, or critical style are operator-published announcements rather than system states. A critical announcement cannot be dismissed until an operator archives it. Publishing and archiving them is covered in Communicate with Agent Router users.
Related
- Gateway behavior: the error codes and bodies a client receives
- Configuration propagation: why the Console and the gateway can disagree
- Reading tare doctor output: the equivalent state reference for a self-hosted data plane