Nutze die Activity-Trace, um deinen Agenten zu debuggen

Die Aktivitätsverfolgung in Agenten, die vom GitHub Copilot-Harness in Microsoft Copilot Studio betrieben werden, zeigt Ihnen genau, wie Ihr Agent jede Nachricht verarbeitet. Verwenden Sie sie, um die Gedankenkette Ihres Agents nachzuvollziehen, die Wissensquellenzuordnung zu überprüfen, die Toolausführung zu bestätigen und Fehler zu beheben.

Note

Die Funktionen in diesem Artikel werden vom GitHub Copilot-Harness unterstützt, das Copilot Credits für nutzungsbasierte Abrechnung verwendet. Erfahren Sie mehr über Copilot-Credits in Überblick über die Abrechnung von Agenten, die vom GitHub Copilot-Harness betrieben werden.

Nutzungsbasierte Abrechnung gilt für die Nutzung, den Bau, das Testen und die Bewertung von Agenten. Diese Aktionen könnten Copilot-Credits verbrauchen.

Voraussetzungen

  • Ein Agent, der mit dem GitHub Copilot-Harness erstellt wurde
  • Mindestens eine Testunterhaltung in der Registerkarte Vorschau

Öffnen Sie die Aktivitätsüberwachung

  1. Öffnen Sie in Copilot Studio Ihren Agent und wählen Sie die Registerkarte Vorschau aus.

  2. Stellen Sie sicher, dass der Umschalter für Endbenutzer-Vorschauversion ausgeschaltet ist (die Standardansicht für Ersteller). Die Aktivitätsüberprüfung wird neben dem Chat-Bereich angezeigt und zeigt die Verarbeitungsdetails für jede Nachricht an.

  3. Senden Sie Ihrem Agent eine Nachricht. Die Überprüfung wird in Echtzeit aktualisiert, während der Agent die Nachricht verarbeitet.

Grundlegendes zur Ablaufverfolgung

Die Aktivitätsüberwachung zeigt eine Gedankenketten-(CoT)-Ansicht der Verarbeitung Ihres Agenten. Jeder Schritt in der Aktivitätsüberwachung erscheint als ein Knoten, der veranschaulicht, was der Agent getan hat und warum.

Knotentypen

Die Aktivitätsüberwachung kann die folgenden Knotentypen enthalten:

Knotentyp Was es zeigt
Benutzernachricht Die Nachricht, die Sie an den Agenten gesendet haben
Agent-Antwort Die vom Agent erstellte Antwort
Wissen Eine Wissensquelle, die der Agent zur Erdung konsultierte. Dargestellt als eine zusammenklappbare Karte „Gesuchtes Wissen“, die die Quellen für jede genutzte Wissensquelle sowie Zitierhinweise anzeigt, sofern verfügbar.
Ausgeführte Aktion Ein Connector- oder Tool-Aufruf, dargestellt als ausklappbare Karte, die den Connector, ausgefüllte Eingabeparameter und die Ausführungsdauer anzeigt
Tool Ein Tool, das der Agent aufgerufen hat, um eine Aktion auszuführen oder Daten abzurufen
Connector Ein Connector, den der Agent zum Zugriff auf externe Daten verwendet hat
Flow Ein Agent-Flow, der ausgelöst wurde
Fertigkeit Eine Fertigkeit, die ausgeführt wurde
Error Ein Fehler, der bei der Verarbeitung aufgetreten ist
Abschließen Ein grünes Häkchen wird am unteren Rand des Überwachung angezeigt, wenn alle Toolaufrufe abgeschlossen sind

Knotendetails anzeigen

  1. Wählen Sie einen beliebigen Knoten in der Überwachung aus, um dessen Details einzublenden.

  2. Überprüfen Sie die angezeigten Informationen, die Folgendes umfassen können:

    • Die Eingabe, die der Agent an den Schritt gesendet hat
    • Die Ausgabe oder das zurückgegebene Ergebnis
    • Bearbeitungszeit und Metriken
    • Fehlerdetails, wenn der Schritt fehlgeschlagen ist

Fehlerbehebung bei Wissensquellen

Wenn Ihr Agent Wissen verwendet, um eine Frage zu beantworten, zeigt die Ablaufverfolgung, welche Quellen konsultiert wurden:

  1. Suchen Sie den Wissens-Knoten in der Überwachung.

  2. Überprüfen Sie die Quelle, um zu sehen, auf welche Wissensquellen zugegriffen wurde.

  3. Wählen Sie eine Quelle aus, um den spezifisch abgerufenen Inhalt anzuzeigen.

  4. Überprüfen Sie, ob der Agent die korrekte Quelle verwendet hat und ob der abgerufene Inhalt relevant ist.

Wenn der Agent die falsche Quelle verwendet oder ungenaue Informationen zurückgegeben hat, überprüfen Sie Ihre Wissenskonfiguration in der Registerkarte Build.

Tool-Ausführung debuggen

Wenn Ihr Agent ein Tool aufruft, zeigt die Überwachung die Ausführungsdetails:

  1. Finden Sie den Knoten Tool, Connector, Flow, oder Fertigkeit in der Überwachung.

  2. Überprüfen Sie die Ausführungsdetails, einschließlich der Eingabeparameter und der Ausgabeergebnisse.

  3. Stellen Sie sicher, dass das richtige Tool aufgerufen wurde und die Ergebnisse wie erwartet ausfallen.

  4. Wenn die Ausführung eines Tools fehlgeschlagen ist, überprüfen Sie die Fehlerdetails im Knoten.

Um ein Tool neu zu konfigurieren, öffnen Sie die Registerkarte Build und suchen Sie das Tool in der Konfiguration Ihres Agenten.

Fehler beheben

Wenn während der Verarbeitung Fehler auftreten, hebt die Überwachung sie hervor:

  1. Suchen Sie nach Knoten, die mit einer Fehleranzeige in der Überwachung markiert sind.

  2. Wählen Sie den „Fehlerknoten“ aus, um die Fehlerdetails, einschließlich der Fehlermeldung und des Kontexts, anzuzeigen.

  3. Häufige Probleme sind:

    • Authentifizierungsfehler bei Tools oder Connectors
    • Zugriffsfehler bei Wissensquellen
    • Timeout-Fehler bei länger laufenden Toolaufrufen
    • Kennzeichnung Inhaltsmoderation

  4. Beheben Sie die Ursache in der Registerkarte Build oder in den Einstellungen, und testen Sie anschließend erneut.

Die Aktivitätsüberwachung ist in der Registerkarte Build integriert, um schnelles Bearbeiten zu ermöglichen.

  1. Wählen Sie eine Quelle, ein Tool oder eine Komponente in der Überwachung aus.

  2. Copilot Studio wechselt zur entsprechenden Komponente in der Registerkarte Build.

  3. Nehmen Sie Ihre Änderungen vor und kehren Sie zur Registerkarte Vorschauversion zurück, um erneut zu testen.

  • Last updated on