Configuration field reference
A configuration combines model selection, prompt composition, budgets and
access rules. The operation comes from the calling service; there is no
use_ field. Fixed selection needs a usable model_ at
execution. Criteria selection resolves a model for each operation.
Defaults below are form defaults from TCA, not promises that a blank record
can execute. system_ is optional. Zero budget limits mean unlimited;
checks are preflight checks, not atomic reservations.
| Field | TCA type | Default | Required in TCA | Effect |
|---|---|---|---|---|
hidden | check | 0 | no | TYPO3 record visibility; separate from runtime is_active. |
identifier | input | unset in TCA | yes | Unique programmatic identifier. |
name | input | unset in TCA | yes | Backend display name. |
description | text | unset in TCA | no | Description for operators. |
model_ | select | "fixed" | no | fixed selects model_uid; criteria resolves an eligible model per operation. |
model_ | select | 0 | no | Fixed model reference; shown only in fixed mode. TCA permits zero; execution still needs a usable model. |
model_ | select | empty | no | Required capabilities and routing criteria; shown in criteria mode. |
translator | select | empty | no | Specialized translator selection; not the LLM operation type. |
system_ | text | unset in TCA | no | Optional system instruction; not required by TCA. |
system_ | select | unset in TCA | no | Declared sensitivity of non-empty system text; empty is undeclared. |
temperature | number | 0. | no | Requested sampling temperature; adapter/model support varies. |
max_ | number | 1000 | no | Requested output budget; zero inherits. Reasoning adapters may raise it. |
top_ | number | 1 | no | Requested nucleus-sampling value; adapter/model support varies. |
frequency_ | number | 0 | no | Requested repetition penalty; adapter support varies. |
presence_ | number | 0 | no | Requested topic-presence penalty; adapter support varies. |
timeout | number | 0 | no | Configuration timeout override in seconds; zero inherits. |
options | text | unset in TCA | no | Additional adapter options; validate against the selected adapter. |
answer_ | number | 0 | no | Opt-in answer-cache seconds, zero off; privacy and call-path restrictions apply. |
max_ | number | 0 | no | Configuration daily request ceiling; zero unlimited. |
max_ | number | 0 | no | Configuration daily token ceiling; zero unlimited. |
max_ | number | 0 | no | Configuration daily estimated-cost ceiling; zero unlimited. |
fallback_ | text | empty | no | Ordered alternative configuration identifiers for eligible failures. |
is_ | check | 1 | no | Whether the record is eligible for runtime use. |
is_ | check | 0 | no | Installation default configuration, or default model within its provider. |
allowed_ | select | unset in TCA | no | Backend-group access restriction; empty leaves it unrestricted. |
allowed_ | select | empty | no | Per-configuration group policy; intersected with global and actor gates. |
excluded_ | select | empty | no | Explicit per-configuration exclusions, including remote tools. |
allowed_ | select | empty | no | Per-configuration guardrail selection; does not bypass mandatory policy. |
require_ | check | 0 | no | Require another eligible user to approve the initiating user's write. |
snippet_ | select | empty | no | Compose active snippets with selected tags; admin-only field. |
snippets_ | check | 0 | no | Also compose snippets into an explicit caller system message. |
skills | select | unset in TCA | no | Always-loaded skill attachments; version approval and trust gates still apply. |
skills_ | select | unset in TCA | no | On-demand attachments offered for explicit loading, not eager injection. |
preset_ and tstamp are passthrough metadata, not editable form
settings. See Configuration parameters and policies for cache eligibility, prompt
composition and fallback details, and Backend user permissions for
actor grants.