Erste Schritte mit der Observra-Agenten-Telemetrie
Führung
Eine Schritt-für-Schritt-Anleitung zum Erfassen von Modellaufrufen, Tool-Aktivitäten, Kosten und Fehlern von KI-Agenten, ohne deren Code neu schreiben zu müssen.
Sie können einem bestehenden KI-Agenten Telemetrie hinzufügen, indem Sie einen Framework-Adapter anhängen, der Modellaufrufe, Tool-Aufrufe, Kosten und Fehler erfasst und diese dann in einem normalisierten Ereignisformat an eine lokale Datei, einen Webhook, einen OpenTelemetry-Collector oder ein SIEM weiterleitet.
KI-Agenten rufen Modelle auf, nutzen Tools und treffen selbstständig Entscheidungen. Wenn eine Sitzung plötzlich zehnmal so viel kostet wie üblich, ein Agent dasselbe Tool wiederholt aufruft oder ein Benutzer unerwartetes Verhalten meldet, verfügen die meisten Teams über keine verlässliche Aufzeichnung des Geschehens. Ohne diese Aufzeichnung lassen sich Agentenaktivitäten weder debuggen noch prüfen oder untersuchen.
Diese Kurzanleitung zeigt Ihnen in drei Schritten, wie Sie Observra, ein von Exabeam gesponsertes Open-Source-Python-SDK, installieren und mit dem Google Agent Development Kit (ADK), dem Claude Agent SDK, dem OpenAI Agents SDK, LangChain und LangGraph oder Pydantic AI verbinden. Anschließend überprüfen Sie Ihre ersten Telemetriedaten und legen fest, wohin diese fließen sollen.
Wichtige Fragen, die dieser Leitfaden beantwortet
- Was benötigen Sie, bevor Sie einem bestehenden KI-Agenten Telemetrie hinzufügen?
- Wie verbindet man Observra mit seinem Agenten-Framework, ohne die Agentenlogik zu verändern?
- Was genau beinhaltet ein einzelnes Agenten-Telemetrieereignis, von Token-Zählern bis hin zu Kosten?
- Wie kann eine einheitliche Ereignisstruktur sicherstellen, dass Dashboards, Warnmeldungen und Abfragen für jedes Framework funktionieren?
- Welche Kontrollmechanismen greifen automatisch, einschließlich Kostenverfolgung, Standardschwärzung und Aufforderungssignale?
- Wie leitet man dieselben Telemetriedaten an eine lokale Datei, einen Webhook, einen OpenTelemetry-Collector oder ein SIEM weiter?
Wie Observra in Ihre Sicherheits- und Überwachungsarchitektur passt
Observra erfasst Agentenaktivitäten mithilfe der von den jeweiligen Frameworks bereitgestellten Callbacks und Instrumentierungsfunktionen und konvertiert diese anschließend in ein einheitliches CIM-Ereignisformat (Common Information Model). Jedes Backend empfängt dasselbe Ereignisobjekt. Sie können mit einer lokalen JSON-Lines-Datei beginnen, diese über OpenTelemetry an Plattformen wie Dynatrace, Grafana, Honeycomb oder New Relic exportieren und Ereignisse direkt an Exabeam senden, indem Sie das entsprechende Add-on installieren. Die Zieladressen ändern Sie in der Konfiguration, Ihr Anwendungscode bleibt unverändert.
Laden Sie die Anleitung herunter, um Observra auf Ihrem ersten KI-Agenten zum Laufen zu bringen.
