> ## 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.

# Natural-Language-Dashboards

> Aus einer natürlichsprachlichen Analysefrage sichere, prüfbare Dashboard-Insights erstellen.

Mit Natural-Language-Dashboards beschreibst du eine gewünschte Auswertung in normaler Sprache. Die Plattform übersetzt die Anfrage in freigegebene semantische Metriken, zeigt eine Vorschau und speichert erst nach deiner Bestätigung.

## Dashboard-Ansicht erstellen

1. Öffne ein benutzerdefiniertes Dashboard.
2. Wähle **Build with AI**.
3. Beschreibe Metriken, Zeitraum, Vergleich und Filter.
4. Wähle **Preview insights** und prüfe jede vorgeschlagene Karte.
5. Wähle **Add insights**, um den Plan zu speichern.

Beispiel:

> Zeige Erfolgsquote und durchschnittliche Dauer für ausgehende Anrufe der letzten 30 Tage.

Der manuelle Editor **Add insight** bleibt verfügbar. Generierte Insights sind normale Dashboard-Widgets und können danach bearbeitet, skaliert, sortiert oder entfernt werden.

## Unterstützte Analysesprache

Der integrierte Planner versteht Gesprächsvolumen, zeitliche Aktivität, Erfolgsquote, durchschnittliche oder gesamte Dauer, Assistenten- und Kampagnenleistung, Ergebnis, Status, Richtung, Stimmung und letzte Gespräche. Unterstützt werden Zeiträume von 7, 14, 30 und 90 Tagen sowie Vergleiche mit dem vorherigen Zeitraum.

Provider-Kosten und interne Abrechnungsfelder sind bewusst nicht verfügbar. Kundenorientierter Verbrauch bleibt über die kanonischen Minuten- und Credits-Ansichten der Plattform verfügbar.

Filter sind auf freigegebene Werte für Status, Richtung, Stimmung und Erfolg begrenzt. Kann eine Anfrage nicht sicher zugeordnet werden, liefert die Vorschau einen klaren Validierungsfehler, statt zu raten.

## Sicherheitsmodell

<Note>
  Der Planner kann weder SQL ausführen noch beliebige Tabellen oder Felder anfordern. Vorschau und Speichern verwenden denselben versionierten semantischen Metrikkatalog. Beim Speichern wird der vollständige Plan vor jedem Schreibvorgang erneut validiert.
</Note>

Dashboard-Autorisierung und Analytics bleiben auf den aktiven Workspace begrenzt. Ein API-Key kann damit nicht auf einen anderen Workspace zugreifen. Das Plan-Entitlement `custom_dashboards` gilt weiterhin.

Der deterministische Planner funktioniert auch ohne separat konfiguriertes Sprachmodell.

## Public API

`POST /dashboards/{id}/natural-language` erzeugt eine Vorschau ohne Schreibzugriff. Sende den zurückgegebenen Plan unverändert an `PUT /dashboards/{id}/natural-language`, um ihn erneut zu validieren und seine Widgets zu speichern.

Beide Operationen benötigen den Scope `dashboards:write` oder den älteren Scope `calls:write`. Das vollständige Request- und Response-Schema steht in der API-Referenz.