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

# Sessions

> Beginne mit der vollständigen Aufzeichnung eines Agenten-Durchlaufs.

Eine Session ist der beste Ausgangspunkt, wenn sich ein Agent unerwartet verhält. Sie vereint Modellanfragen, Antworten, Tool-Aufrufe, Interaktionen mit Menschen, Fehler, Auswertungen und Richtlinienentscheidungen, die zu einem Durchlauf gehören.

<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
  <iframe src="https://www.youtube.com/embed/VWxukZc5k7s?rel=0&playsinline=1" title="Agent tracing with Failproof AI" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} />
</div>

Verfolge einen Agenten-Durchlauf von seinem Ziel über Modellaufrufe und Tools bis hin zur abschließenden Antwort.

## Eine Session finden

<Tabs>
  <Tab title="Dashboard">
    1. Gehe in der Cloud-Seitenleiste zu **Observe → Sessions**.
    2. Lege das Zeitfenster fest und filtere nach Umgebung, Status, Agent oder Session-ID.
    3. Füge Score- oder Metrikbereiche hinzu, wenn du nach Qualität, Kosten, Token oder Latenz filtern möchtest.
    4. Wähle eine Zeile aus, um den zugehörigen Trace zu öffnen. Nutze das Kopiersymbol neben der Session-ID, wenn du sie teilen möchtest.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/sessions-list.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=f1fb545746143e87b8b5daedabfc5559" alt="Die Sessions-Liste mit je einer Zeile pro Durchlauf sowie Filtern für Umgebung, Agent, Status und Auswertungsscore." width="3200" height="2000" data-path="images/dashboard/sessions-list.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp sessions --env production --since 24h
    fp sessions --status error,timeout --agent-id checkout-agent
    fp --json sessions --session-id <session-id>
    ```

    Füge `--agents` hinzu, um Multi-Agenten-Durchläufe aufzuklappen, `--all` für die Paginierung oder `--fields`, um Ausgabespalten auszuwählen.
  </Tab>
</Tabs>

## Was du tun kannst

* Einen Durchlauf nach Agent, Umgebung, Zeitraum, Modell, Ereignistyp oder Fehlerzustand finden.
* Die genaue Abfolge nachvollziehen, die zu einem Ergebnis geführt hat.
* Erfolgreiche und fehlgeschlagene Durchläufe vergleichen.
* Die Belege einsehen, die einem Audit-Befund oder einem Alert-Vorfall zugrunde liegen.
* Eine Session exportieren, wenn du eine Offline-Aufzeichnung benötigst.

## Eine bewährte Reihenfolge für die Fehleranalyse

1. Ziel und Umgebung der Session bestätigen.
2. Den ersten Fehler oder die erste unerwartete Entscheidung finden – nicht nur den abschließenden Fehler.
3. Den Modellkontext und die Tool-Eingabe unmittelbar davor prüfen.
4. Wiederholungsversuche, Latenz und menschliche Unterbrechungen überprüfen.
5. Auswertungsscores und Richtlinienentscheidungen durchsehen.

<Card title="Einen Trace lesen" icon="route" href="/de/sessions/read-a-trace">
  Erfahre, wie du vom Session-Überblick zu dem Ereignis navigierst, das das Ergebnis verursacht hat.
</Card>