Überwachungsagenten
Veraltet: Die Modelle „ LLMaaJ “ (Llama 90B und Llama 405B ) werden am 30. März 2026 auslaufen. Nach diesem Datum wird standardmäßig auf das GPT-OSS-Modell umgestellt. Werden die Modellkonfigurationen nicht vor dem Auslaufdatum aktualisiert oder angepasst, führt dies zu Betriebsstörungen und Funktionsausfällen
Nutzen Sie die Agentenanalyse in „ watsonx Orchestrate “, um in Echtzeit zu erfahren, wie Ihre KI-Agenten abschneiden. Wenn Sie Ihre Agenten überwachen, können Sie Probleme schnell erkennen, das Nachrichtenverhalten analysieren und feststellen, ob die jüngsten Änderungen die Leistung verbessert oder beeinträchtigt haben.
Über das Menü „Analysieren“ können Sie:
Verfolgen Sie, wie viele Nachrichten Ihre Agenten bearbeiten und wie oft sie dabei Fehler machen.
Überwachen Sie die Reaktionslatenz, um Verlangsamungen frühzeitig zu erkennen.
Vergleichen Sie die Agenten, um herauszufinden, welche Aufmerksamkeit benötigen.
Öffnen Sie detaillierte Traces, um genau zu sehen, wie ein Agent eine Nachricht Schritt für Schritt bearbeitet hat.
Diese Erkenntnisse helfen Ihnen, Probleme schneller zu beheben, Ihre Konfigurationen zu validieren und das Verhalten Ihres Agenten kontinuierlich zu optimieren.
Die Analyse von Überwachungsagenten wird derzeit in der lokalen Bereitstellung nicht unterstützt.
Entwickler und Administratoren können unter IBM watsonx Orchestrate Metriken und Traces sowohl für Entwürfe als auch für Live-Agenten einsehen.
Wenn die vollständige Schwärzung aktiviert ist, wirkt sich dies auf die Live-Überwachungsmetriken aus, insbesondere auf diejenigen, die sich auf die Antwortqualität und die Tool-Qualität beziehen.
Vorbereitende Schritte
Bevor Sie mit der Überwachung Ihrer Agenten beginnen, stellen Sie sicher, dass Sie über Builder- oder Admin -Rechte verfügen und dass Sie das Menü „Analyze“ unter „ watsonx Orchestrate “ öffnen können. Über dieses Menü können Sie auf die Seite „Agentenanalyse“ zugreifen.
Wenn Sie einen Live-Agenten überwachen, stellen Sie sicher, dass die Überwachung für diesen Agenten aktiviert ist. Die Überwachung muss aktiviert sein, bevor Sie Metriken, Fehlerzahlen, Latenzzeiten oder Details auf Trace-Ebene sehen können. Wenn diese Option deaktiviert ist, werden auf der Analyseseite keine Aktivitäten für diesen Agenten angezeigt.
Zugriff auf die Agentenanalyse
Um auf die Agent-Analysen zuzugreifen, öffnen Sie das Hauptmenü und klicken Sie auf „Analysieren “. Sie gelangen zur Analyseseite, auf der Sie die Nachrichtenaktivität überwachen, Fehler und Latenzen verfolgen, Agenten vergleichen und detaillierte Traces einsehen können, um Fehler zu beheben oder das Verhalten eines Agenten zu überprüfen.
In den folgenden Abschnitten werden die einzelnen Bereiche der Analyseseite erläutert und Sie erhalten Hilfe bei der Interpretation der angezeigten Leistungsdaten.
Dashboard-Übersicht
Wenn Sie die Agentenanalyse öffnen, erhalten Sie auf dem Dashboard einen schnellen Überblick über die Leistung Ihrer Agenten. Verwenden Sie diese Ansicht, um die Gesamtaktivität zu verstehen, ungewöhnliche Muster zu erkennen und zu entscheiden, welche Agenten einer genaueren Untersuchung bedürfen.
Details zu |
Beschreibung |
|---|---|
Gesamtzahl der Nachrichten |
Sehen Sie, wie viele Nachrichten Ihre Agenten im ausgewählten Zeitraum bearbeitet haben, einschließlich erfolgreicher und fehlgeschlagener Antworten. |
Fehlgeschlagene Nachrichten |
Überprüfen Sie, wie viele Nachrichten zu Fehlern geführt haben (z. B. Zeitüberschreitungen oder erfolglose Antworten). Ein plötzlicher Anstieg der Fehleranzahl deutet in der Regel auf Fehlkonfigurationen, unterbrochene Werkzeugverbindungen oder unerwartetes Modellverhalten hin. |
Durchschnittliche Latenzzeit |
Überprüfen Sie, wie lange Ihre Mitarbeiter im Durchschnitt für eine Antwort benötigen. Eine höhere Latenz kann auf langsame Modellaufrufe, ineffiziente Werkzeugoperationen oder Engpässe im Arbeitsablauf hinweisen. |
Überwachen |
Zeigt an, ob die Überwachung für den ausgewählten Agenten aktiviert ist. Sie können die Überwachung für Live-Agenten ein- oder ausschalten. Weitere Informationen finden Sie unter Überwachen eines Agenten. |
Die Metriken werden automatisch aktualisiert, während Ihre Agenten ausgeführt werden. Wenn ein Wert ungewöhnlich erscheint, z. B. ein starker Anstieg der Ausfallrate oder ein Sprung in der Latenz, können Sie sofort einen Drilldown zu einzelnen Agent-Datensätzen durchführen oder Traces auf Nachrichtenebene öffnen, um zu verstehen, was passiert ist. Das Dashboard spiegelt Daten von Agenten wider, die Nachrichten sowohl in Entwurfs- als auch in Live-Umgebungen verarbeitet haben.
Die Analysedaten der Agenten bleiben 30 Tage lang verfügbar.
Agentenkennzahlen anzeigen
Verwenden Sie die Agent-Analysetabelle, um die Leistung jedes Agenten auf einen Blick zu überprüfen. Es hilft Ihnen zu verstehen, wie aktiv ein Agent genutzt wird, wie oft Fehler auftreten und wie schnell er reagiert.
Die Tabelle zeigt:
Details zu |
Beschreibung |
|---|---|
Name |
Der Name des Agenten. |
Beschreibung |
Eine kurze Beschreibung des Zwecks des Agenten. |
Nachrichten |
Die Gesamtzahl der verarbeiteten Nachrichten. |
Fehlgeschlagene Nachrichten |
Die Anzahl der Meldungen, die zu Fehlern geführt haben. |
Durchschnittliche Latenzzeit |
Die durchschnittliche Bearbeitungszeit von Nachrichten. |
Anhand dieser Informationen können Sie das Nachrichtenaufkommen der einzelnen Agenten vergleichen, Agenten mit höheren Ausfallraten oder langsameren Reaktionszeiten identifizieren und überprüfen, ob die jüngsten Änderungen die Leistung verbessert oder neue Probleme verursacht haben.
Agentenprotokolle anzeigen
Sie können das Verhalten des Agenten eingehend untersuchen, indem Sie seine Traces auf Nachrichtenebene öffnen. Klicken Sie zunächst auf den Namen des Agenten in der Tabelle „Agentenanalyse“. Dadurch wird die Ansicht „Traces“ geöffnet, in der Sie Schritt für Schritt überprüfen können, wie der Agent jede Nachricht verarbeitet hat.

