Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > ALBERT | AI Suite > ALBERT | AI Kostenkontrolle


ALBERT | AI Kostenkontrolle verwenden

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Suite. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Die ALBERT | AI Kostenkontrolle zeigt Ihnen, wie die KI-Funktionen in agorum core pro genutzt werden: wie viele Aufrufe es gab, welche KI-Voreinstellungen und Modelle verwendet wurden, wie viele Token und Tool-Aufrufe angefallen sind und welche Kosten daraus geschätzt werden. Auch die Sitzungen externer Coding Agents wie Claude Code können dort erscheinen.

Die Auswertung öffnen

Öffnen Sie im Hauptmenü den Eintrag KI Nutzungs- & Kostenanalyse.

Ergebnis: Die Auswertung öffnet sich mit Filterbereich, Ergebnisliste und Kosten-Diagramm. Wenn Sie Administrator sind, haben Sie zusätzlich Zugriff auf die Oberflächen Anomalie-Check einstellen, Pseudonymisierung und Lokale Zählung. Wenn Sie kein Administrator sind, sehen Sie diese Buttons nicht.
 

Die KI Nutzungs- & Kostenanalyse


Jeder Benutzer sieht seine eigenen Protokolleinträge. Welche Einträge darüber hinaus sichtbar sind, regeln die Berechtigungen. 

Die Aufteilung der Kostenanalyse wählen

In der obersten Zeile der Kopfleiste wählen Sie, wonach das Diagramm aufgeteilt wird:

Schaltfläche Aufteilung
Zeit Nach Zeitabschnitten. Standardanzeige.
Identifier Nach der Kennung aus der Handler-Konfiguration.
Benutzer Nach Benutzer beziehungsweise Pseudonym.
Modell Nach dem verwendeten Modell. Sitzungen externer Agents sind nach Agent und Modell geteilt, siehe Externe Agents in der Auswertung.
Preset Nach der verwendeten KI-Voreinstellung. Sitzungen externer Agents und MCP-Werkzeugaufrufe stehen in einem eigenen Balken Externe Agents.

Hinweis: Bei allen Aufteilungen außer Zeit zeigt das Diagramm die 20 größten Werte, absteigend sortiert.

Die Anzeige Tool-Aufrufe in der Aufteilung Preset

Die Zeitgruppierung wählen

In der Aufteilung Zeit steht unterhalb der Zeile Gesamtkosten eine weitere Zeile mit den Schaltflächen Tag, Woche, Monat und Jahr. Die Gruppierung, die das System von sich aus wählt, ist mit dem Zusatz (Auto) gekennzeichnet; sie richtet sich nach der Länge des angezeigten Zeitraums. Klicken Sie auf eine andere Schaltfläche, um die Gruppierung selbst festzulegen.

Hinweis: Wechseln Sie die Aufteilung, stellt sich die Zeitgruppierung wieder auf Auto zurück.

Die Einträge filtern

Beim ersten Öffnen ist der Zeitraum Heute vorausgewählt. Danach merkt sich die Auswertung Ihre zuletzt gewählte Filterung; über Zurücksetzen kommen Sie wieder auf Heute.

Diese Filter stehen Ihnen zur Verfügung:

Filter Bedeutung
Zeitraum (Startzeit) Heute, Gestern, Letzte Woche, Letzter Monat oder ein selbst gewählter Zeitraum von–bis. Maßgeblich ist der Startzeitpunkt der KI-Runde.
Zeitraum (letzte Änderung) Letzte Stunde bis letzte Woche. Damit finden Sie Einträge, an denen zuletzt etwas geschehen ist.
Monat, Jahr Fasst die Einträge nach Monat beziehungsweise Jahr des Starts zusammen.
Preset Die verwendete KI-Voreinstellung.
Modell-Preset Die Voreinstellung, die das Modell festlegt (nicht zu verwechseln mit dem Modell selbst).
Modell, Anbieter Das tatsächlich verwendete Modell und der KI-Anbieter dahinter.
Benutzer Der Benutzer, dessen Nutzung der Eintrag beschreibt. Bei eingeschalteter Pseudonymisierung steht hier das Pseudonym.
Identifier Die Kennung, die in der Handler-Konfiguration hinterlegt ist.
Währung Die Währung, in der die Kosten gespeichert sind.
Sub-Agent, Übergeordnetes Preset Ob der Eintrag zu einem Sub-Agenten gehört, und aus welcher KI-Voreinstellung dieser gestartet wurde.
Läuft, Unterbrochen, Erledigt Der Zustand des Eintrags, jeweils Ja oder Nein. Wird ein Chat fortgesetzt, setzt das System das Kennzeichen von sich aus wieder auf Nein.

Die Kostenanzeige im Diagramm umschalten

Über die Umschalter-Buttons in der Kosten-Zeile  in der Kopfleiste, beginnend mit Gesamtkosten, wählen Sie, was die Kostenanalyse darstellt:

