Sammeln von Diagnosedaten für Leistungsprobleme

1. Angaben zum Mieter und zur Umgebung

Beginnen Sie mit dem Austausch grundlegender Umweltinformationen. Sie hilft dem IBM Support, Ihren Einsatz und Ihre Region zu identifizieren, was für die Lokalisierung von infrastrukturbezogenen Problemen entscheidend ist.

Teilen Sie die folgenden Details mit:

• Mieter-ID oder CRN: Geben Sie die CRN Ihres Mieters an. Sie finden es, indem Sie auf Ihr Profil > Über mich klicken. Fügen Sie einen Screenshot der Info-Seite bei.

• Plattform: Geben Sie an, ob Ihre Umgebung auf AWS oder IBM Cloud läuft.

• Region: Sie finden sie, indem Sie auf Ihr Profil > Region klicken.

Die Angaben zum Mieter und zur Region ermöglichen es dem IBM Support, plattform- oder regionsspezifische Leistungsfaktoren zu prüfen.

2. Details zum AI-Modell

Geben Sie den Namen des KI-Modells an, das in dem betroffenen Agenten verwendet wird. Dies ist von entscheidender Bedeutung, da die verschiedenen Modelle einzigartige Architekturen, Fähigkeiten und bekannte Einschränkungen aufweisen.

Befolgen Sie diese Schritte, um die Details des KI-Modells zu finden:

1. Gehen Sie im Hauptmenü auf Erstellen.

2. Gehen Sie zu Alle Agenten und wählen Sie den betroffenen Agenten aus.

3. Kopieren Sie auf der Seite „Agentenkonfiguration“ die Details zum KI-Modell aus der Liste „KI-Modelle“ und speichern Sie sie.

Beispiel:

llama-3-2-90b-vision-instruct

Die genaue Kenntnis des Modells hilft dem IBM Support, modellspezifische Leistungsprobleme zu diagnostizieren und gezielt zu beheben.

3. Konfiguration des Agentenprofils

Die Agentenkonfiguration legt fest, wie der Agent Anfragen interpretiert und antwortet. Falsche Einstellungen können zu unerwartetem Verhalten oder Latenzzeiten führen.

Nachfolgend sind die Schritte zur Ermittlung der Einzelheiten aufgeführt:

1. Gehen Sie im Hauptmenü auf Erstellen.

2. Gehen Sie zu Alle Agenten und wählen Sie den betroffenen Agenten aus.

3. Gehen Sie auf der Agentenkonfigurationsseite auf Wissen.

4. Bestätigen Sie den Agentenstil (Standard oder ReAct ).

5. Überprüfen Sie, ob die Sprachmodalität aktiviert ist, und identifizieren Sie die verwendeten STT- und TTS-Modelle.

4. Details der Wissenskonfiguration

Wissensquellen beeinflussen, wie Agenten Daten abrufen und verarbeiten. Nachfolgend sind die Schritte aufgeführt, mit denen Sie die Details der Wissenskonfiguration finden:

1. Gehen Sie im Hauptmenü auf Erstellen.

2. Gehen Sie zu Alle Agenten und wählen Sie den betroffenen Agenten aus.

3. Gehen Sie auf der Agentenkonfigurationsseite auf Wissen.

4. Beachten Sie die folgenden Angaben unter Wissensquelle.

   • Wissensquellen: Milvus, Elasticsearch, Kundenservice, Astra DB.

   • Datei-Uploads (falls zutreffend):

     • Dokumenttypen:.docx,.pdf,.pptx,.xlsx,.csv,.html,.txt.

     • Größe des Dokuments.

5. Tools und Mitarbeiteragenten

Werkzeuge und Mitarbeiter-Agenten spielen eine wichtige Rolle für die Leistung Ihres Agenten. Jedes Tool fügt Verarbeitungsschritte hinzu, und die Integration kann zu Verzögerungen oder Fehlern führen. Die Angabe dieser Details hilft IBM Support, die Komplexität Ihres Agenten zu verstehen und mögliche Engpässe zu erkennen.

Nachfolgend sind die Schritte aufgeführt, mit denen Sie die Details zu den Tools und Kollaborationsagenten finden:

1. Gehen Sie im Hauptmenü auf Erstellen.

2. Gehen Sie zu Alle Agenten und wählen Sie den betroffenen Agenten aus.

3. Gehen Sie auf der Agentenkonfigurationsseite zu Toolset.

4. Beachten Sie die Angaben unter Werkzeuge. Die Anzahl der verwendeten Tools und die Art der verwendeten Tools ( OpenAPI,Python, MCP Server, Flow, Langflow).

5. Beachten Sie die Angaben zu den Agenten, wie z. B. Katalogagenten, externe Agenten, den „ watsonx Orchestrate “-Assistenten oder den externen {{ site.data.keyword. Gespräch kurz}}.

6. Kanäle und benutzerdefinierte Konfigurationen

Listen Sie alle Kanäle und benutzerdefinierten Konfigurationen auf, wie z. B.: Embedded Agent, Microsoft Teams, Facebook Messenger und so weiter. Nachfolgend finden Sie die Schritte zum Auffinden der Senderdetails:

1. Gehen Sie im Hauptmenü auf Erstellen.

2. Gehen Sie zu Alle Agenten und wählen Sie den betroffenen Agenten aus.

3. Gehen Sie auf der Agentenkonfigurationsseite zu Channels.

4. Beachten Sie die aktivierten Kanäle.

7. Jüngste Änderungen und Ereignisse dokumentieren

Leistungsprobleme folgen oft auf Änderungen. Überprüfen und notieren Sie die folgenden Angaben:

• Jüngste Änderungen an Agenten (Tools, Konfigurationen)

• Umweltfaktoren zum Zeitpunkt des Auftretens des Problems

8. Sammeln und Exportieren von Trace-Daten

Traces sind entscheidend für die Diagnose von Leistungsproblemen. Im Folgenden werden die Schritte zur Erfassung der Trace-Daten beschrieben:

1. Gehen Sie im Hauptmenü zu „Analysieren“ und wählen Sie den Agenten aus.

2. Klicken Sie in der Tabelle „_Traces_“ auf den Status einer Nachricht, um die vollständigen Trace-Details anzuzeigen.

3. Klicken Sie auf „Neues Fenster“, um die Ablaufverfolgung in der Benutzeroberfläche von „ Jaeger “ zu öffnen.

4. Wählen Sie in „ Jaeger “ die Option „Trace Timeline“ > „Trace JSON“, um die Ablaufverfolgung im JSON-Format anzuzeigen.

5. Zum Speichern der Aufzeichnung:

   • Klicken Sie mit der rechten Maustaste und wählen Sie „Speichern unter…“

   • Benennen Sie die Datei und speichern Sie sie als Referenz.

Weitere Informationen finden Sie auf der Seite „Analysen des Überwachungsagenten “.

9. Optional: Angaben zum Exportagenten

Durch den Export von Agentendetails erhält der IBM Support eine vollständige Momentaufnahme der Konfiguration und Einrichtung Ihres Agenten.

Sie können Ihre Agentenkonfiguration mithilfe des „ watsonx Orchestrate “ Agent Development Kit exportieren.

Führen Sie den folgenden Befehl aus, um die Agentendetails zu exportieren:

orchestrate agents export -n <agent_name> -k native -o <agent_name>.zip