Jede Zeile in der Trace-Tabelle zeigt:
Details zu |
Beschreibung |
|---|---|
Zeitmarke |
Der Zeitpunkt, zu dem die Nachricht verarbeitet wurde. |
Trace-ID |
Eine eindeutige Kennung für die Nachricht. |
Status |
Ob die Antwort „Erfolgreich“ oder „Fehler“ lautete. |
Model |
Das große Sprachmodell, das zur Generierung der Antwort verwendet wird. |
Latenzzeit |
Die Gesamtzeit, die der Agent für die Verarbeitung der Nachricht benötigt hat. |
Verwenden Sie die Trace-Ansicht, um Muster zu erkennen, Fehler zu untersuchen oder zu überprüfen, ob ein Agent wie erwartet reagiert hat. Traces helfen Ihnen dabei, problematische Nachrichten zu identifizieren, die Latenz zwischen Modellen oder Prompts zu vergleichen und zu überprüfen, ob sich Ihr Agent nach Updates konsistent verhält.
Für eine detailliertere Aufschlüsselung der Verarbeitung einer Nachricht durch den Agenten, einschließlich Modellentscheidungen, Tool-Ausführungen, Wissensabruf und Workflow-Aktionen, können Sie die Ansicht „Trace-Details“ öffnen. Die Seite „Trace-Details verstehen“ bietet eine strukturierte, schrittweise Ansicht jedes Abschnitts im Ausführungspfad und hilft Ihnen dabei, komplexe Probleme effektiver zu diagnostizieren.
Gemäß den Richtlinien zur Datenspeicherung werden Protokolldaten unter Elasticsearch 30 Tage lang gespeichert und danach automatisch gelöscht.
Agenten mit Arbeitsbereichen auf IBM Cloud organisieren
- Sie können nun Arbeitsbereiche erstellen, um Ihre Agenten zu organisieren und auf IBM Cloud zusammenzuarbeiten.
- Arbeitsbereiche bieten Ihrem Team einen privaten Raum, in dem Sie gemeinsam Agenten entwickeln, testen und verwalten können, während laufende Arbeiten nur für die von Ihnen ausgewählten Personen sichtbar bleiben.
- Sie können Mitgliedern als Eigentümer oder Bearbeiter rollenbasierte Berechtigungen zuweisen, Agenten unter Beibehaltung der Abhängigkeiten zwischen Arbeitsbereichen verschieben, festlegen, wer bestimmte Agenten anzeigen oder bearbeiten darf, und Ihre Arbeit nach Projekt, Team oder Geschäftsbereich strukturieren.
- Die Arbeitsbereiche umfassen zudem spezifische Analysen für den jeweiligen Arbeitsbereich, die Ihnen gezielte Einblicke in die Aktivitäten und die Leistung der Mitarbeiter in diesem Bereich bieten.
- Weitere Informationen zum Erstellen und Verwalten von Arbeitsbereichen finden Sie unter „Übersicht über Arbeitsbereiche “.
Überwachung der eingesetzten Agenten auf watsonx.governance
Mit der Überwachung können Sie die Leistung und den Zustand Ihres Agenten in Echtzeit verfolgen. Wenn Sie die Überwachung aktivieren, sendet IBM watsonx Orchestrate Nachrichtenaktivitäts- und Auswertungssignale an IBM watsonx.governance. Diese Integration sorgt für mehr Transparenz und Sicherheit, indem sie Antworten bewertet, Probleme kennzeichnet und Ihnen dabei hilft, die Compliance bei Interaktionen zu wahren.
Die Überwachung wird in den folgenden Regionen von „ IBM Cloud “ unterstützt:
Dallas (
us-south), Texas, USAFrankfurt (
eu-de), DeutschlandLondon (
eu-gb), EnglandTokio (
jp-tok), JapanSydney (
au-syd), AustralienToronto (
ca-tor), Kanada
Diese Funktion wird in lokalen und „ AWS “-Bereitstellungen nicht unterstützt.
Auf watsonx.governance können nur Live-Agenten überwacht werden. Eine detaillierte Überwachung der bereitgestellten Agenten ist nur für „ IBM Cloud “-Bereitstellungen verfügbar.
Für Mieter, bei denen Langfuse aktiviert ist, ist die Überwachungsfunktion nicht verfügbar.
Wichtigste Ziele und Vorteile der Überwachung
Mit der Agentenanalyse können Sie wichtige Kennzahlen wie die Gesamtzahl der Nachrichten, fehlgeschlagene Nachrichten, die durchschnittliche Latenz und Trace-Details anzeigen. Die Überwachung erweitert diese Funktion, indem sie Live-Nachrichten verfolgt, die zwischen IBM, watsonx Orchestrate und watsonx.governance ausgetauscht werden. Zusammen helfen Ihnen diese Erkenntnisse dabei:
Überwachen Sie die Leistung von Agenten und Nutzungstrends
Fehler und Anomalien frühzeitig erkennen
Geschwindigkeit verbessern und Latenz reduzieren
Verbesserung der Beobachtbarkeit und Fehlerbehebung
Bereitstellung einer datengestützten Grundlage für die Abstimmung und Weiterentwicklung von Agenten
Voraussetzungen für die Überwachung von „ watsonx.governance “
Bevor Sie die Überwachung aktivieren, stellen Sie sicher, dass alle Anforderungen erfüllt sind:
Der Agent muss bereitgestellt und aktiv sein. Auf dem Dashboard von „ watsonx Orchestrate “ werden nur bereitgestellte Agenten angezeigt.
Sie benötigen „Builder“- oder „Admin“-Berechtigungen in watsonx Orchestrate.
Sie benötigen eine aktive „ watsonx.governance “-Instanz in derselben „ IBM Cloud “-Region wie Ihre „ IBM “-Instanz unter watsonx Orchestrate.
Wenn Sie noch keine haben, erstellen Sie eine Instanz. Siehe „ IBM Cloud -Konto einrichten “.
Stellen Sie sicher, dass Ihre Instanz in einer unterstützten Region bereitgestellt wird.
Administratoren und Entwickler müssen eine Zugriffsgruppe mit folgenden Angaben konfigurieren:
WritersowieEditordie Berechtigungen für watsonx OrchestrateReadersowieEditordie Berechtigungen für watsonx.governance. Siehe „Zugriffsgruppen einrichten “.
Benutzer von watsonx.governance müssen über eine konfigurierte Datenbank verfügen:
Lite-Tarife enthalten standardmäßig eine Datenbank.
Für Essential-Pläne ist eine vom Benutzer bereitgestellte Datenbank erforderlich. Siehe „ watsonx.governance einrichten“ unter IBM Cloud.
Agentenüberwachung aktivieren
Wenn Sie die Überwachung aktivieren, beginnt das System mit der Verfolgung und Erfassung von Analysedaten zusätzlich zu den Agent-Traces, was Einblicke in die Leistung liefert und bei der Optimierung hilft. Sie können es entweder auf der Seite „Agent-Analysen“ oder auf der Seite „Agenten und Tools erstellen“ aktivieren.
Aktivieren Sie die Überwachung auf der Agent-Analyseseite
Öffnen Sie die Seite „Agentenanalyse“.
Suchen Sie den Agenten, den Sie überwachen möchten.
Aktivieren Sie in der Spalte „Monitor“ die Überwachung.
Sie können die Überwachung später deaktivieren, um beispielsweise die Datenerfassung anzuhalten oder die Ressourcennutzung zu reduzieren. Kehren Sie dazu zur gleichen Monitor -Spalte zurück und deaktivieren Sie die Option.

