Agent instrumentieren - Failproof AI

Dein Agent erzeugt bereits alles, was es wert ist, aufgezeichnet zu werden — Modellaufrufe, Tool-Aufrufe, Node-Grenzen, menschliche Wartezeiten, Fehler. Das Framework wirft es weg. Das SDK behält es.

Eigene Agenten

Ein selbst geschriebener Agent oder einer, der hier nicht aufgelistet ist.

LangChain und LangGraph

Graphs, Nodes, Tools, Retriever, Modelle.

CrewAI

Crews, Flows, Agenten nach Rolle, Tools.

LlamaIndex

Workflows, Steps, Funktionsagenten, Retriever.

Pydantic AI

Typisierte Agenten, Fähigkeiten, Tools, Wiederholungsversuche.

Drei Zeilen, egal welches Framework

pip install 'failproofai-sdk[langgraph]'

pip install 'failproofai-sdk[crewai]'

pip install 'failproofai-sdk[llamaindex]'

pip install 'failproofai-sdk[pydantic-ai]'

pip install failproofai-sdk

import failproofai_sdk

failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument()          # erkennt die importierten Frameworks automatisch

with failproofai_sdk.session():
    ...                               # dein bestehender Agent-Aufruf, unverändert

Keine Dekoratoren auf deinen Funktionen, kein Callback-Parameter, keine IDs, die durch deinen Code gefädelt werden. Nur der Aufruf innerhalb der Session unterscheidet sich:

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

graph.invoke({"messages": [HumanMessage("...")]})

Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()

await agent.run("...")        # unter `async with failproofai_sdk.session():`

agent.run_sync("...")

with failproofai_sdk.agent("planner"):
    with failproofai_sdk.tool_call("search", input={"q": q}) as t:
        t.output = search(q)

Das Extra-Paket installiert das Framework. Jeder Adapter ist im Basis-Wheel enthalten, sodass ein Projekt, das sein Framework bereits hat, kein zusätzliches Paket benötigt.

Prüfen, ob Daten angekommen sind

Führe eine instrumentierte Session aus und öffne dann Observe → Sessions, um deine Umgebung auszuwählen. Der Lauf erscheint als rekonstruierter Trace. Wenn nichts ankommt, prüfe die Verbindung des Rechners mit failproofai config --status. Siehe Capture einrichten.

Prüfe nicht das Spool-Verzeichnis, um die Zustellung zu bestätigen. Der Failproof-Daemon erfasst und löscht jeden Batch innerhalb von Millisekunden — beim Lesen konkurrierst du daher mit dem Collector und siehst weit weniger Events, als tatsächlich gesendet wurden.

Nächste Schritte

Jeder oben verlinkte Quickstart führt zum vollständigen Guide — was aufgezeichnet wird, Optionen, Streaming, Span-Benennung und typische Probleme, auf die man stößt. Diese Guides befinden sich unter Trace Agents → Plug in your agent.

So funktioniert es

Das Datenmodell, die IDs, die Event-Typen und wie Events die Cloud erreichen.

Einen Trace lesen

Kausalität durch eine Session verfolgen statt durch unzusammenhängende Logs.

Ersten Fehler finden

Die gerade erfassten Sessions auditieren.

Eigene Agenten

LangChain und LangGraph

CrewAI

LlamaIndex

Pydantic AI

​Drei Zeilen, egal welches Framework

​Prüfen, ob Daten angekommen sind

​Nächste Schritte

So funktioniert es

Einen Trace lesen

Ersten Fehler finden

Drei Zeilen, egal welches Framework

Prüfen, ob Daten angekommen sind

Nächste Schritte