> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plattformüberwachung

> Behalte jeden Live-Anruf über alle Tenants im Blick – nur für Plattformadmins

Über `/admin/monitoring` behältst du **jeden aktiven Anruf über alle Tenants und Nutzer hinweg** im Blick – die plattformweite Version des Tenant-Live-Monitors, ganz ohne Tenant-Filter.

## Was du siehst

* **Alle aktiven Anrufe** (`queued`, `ringing`, `in_progress`) auf der gesamten Plattform – jeweils angereichert mit dem Namen des Assistenten, dem Namen des Tenants und der E-Mail-Adresse des Besitzers.
* **Latenz-Insights** – plattformweite p50/p95-Werte für End-to-End-Latenz, LLM-Time-to-First-Token, TTS-Time-to-First-Byte und STT, jeweils über die letzten 24 Stunden (aus `call_turn_metrics`).
* **Admission Control** – startende und aktive Reservierungen, Ablehnungen der letzten 24 Stunden, globaler Zustand sowie Plattform-, Regions- und Capability-Steuerung. Fehlt die globale Steuerung, gilt die Plattform als nicht verfügbar.

## Admission Control

Admission Control ist die interne Sicherheitsgrenze vor dem Start einer neuen Realtime-Session. Sie schützt Workspace- und Kampagnen-Parallelität atomar und prüft danach globale, regionale, kanal-, modus- und providerbezogene Kapazität. Unbenutzte Vorabreservierungen laufen automatisch ab; abgeschlossene Calls geben ihren Slot frei.

Plattform-Admins können Zustand, Annahme neuer Sitzungen, ein hartes Kapazitätslimit und einen Betriebsgrund ändern. Kapazitätsänderungen können neue Sessions sofort beeinflussen. Deshalb verlangt die UI eine ausdrückliche Bestätigung und protokolliert Operator, resultierenden Zustand und Änderungszeit. Die Steuerung erscheint bewusst nur unter `/admin/monitoring` – niemals im Tenant-Monitoring, in Kampagnen oder in der History.

## Supervisor-Aktionen

Für jeden aktiven Anruf steht dir derselbe Realtime-Mechanismus zur Verfügung wie beim Tenant-Monitor – nur ganz ohne Tenant-Scope:

* **Mithören** – ein unsichtbarer, nur lauschender Teilnehmer betritt den Raum.
* **Eingreifen** – du bist hör- und sichtbar mit dabei und sprichst aktiv mit.
* **Flüstern** – schicke dem Agenten eine private Anweisung.
* **Übernehmen** – beende den Turn des Agenten und übernimm den Anruf als Supervisor.

## Auth & Audit

Für den Zugriff brauchst du Plattformadmin-Rechte (`requirePlatformAdmin`); Impersonation wird ignoriert, und es gibt **kein Plan-Gate** – als Plattformadmin siehst du wirklich alles. Jede Aktion landet im Admin-Audit-Log.

* `GET /api/admin/monitoring` – aktive Anrufe + Latenz-Aggregate.
* `POST /api/admin/monitoring` – Supervisor-Aktionen (`listen_token`, `whisper`, `end_agent`, `hangup`) und die interne Operation `set_capacity_control`.

<Note>
  Dieses Tool ist ausschließlich für Plattformadmins gedacht und ist weder Teil der öffentlichen v1-API noch des MCP.
</Note>