Skip to main content

System

Review your Ender Turing license and version, track monthly usage and active agents, manage ASR languages and component versions, upload a new license file, and configure OIDC authentication. This article is automatically maintained (system).

Overview

The System page brings together the platform-level information and controls an administrator needs to keep an Ender Turing installation healthy. From here you can see which version is running, check your license and remaining capacity, track how much of that capacity each month consumes, upload a new license file, install or activate ASR languages and platform components, and — for organizations that sign in through a federated identity provider — configure how OIDC users are provisioned.

This page is intended for platform owners and administrators rather than day-to-day users.

How It Works

Accessing the System Page

  1. Open Settings from the main navigation.

  2. In the Settings menu, select System.

The horizontal tabs across the page separate the System overview from related configuration. Select Usage, the final tab, to open monthly and LLM usage reporting.

Only users with the system management permission can open this page. If your role does not include that permission, the System entry does not appear in the Settings menu.

In multi-tenant deployments, several cards on the page are hidden because version, container, and license-file management are handled centrally rather than per organization.

System and Version Card

The first card on the page shows the system identity and update status:

  • Version — the version of Ender Turing that is currently running.

  • An update available indicator appears in red next to the version when a newer release has been detected. Use the refresh icon to re-check for updates on demand.

  • Reset downloads appears on hover (single-tenant only) when you need to clear any downloaded but unactivated update files.

  • Show beta versions — when enabled, beta and development builds appear in the lists of available languages, connectors, and services so they can be downloaded and tested.

If online updates have been disabled at the system level, a banner explains that updates are offline-only. When archives containing updates have been uploaded, an Unpack uploaded archives button appears so you can prepare them for installation.

License Card

The License section summarizes what your license grants:

  • ID — the product identifier issued for your organization.

  • Conversations limit — the maximum number of conversations covered by the license, or a dash if not limited.

  • Active agents limit — currently displays the same value as Conversations limit; the license file does not yet expose a distinct active-agents cap on this screen.

  • Expiry — the date on which the license expires.

Monthly Usage

The first card on the Usage tab is Monthly usage. It tracks consumption month by month, starting with the current month. Each row is labeled with the month and year, and the current month is marked Month to date so you can tell that its numbers are still growing.

Two views are available through the toggle in the card title:

  • Active agents — the number of agents who had at least one conversation in that month, shown as a count against your active-agents limit with a progress bar.

  • Total duration — the combined length of all conversations in that month, formatted in hours and minutes, with the conversation count underneath.

By default the most recent two months are shown. Use the chevron toggle on the right side of the card title to expand the view to the most recent six months, or collapse it back to two.

Only conversations that are attributed to an agent count toward the active-agent figures. Conversations without an agent still count toward the conversation count and total duration.

Full-Time and Part-Time Active Agents

Some organizations have this card configured to split the active-agent figure into two categories instead of showing a single number. When the split is switched on, the Active agents view replaces the single bar for each month with two bars:

  1. Full-time active agents

  2. Part-time active agents

An agent's category is based on how many separate days they were active in that month:

  • Part-time — active on 1 to 10 distinct days.

  • Full-time — active on 11 or more distinct days.

Several conversations on the same day count as one active day. Every active agent falls into exactly one category, and the two counts always add up to the single Active agents figure you would see with the split switched off.

Active days — like the monthly grouping itself — are counted from the day each conversation was added to Ender Turing, not from the day the conversation originally took place. If your conversations arrive in bulk imports, several days of real activity can land on a single day here, which lowers an agent's active-day count.

Both bars are measured against the same active-agents limit from your license — the split does not give you two separate allowances. A short caption above the first month restates the 1–10 and 11+ day definitions.

The split applies to every month shown, not only to months after it was switched on. For the current month, an agent moves from part-time to full-time as soon as they become active on their eleventh distinct day, so a month-to-date row can change category mix as the month progresses.

Switching the Split On or Off

The Show full-time and part-time active agents checkbox in the Monthly usage card title controls this behavior. It is only visible to Ender Turing staff accounts that also have the system management permission, and the same restriction is enforced on the server, so the setting cannot be changed from outside the product either.

The checkbox is off by default for every organization. Selecting or clearing it saves immediately — there is no separate Save button. While the change is being saved the checkbox is disabled, and once it succeeds the card reloads the full six-month history so every visible month reflects the new choice. If saving fails, an error notification appears and the checkbox returns to its previous state.

Administrators in your own organization who do not have the Ender Turing staff account type will not see the checkbox at all, but they do see the full-time and part-time bars once the split has been switched on for the organization.

LLM Usage

The second card on the Usage tab reports large language model (LLM) cost and provider tokens over time. It is always available to users whose role has both the system management and automation management permissions; no reporting switch needs to be enabled.

Users with system management permission but without automation management permission continue to see Monthly usage, but the LLM Usage card is not loaded. Users with automation management permission alone cannot open the System Usage tab.

Filters and controls:

  • Active / Archived — include active prompts, archived prompts, or both

  • Split by — break down usage By Prompt, By Model, or By Ender

  • Metric — choose what the chart and table measure (see Choosing a metric below). USD and provider-token metrics are always available.

  • Select Prompts — choose specific prompts to analyze, or leave empty to include all

  • Date range — select a month or custom date range (defaults to the current month)

The card displays:

  • A stacked bar chart showing daily trends over the selected period

  • A data table with per-day values and a Total for each dataset