Aktivieren Sie die Überwachung auf der Seite „Build-Agenten und -Tools“
Gehen Sie zur Konfigurationsseite des Agenten.
Klicken Sie auf das Überlaufmenü neben „Bereitstellen “.
Wählen Sie „Überwachung aktivieren “.
Um die Überwachung auf dieser Seite zu deaktivieren, öffnen Sie erneut das Überlaufmenü und wählen Sie „Überwachung deaktivieren “.
Wichtige Überlegungen
Nachdem Sie die Überwachungsfunktion aktiviert haben, kann es einige Minuten dauern, bis das Dashboard verfügbar ist.
Das System fragt die Überwachungsaktivierung automatisch alle 30 Sekunden für bis zu 5 Minuten ab.
Die Abfrage wird automatisch beendet, wenn die Aktivierung erfolgreich ist, fehlschlägt, eine Zeitüberschreitung auftritt oder wenn Sie die Seite verlassen.
Überprüfen Sie, ob der Überwachungs-Schalter auf „Ein“ steht, was die Aktivierung bestätigt.
Wenn der Schalter ausgeschaltet ist, ist die API-Aktivierung fehlgeschlagen. Versuchen Sie es erneut oder erstellen Sie ein Support-Ticket.
Wenn Ihre Instanz von „ watsonx.governance “ gelöscht wird, wird das Dashboard nicht mehr geladen. Erstellen Sie eine neue Instanz und aktivieren Sie die Überwachung erneut.
Überwachungsergebnisse anzeigen
Das Dashboard bietet einen zentralen Überblick über die Leistungs- und Bewertungskennzahlen Ihrer Agenten. Das Dashboard-Symbol ist nur sichtbar, wenn die Überwachung für Ihren Agenten aktiviert ist. Das Dashboard bietet:
Nutzungsmetriken (Anzahl der Nutzer und Anzahl der Nachrichten)
Leistungskennzahlen (Token-Anzahl, Latenz und fehlgeschlagene Nachrichten)
Technische Kennzahlen (Genauigkeit, Relevanz der Tool-Aufrufe und andere)
Protokolle auf Konversations- und Nachrichtenebene
Klicken Sie auf das Dashboard-Symbol
, um die Überwachungsdetails anzuzeigen.
Es kann einige Minuten dauern, bis die Metriken zu neu eingehenden Traces im Überwachungs-Dashboard von „ watsonx.governance “ angezeigt werden.
Weitere Informationen finden Sie unter „Bewertung von KI-Agenten und agentenbasierten Anwendungen “.
Nächste Schritte
Um weiter zu erkunden, wie das Verhalten von Agenten analysiert werden kann, fahren Sie mit „Trace-Details verstehen“ fort. Der nächste Abschnitt bietet einen strukturierten Überblick darüber, wie Sie auf Ausführungsspuren zugreifen und diese überprüfen können. So können Sie die Schritte analysieren, die ein Agent für jede verarbeitete Nachricht ausgeführt hat, und feststellen, wo möglicherweise Probleme aufgetreten sind.
Bekannte Probleme
Bekannte Probleme im Zusammenhang mit Überwachung und Analyse finden Sie unter Bekannte Probleme bei Überwachung und Analyse.