Anzeige Bedeutung
Gesamtkosten Summe aller Kostenarten. Standardanzeige.
LLM-Kosten Kosten für Input-, Output- und Cache-Token beim KI-Anbieter.
ALBERT Output-Token-Kosten Kosten für den sichtbaren KI-Output einschließlich Tool-Aufrufen.
ALBERT Tool-Aufruf-Kosten Kosten für die Tool-Aufrufe.
Tool-Aufrufe Gezählte Tool-Aufrufe, keine Kosten.
ALBERT Ausgabe-Token Gezählte Ausgabe-Token, keine Kosten.
Durchgänge Gezählte Anfragen im ALBERT | AI Chat und in Coding Agents, keine Kosten. Siehe Durchgänge und aktive Zeit.
Aktive Zeit Die Zeit in Stunden, in der die KI an den Anfragen gearbeitet hat, keine Kosten. Siehe Durchgänge und aktive Zeit.

Durchgänge und aktive Zeit

Ein Durchgang ist eine Anfrage vom Absenden bis zur Antwort – im ALBERT | AI Chat ebenso wie in einem Coding Agent. Die Anzeige Durchgänge zeigt sie als gestapelten Balken: unten die Anfragen der Hauptagents (Anfragen), darüber die Läufe der Sub-Agents (Sub-Agents). Der Tooltip eines Balkens nennt beide Werte. Die Einträge der MCP-Werkzeugaufrufe zählen nicht als Durchgang.

Die Anzeige Durchgänge mit Anfragen und Sub-Agents

Die aktive Zeit ist die Zeit, in der die KI an den Durchgängen gearbeitet hat, bei einer Sitzung eines Coding Agents ohne die Zeit, in der er auf den Benutzer gewartet hat, etwa auf die Antwort auf eine Rückfrage oder auf eine Freigabe. Die Anzeige Aktive Zeit zeigt sie in Stunden.

Das Kennzeichen Schätzwerte

In den Kostenansichten steht neben dem Diagrammtitel ein Kennzeichen Schätzwerte. Die ausgewiesenen Beträge sind ein Indikator zur groben Kostenorientierung und keine Abrechnungsgrundlage. Maßgeblich ist allein die Abrechnung Ihres KI-Anbieters.

Die Beträge entstehen aus den Preisen, die an den KI-Voreinstellungen hinterlegt sind. Diese Preise werden von Hand gepflegt; gestaffelte Anbieterpreise und individuelle Vertragskonditionen lassen sich damit nicht abbilden.

Hinweis: Bei den gezählten Größen, Tool-Aufrufe und ALBERT Ausgabe-Token, erscheint das Kennzeichen nicht, denn dort wird nichts geschätzt.

Was ein Eintrag in der Liste Kostenanalyse bedeutet

Je KI-Runde entsteht ein Eintrag, also je Lauf beziehungsweise je Fortsetzung eines Chats. Ein Chat, der über mehrere Tage läuft, erzeugt deshalb mehrere Einträge, und die Kosten stehen jeweils an dem Tag, an dem sie angefallen sind.

Bei der Sitzung eines Coding Agents entsteht wie bei einem Chat je Durchgang ein Eintrag. Er nennt den Agent, die Zahl der Werkzeugaufrufe und die aktive Zeit, aber keine Token und keine Modellkosten.

Externe Agents in der Auswertung

Externe Agents sind Coding Agents wie Claude Code, die über MCP mit agorum core pro arbeiten. In die Auswertung gelangen zwei Arten von Einträgen:

  • Sitzungen eines Coding Agents, sofern ein Administrator die Protokollierung der Sitzungen eingeschaltet hat, siehe ALBERT l AI Coding Agents einrichten.
  • MCP-Werkzeugaufrufe, also Aufrufe von Werkzeugen von agorum core pro über die MCP-Schnittstelle.

Die Kostenkontrolle erkennt diese Einträge selbst. Ein Agent erscheint mit dem Namen, den er mitschickt, zum Beispiel Claude Code; ohne Namen mit seiner Kennung.

Ansicht Darstellung der externen Agents
Aufteilung Preset Sitzungen aller Agents und die MCP-Werkzeugaufrufe stehen in einem gemeinsamen Balken Externe Agents, aufgeteilt nach Agent und MCP.
Aufteilung Modell Sitzungen sind nach Agent und Modell geteilt; ist kein Modell bekannt, steht dort (Modell unbekannt). Die MCP-Werkzeugaufrufe heißen agorum-Werkzeuge über MCP.
Kostenansichten Sitzungen externer Agents sind nicht enthalten, denn ihre Modellkosten fallen beim Anbieter des Agents an. Ein Hinweis nennt, wie viele Durchgänge das sind (Durchgänge externer Agents ohne Modellkosten). Die Kosten der MCP-Werkzeugaufrufe sind enthalten.
Durchgänge und Aktive Zeit Sitzungen zählen mit. Die Einträge der MCP-Werkzeugaufrufe zählen nicht als Durchgang.