When you split By Ender or By Model, some usage may not be tied to a specific Ender or model — for example, usage that did not run through an automation. It is grouped together under an __HTML_PLACEHOLDER_0__ entry in the chart and table so the full picture still adds up.

Choosing a Metric

The metric selector offers:

Metric

What it shows

USD

Cost in US dollars, shown with four decimal places. This is the default metric.

Input tokens

Tokens the model provider counted for the text sent to it (your prompt plus the conversation content).

Cached input tokens

The part of the input the provider served from its own prompt cache. These tokens are already included in Input tokens — they are shown separately because providers usually bill them at a different rate.

Output tokens

Tokens the model produced in its answer.

Total tokens

Input tokens + Output tokens. Cached input tokens are not added again, because they are already part of the input.

Token counts are shown as whole numbers, formatted for your interface language. Switching the metric does not change the other filters — the date range, prompt selection, and Split by grouping stay as you set them.

When Token Values Show as Unavailable

Token counts started being recorded only when this capability was added to your platform. Usage that was recorded earlier has no token information, and no estimate is produced for it. Where token data is missing you will see:

  • Unavailable in the data table instead of a number

  • A gap in the chart instead of a bar segment

Missing values are never displayed as zero, so you can tell "we have no data" apart from "no tokens were used". Because a single missing record makes the whole aggregate unreliable, the rule applies upward as well: if any day contributing to a row is unavailable, that row's Total for the selected period also shows Unavailable. Input, cached input, and output tokens are tracked independently, so it is normal to see a real number for one of them and Unavailable for another.

Answers served from cache count as zero tokens. When Ender Turing reuses a previously generated response instead of calling the provider again, the run is recorded with zero input, cached input, and output tokens — because no provider request took place. This is a real zero, not missing data.

Authentication (OIDC Deployments Only)

The Authentication card is shown only on deployments that use a federated identity provider (OIDC). On installations without OIDC configured, this card does not appear.

The card contains one control:

  • Auto-create ET users on first OIDC login — when enabled, a federated identity provider user (for example an Entra ID user) who signs in for the first time gets an Ender Turing account created automatically. If an existing Ender Turing account matches by verified email address, the new identity is linked to that account; otherwise a new account is created with the Agent role.

  • Click Save to apply the change.

This control is the same option that can otherwise only be flipped by directly editing the underlying setting. If you turn it off, federated users without an existing Ender Turing account will be rejected at sign-in until they are invited by an administrator.

To verify which accounts came in through this flow, open a user from Users & Agents — accounts that were linked to a federated identity show an OIDC linked badge below the last login row.

Updater

When an update is detected and confirmed, an additional System update info section appears showing the new version, the changelog, and the current state of the in-flight updater container. From there you can:

  • Go to the dedicated updater interface to follow the upgrade.

  • Turn off the updater after a successful upgrade.

  • Download the new images, prepare the upgrade, and roll back if downgrade files are available.

These controls are only meaningful in single-tenant deployments where the platform is managed by your own administrators.

ASR Languages

The ASR languages card lists the speech-recognition language packs that are part of your license. Each row shows the language name and the versions available. Version chips use color to indicate state:

  • Green — the version is active and being used for recognition.

  • Orange — the version is downloaded and ready; click the chevron icon to activate it.

  • Red — the version is not yet downloaded; click the download icon to install it. Installation can take more than 10 minutes.

  • Orange with a spinner — the version is currently downloading.

By default the list hides obsolete entries: it always shows the latest version, the currently active version, and the two most recently downloaded versions, plus any beta or development builds when Show beta versions is on.

Connectors and Services

The Connectors and Services cards work in the same way as ASR languages. Each row lists an installable component and shows version chips that you can download or activate using the same color-coded indicators. These cards are visible in single-tenant deployments only.

Upload License File

The Upload License File expansion panel lets you apply a new or renewed license:

  1. Click the panel header to expand it.

  2. Click the file input and select your license text file.

  3. Click Submit.

If the file is rejected, an error message appears under the file selector. After a successful upload the system checks for updates automatically so any new entitlements (such as new languages or higher limits) become visible without further action.

This panel is available in single-tenant deployments only.

Access and Permissions

Action

Who can do it

Open the System page

Users with the system management permission

Change the Show beta versions toggle

Users with the system management permission (single-tenant deployments)

Activate or download ASR languages, connectors, services

Users with the system management permission (single-tenant deployments)

Upload a new license file

Users with the system management permission (single-tenant deployments)

Toggle Auto-create ET users on first OIDC login

Users with the system management permission, on OIDC deployments only

View monthly usage and license details

Users with the system management permission

Open the Usage tab

Users with the system management permission

View LLM usage

Users with both system management and automation management permissions

See the full-time / part-time active-agent split

Users with the system management permission, once the split is switched on for the organization

Switch the full-time / part-time split on or off

Ender Turing staff accounts that also have the system management permission

Important Notes

  • Many of the controls described above are unavailable on multi-tenant deployments because lifecycle management is handled centrally.

  • Language, connector, and service downloads are background operations and can take several minutes. The status chip updates automatically once each step completes.

  • License updates do not require a restart; new entitlements take effect after the next update check.

  • The Authentication card only manages the auto-provisioning behavior described above; it does not configure the identity provider itself, which is set up at deployment time.

Did this answer your question?