Reference & Data Model
LLM provider (llm_provider)
An LLM provider is the organization's own access to a language model service, in addition to the platform models.
Purpose
Section titled “Purpose”With an LLM provider (Bring Your Own Key) the organization uses its own contract with Anthropic, OpenAI or an OpenAI-compatible endpoint. The provider’s models are then available for selection by Polaris, agents and the organization’s task models. (Data type: configuration)
Where in the app
Section titled “Where in the app”Aligia AI › Agenten › LLM Provider (page „LLM-Anbieter“). List with kind and status badge, detail page with tiles „Modelle“ (Models), „Art“ (Kind), „Zuletzt geprüft“ (Last validated), the card „API-SCHLÜSSEL“ (API key) and the model table. See Guides › LLM provider.
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Name | name |
Text | yes | display name | – |
| Kind | kind |
Selection | yes | „Anthropic“, „OpenAI“, „OpenAI-kompatibel“ (OpenAI-compatible) | – |
| Base URL | base_url |
Text | no | full URL incl. path, e.g. https://…/v1 |
only for „OpenAI-kompatibel“; cleared otherwise |
| Status | status |
Selection | yes | validation state, see States | System |
| Last error | last_error |
Text | no | reason of the last error | System; tooltip on the badge |
| Last validated | last_validated_at |
Date | no | time of the last validation | System |
| API key stored | auth_kind |
Selection | no | static = key present |
System; the card shows „Ein API-Schlüssel ist hinterlegt.“ (An API key is stored.) or „Es ist kein API-Schlüssel hinterlegt.“ (No API key is stored.) |
Not visible: agent mode, credential generation.
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| LLM model | has many | no | – | models deleted along |
States
Section titled “States”| Value | Label | Meaning |
|---|---|---|
unconfigured |
Nicht konfiguriert (Not configured) | no key stored |
validating |
Wird geprüft… (Validating…) | validation running (also when a key has just arrived) |
connected |
Verbunden (Connected) | validation successful |
error |
Fehler (Error) | validation failed, see Last error |
awaiting_model |
Modell fehlt (Model missing) | key valid, but no model created yet |
Rules & automation
Section titled “Rules & automation”- „Verbinden“ (Connect), „Ersetzen“ (Replace) and „Verwalten“ (Manage) on the key card lead to the separate account interface.
- If „Polaris-Plattformmodelle erlauben“ (Allow Polaris platform models) is switched off in the settings, only models of own providers remain selectable; tasks without an own model then fail.