> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.go-lizard.com/llms.txt
> Use this file to discover all available pages before exploring further.
# KI-Agenten-Protokoll
> Nachsehen, was deine KI-Agenten in Lizard abgerufen und geändert haben, und das Protokoll als Nachweis exportieren.
# KI-Agenten-Protokoll
Lizard hält die Aufrufe deiner KI-Agenten im **KI-Agenten-Protokoll** fest. So siehst du nach, was ein Agent abgerufen oder geändert hat.
Du öffnest das Protokoll über dein Profilbild oben rechts → **KI-Agenten-Protokoll**. Der Eintrag erscheint, sobald deine Lizenz KI-Agenten enthält.
Das Protokoll hängt nicht an einem verbundenen Agenten. Auch nach **Zugriff widerrufen** bleiben alle Einträge dieses Agenten sichtbar und im Filter auswählbar.
## Wer welche Einträge sieht
| Rolle | Sichtbare Einträge |
| :------------------- | :----------------------------------------------------------------------- |
| **Administrator:in** | Alle Einträge der Firma, also die Agenten aller Kolleginnen und Kollegen |
| Alle anderen Rollen | Nur die Einträge der eigenen Agenten |
## Kennzahlen
Oben auf der Seite stehen vier Kacheln: **Heute**, **Gestern**, **Letzte 7 Tage** und **Letzte 30 Tage**. Jede zeigt:
* **gelieferte Datensätze** als große Zahl, also wie viele Betriebsmittel, Prüfergebnisse und andere Einträge die Agenten erhalten haben,
* **Aufrufe**,
* **Mit Ansprechpartner-Kontaktdaten**: Aufrufe, deren Antwort Kontaktdaten von Ansprechpartnern enthielt,
* **Abgewiesen**: Aufrufe mit dem Ergebnis *Abgewiesen*, siehe unten.
Die Kacheln zählen immer alle für dich sichtbaren Einträge, unabhängig von den Filtern der Tabelle.
## Die Tabelle
| Spalte | Bedeutung |
| :------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zeitpunkt** | Zeitpunkt des Aufrufs, sekundengenau. |
| **Agent** | Name des Agenten, wie auf der Seite KI-Agent verbinden. |
| **Im Namen von** | Der Benutzer, mit dessen Zugang der Agent verbunden ist. |
| **Werkzeug** | Was der Agent aufgerufen hat, siehe [Werkzeugnamen](#werkzeugnamen). |
| **Ergebnis** | *Beantwortet*, *Fehlgeschlagen* oder *Abgewiesen*, siehe [Was die Ergebnisse bedeuten](#was-die-ergebnisse-bedeuten). |
| **Datensätze** | Wie viele Datensätze die Antwort enthielt. |
| **Geschrieben** | Ob der Agent ein schreibendes Werkzeug aufgerufen hat. Das Häkchen steht auch dann, wenn Lizard die Änderung abgelehnt oder zunächst nur eine Vorschau geliefert hat. Was tatsächlich passiert ist, zeigt **Daten anzeigen**. |
| **Kontaktdaten erlaubt** | Ob der Agent zu diesem Zeitpunkt Kontaktdaten lesen durfte. |
| **Kontaktdaten von Ansprechpartnern** | Wie oft Kontaktdaten in der Antwort vorkamen. Gezählt wird je Ausgabe, nicht je Person: Derselbe Kontakt zählt jedes Mal mit, wenn er in einer Antwort erscheint. |
| **Herzschläge** | Standardmäßig ausgeblendet. Wie oft eine Sitzung an einem Tag ein Lebenszeichen gesendet hat. Eine Zeile steht für die ganze Reihe. |
### Was die Ergebnisse bedeuten
| Ergebnis | Bedeutung |
| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Beantwortet** | Lizard hat den Aufruf bearbeitet und geantwortet. Das gilt auch, wenn das Werkzeug den Vorgang abgelehnt hat, etwa wegen fehlender Rollenrechte, eines archivierten Betriebsmittels oder weil erst eine Bestätigung nötig ist. Den Inhalt der Antwort zeigt **Daten anzeigen**. |
| **Fehlgeschlagen** | Der Aufruf war so nicht ausführbar, zum Beispiel weil der Agent ein Werkzeug aufgerufen hat, das ihm nicht zur Verfügung steht. |
| **Abgewiesen** | Lizard hat den Aufruf gar nicht erst bearbeitet, zum Beispiel weil die Lizenz keine KI-Agenten mehr enthält, der Zugang eines externen Mitarbeiters abgelaufen ist oder der Agent zu viele Anfragen gestellt hat. Den Grund zeigt **Daten anzeigen**. |
Anfragen ohne gültigen Zugang, etwa mit einem widerrufenen oder abgelaufenen Token, lassen sich keiner Firma zuordnen. Sie erscheinen deshalb in keinem Protokoll.
### Filter
| Filter | Wirkung |
| :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agent** | Einträge eines Agenten, auch eines bereits widerrufenen. |
| **Ergebnis** | Beantwortet, Fehlgeschlagen oder Abgewiesen. |
| **Schreibende Aufrufe** | *Ja* zeigt nur Aufrufe schreibender Werkzeuge, *Nein* nur die übrigen. |
| **Nur Aufrufe mit Daten** | Standardmäßig auf *Ja*: nur Einträge mit gespeicherter Anfrage und Antwort. *Nein* zeigt **nur** die Einträge ohne gespeicherte Daten, *-* zeigt alle. |
| **Zeitraum** | Einträge in einem Datumsbereich. |
**Mit der Standardeinstellung fehlen Einträge in der Tabelle.** Abgewiesene Aufrufe tragen keine gespeicherten Daten, ebenso Aufrufe, deren Antwort Lizard nicht speichern konnte, weil sie zu groß war oder der Agent sein Tageskontingent aufgebraucht hatte. Außerdem fehlen Verbindungsaufbau, Herzschläge und Werkzeuglisten. Alle Einträge siehst du, wenn du **Nur Aufrufe mit Daten** auf *-* stellst.
### Daten eines Aufrufs ansehen
Mit **Daten anzeigen** öffnest du einen Eintrag. Du siehst die **Anfrage** des Agenten und die **Antwort** von Lizard.
* Bei abgewiesenen Aufrufen steht dort stattdessen der **Grund**.
* War die Antwort zu groß oder das Tageskontingent des Agenten aufgebraucht, hat Lizard nur die Eckdaten des Aufrufs aufbewahrt. Der Hinweis nennt dazu eine Größe in Bytes, die Anfrage und Antwort zusammen umfasst.
* Gehörte der Aufruf zum Verbindungsaufbau, trägt er keine Daten.
### Werkzeugnamen
Die Spalte **Werkzeug** zeigt den technischen Namen dessen, was der Agent aufgerufen hat.
| Werkzeug | Bedeutung |
| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------- |
| `list-due-inspections` | Fällige und überfällige Prüfungen auflisten |
| `search-items` | Betriebsmittel suchen |
| `get-item` | Details eines Betriebsmittels abrufen |
| `get-inspection-history` | Prüfhistorie eines Betriebsmittels abrufen |
| `describe-item-fields` | Nachschlagen, welche Angaben zum Anlegen nötig sind |
| `read-resource` | Eine der Übersichten unten abrufen, wenn der Agent sie nicht direkt lesen kann, zum Beispiel in Claude Chat oder Cowork |
| `lizard://me` | Nachschlagen, mit welchem Zugang und welchen Rechten der Agent arbeitet |
| `lizard://glossary` | Begriffe und Statuswerte von Lizard |
| `lizard://locations` | Übersicht der Standorte |
| `lizard://item-categories` | Übersicht der Kategorien |
| `lizard://inspection-categories` | Übersicht der Prüfkategorien mit ihren Normen |
| `lizard://collaborations` | Übersicht der Zusammenarbeiten |
| `lizard://partners` | Übersicht der Partnerunternehmen |
| Werkzeug | Bedeutung |
| :--------------------- | :-------------------------------------------------------------------- |
| `create-item` | Betriebsmittel anlegen |
| `update-item` | Betriebsmittel ändern |
| `link-dyntag` | DynTag mit einem Betriebsmittel verknüpfen |
| `assign-collaboration` | Betriebsmittel einer Zusammenarbeit zuordnen oder die Zuordnung lösen |
| `manage-collaboration` | Zusammenarbeit anlegen oder bearbeiten |
Steht dort ein anderer Name wie `initialize`, `tools/list` oder `ping`, gehört der Eintrag zur Verbindung zwischen Agent und Lizard. Bei abgewiesenen Aufrufen steht dort nur die Art des Aufrufs, zum Beispiel `tools/call`.
## Als JSON exportieren
Mit **Als JSON exportieren** lädst du das Protokoll als Datei herunter, zum Beispiel als Nachweis.
* Der Export enthält **genau die Einträge, die die Tabelle mit den aktuellen Filtern zeigt**, samt Anfrage und Antwort.
* Der Kopf der Datei nennt Firma, Zeitpunkt, wer exportiert hat, die Zahl der exportierten Einträge, die Zahl aller für dich sichtbaren Einträge, die gesetzten Filter und die Aufbewahrungsfrist. So ist auf einen Blick erkennbar, ob die Datei ein Ausschnitt ist.
Für einen vollständigen Export stelle **Nur Aufrufe mit Daten** vorher auf *-*. Mit der Standardeinstellung *Ja* fehlen abgewiesene Aufrufe und solche, deren Antwort nicht gespeichert wurde. Stellst du den Filter auf *Nein*, enthält die Datei **nur** diese.
Lizard protokolliert auch den Export selbst: wer exportiert hat, wie viele Einträge und mit welchen Filtern.
## Aufbewahrung
Einträge bleiben **ein Jahr** erhalten und werden danach automatisch gelöscht.