Agentenaktivität überprüfen

Das Erstellen eines Agents ist ein iterativer Prozess. Dazu gehört, zu verstehen, wie Ihre Agents arbeiten, Änderungen vornehmen und die Ergebnisse sehen. Dieser Prozess hilft Ihnen bei der Erstellung besserer Agents. Die Aktivitätsnachverfolgung von Copilot Studio bietet eine visuelle Zuordnung der Sequenz ihrer Agenten von Eingaben, Entscheidungen und Ausgaben innerhalb einer Aktivität, sodass Sie Probleme und Verbesserungsmöglichkeiten finden können.

Für jede Aktivität wird eine Aktivitätskarte generiert. Eine Aktivität beginnt, wenn ein Agent eine Unterhaltung startet oder ein externes Ereignis einen Agent auslöst. Eine Karte stellt jede Aktivität mit einem Knoten dar.

Es gibt zwei Formen der Aktivitätsnachverfolgung:

• Echtzeit-Aktivitätsdiagramm der Leistung Ihres Agents während des Testens
• Historische Aktivitätskarten und Transkriptionen aus früheren Aktivitäten

Echtzeit-Aktivitätsdiagramm während des Testens

Wenn Sie Ihrem Agent im Bereich "Agent testen " eine Frage stellen, zeigt die Aktivitätskarte eine visuelle Darstellung des Plans an, den der Agent generiert hat. Die Karte hebt Fehler hervor, z. B. fehlende oder ungültige Eingabe- oder Ausgabeparameter für Aktionen und zeigt, wie lange jeder Schritt ausgeführt werden muss. Sie können auch überprüfen, ob die Informationen, die Ihr Agent sendet oder empfängt, korrekt sind.

Um die Aktivitätskarte automatisch anzuzeigen, wenn Sie im Bereich Agent testen eine Abfrage an Ihren Agent senden, wählen Sie die drei Punkte (…) aus und aktivieren Sie anschließend Aktivitätskarte beim Testen anzeigen.

Hier fragte der Benutzer: "Wie sieht das Wetter morgen in Toronto, Kanada aus?" Sie können die Aktion sehen, die der Agent für die Antwort ausgewählt hat, sowie die Eingaben und Ausgaben.

Testereignisse auslösen

Wenn Sie Ereignistrigger testen, zeigt der Testchat die Triggernutzlast als Nachricht an. Nur Sie können diese Meldung in Copilot Studio zu Testzwecken sehen. Benutzer Ihres Agenten können ihn nicht sehen. Verwenden Sie die Nutzlastmeldungen, um zu verstehen, wann und welche Informationen und Anweisungen ein Trigger an Ihren Agent sendet.

Nachverfolgen der Themenverläufe

Wenn Sie Ihren Agenten testen, können Sie zwischen Themen wechseln. Wenn Sie die Nachverfolgung aktivieren, zeigt die Aktivitätszuordnung die Knoten innerhalb des Themas an, während sie ausgeführt werden, wenn ein Thema als Teil eines Plans ausgelöst wird. Sie können den Gesprächsverlauf überwachen.

Anzeigen von Variablen

Sie können die Variablen anzeigen, die von Ihrem Agent während des Tests verwendet werden. Diese Variablen können globale, Umgebungs-, System- oder benutzerdefinierte Variablen sein, auf die der Agent zugreifen kann.

So zeigen Sie die Variablen an:

1. Öffnen Sie Ihren Agent. Die Seite Übersicht wird angezeigt.
2. Wählen Sie "Testen" aus, um den Bereich "Agent testen" zu öffnen.
3. Starten Sie im Bereich " Agent testen" eine Unterhaltung mit Ihrem Agent, indem Sie eine Abfrage oder Eingabeaufforderung eingeben.
4. Um Variablen während des Tests anzuzeigen, wählen Sie "Testen" und dann "Variablen" aus. Der Bereich "Variablen " wird geöffnet, in dem die variablen angezeigt werden, die während des Tests verwendet werden.

Anzeigen der Gedankenkette des Agenten im Testchat

Das Feature Chain of Thought (CoT) bietet Einblicke in den Begründungsprozess Ihres Agenten während des Tests. Es zeigt die Zwischenschritte, Überlegungen und Entscheidungen des Agents an, während sie Eingaben verarbeitet und Ausgaben generiert. Dieses Feature ist nützlich, um komplexe Interaktionen und Das Debuggen des Agentverhaltens zu verstehen.

Führen Sie die folgenden Schritte aus, um die Gedankenkette des Agenten oder die Begründung während des Tests anzuzeigen:

1. Öffnen Sie Ihren Agent. Die Seite Übersicht wird angezeigt.
2. Wählen Sie "Testen" aus, um den Bereich "Agent testen" zu öffnen.
3. Starten Sie im Bereich " Agent testen" eine Unterhaltung mit Ihrem Agent, indem Sie eine Abfrage oder Eingabeaufforderung eingeben.
4. Bevor der Agent antwortet, wird die Begründung im Bereich " Agent testen " angezeigt und zeigt die Gedankenkette für die Reaktion des Agenten an.

Historische Aktivität

Jedes Mal, wenn ein Agent eine Aktivität startet, einschließlich Tests, die Sie in Copilot Studio initiieren, zeichnet die Aktivitätsseite die Aktivität in Echtzeit auf. Gehen Sie zur Seite Aktivität:

• Überprüfen Sie die Interaktionen und die Entscheidungen, die Ihr Agent während einer Aktivität getroffen hat.
• Suchen Sie, wo das Verhalten des Agents nicht Ihren Zielen entspricht.
• Erfahren Sie, wie lange Ihr Agent die einzelnen Aktivitäten abschließen muss.
• Finden Sie Fehlerdetails.

Historische Agentenaktivität ist verfügbar für:

• Interaktionen in Copilot Studio test chat
• Agenten, die in den Kanälen Microsoft Teams und Microsoft 365 Copilot veröffentlicht wurden
• Agents, die im SharePoint-Kanal veröffentlicht wurden
• Aktivitäten, die mit einem autonomen Trigger begonnen haben

Überprüfen Sie die folgenden Informationen auf der Seite "Aktivität ":

• Die Liste der Aktivitäten und deren Details.
• Der schrittweise Dialog, der innerhalb einer Aktivität stattfindet.

Aktivitätsliste

Eine Aktivität ist eine Einheit der Agentinteraktion, die eine Unterhaltung mit einem Benutzer, das Registrieren und Reagieren auf Ereignisse oder eine Kombination dieser Aktivitäten umfasst.

In der Aktivitätsliste können Sie Folgendes sehen:

• Name: Der Name des Benutzers, der mit dem Agent interagiert. Wenn die Aktivität keinen Benutzer umfasst, z. B. wenn ein Agent Aktionen ohne menschliche Aufforderung ausführt, wird der Benutzer als automatisiert angezeigt.
• Kanäle: Der Kanal, in dem die Interaktion stattgefunden hat. Aktivitäten, die im Bereich Test your agent des Agents stattfinden, sind mit dem Copilot Studio-Symbol gekennzeichnet.
• Datum: Das Datum, an dem die erste Interaktion der Aktivität beginnt.
• Abgeschlossene Schritte: Die Anzahl der Schritte, die der Agent während der Aktivität ausführt.
• Letzter Schritt: Der letzte Schritt ist in der Aktivität abgeschlossen.
• Status: Der Status der Aktivität (erfolgreich, fehlgeschlagen, in Bearbeitung).

Ansicht der Aktivitätstabelle anpassen

Sie können die Ansicht „Aktivitätstabelle“ anpassen, um sich auf die für Sie relevantesten Informationen zu konzentrieren.

So passen Sie die Ansicht der Aktivitätstabelle an:

1. Gehen Sie zur Seite Aktivität für Ihren Agent. Eine Liste der Aktivitäten wird angezeigt.
2. Wählen Sie Spalten bearbeiten aus. Der Bereich "Spalten bearbeiten " wird mit einer Liste der verfügbaren Spalten angezeigt.
3. Im Bereich "Spalten bearbeiten ":
   • Aktivieren Sie das Kontrollkästchen neben dem Namen der anzuzeigenden Spalten.
   • Deaktivieren Sie das Kontrollkästchen neben dem Namen der zu verbergenden Spalten.
   • Verschieben Sie die Spalten per Drag&Drop in Ihrer bevorzugte Reihenfolge, oder verwenden Sie die Pfeile nach oben und unten.
4. Wählen Sie Speichern aus, um die Ansicht „Aktivitätstabelle“ zu bestätigen und zu aktualisieren.

Sortieren und Filtern von Sitzungen

Sie können die Sitzungen basierend auf Datum, Kanal, Status und Fehlern sortieren und filtern, um sie für eine schnellere Triage und Überprüfung schnell einzugrenzen und die Ansicht anzupassen, um sich auf die wichtigsten Aspekte Ihres Workflows zu konzentrieren.

Um Sitzungen zu sortieren oder zu filtern, wechseln Sie zur Seite "Aktivität ". Eine Liste der Aktivitätssitzungen wird angezeigt.

• Zum Sortieren von Sitzungen zeigen Sie auf die Spaltenüberschrift, nach der Sie sortieren möchten, bis der Sortierpfeil angezeigt wird, und wählen Sie ihn aus. Wählen Sie es erneut aus, um die Sortierreihenfolge umzukehren.
• Wenn Sie Ihre Ansicht so anpassen möchten, dass sie sich auf bestimmte Sitzungen konzentriert, wählen Sie "Filter" aus, und wählen Sie die Kriterien aus, nach denen Sie filtern möchten.
• Um Sitzungen nach Status einzugrenzen, wählen Sie oben in der Sitzungsliste eine der folgenden Filterpillen aus: Fehlgeschlagen, Blockiert, In Bearbeitung, Warten auf Benutzer oder Abgeschlossen.

Sitzungsaktivität anzeigen

Auf der Seite "Aktivität" können Sie die Unterhaltung innerhalb einer Aktivität entweder in einer visuellen Aktivitätskarte oder sowohl in einem Gesprächsprotokoll als auch in einer visuellen Aktivitätskarte anzeigen. Standardmäßig wird die Ansicht Transkript und Karte angezeigt.

1. Um eine Unterhaltung innerhalb einer Aktivität anzuzeigen, wählen Sie eine Aktivität aus.

   • Wenn Sie Transkript und Aktivitätskarte zusammen anzeigen möchten, wählen Sie Ansicht und dann Transkript- und Kartenansicht aus.
   • Um nur die Aktivitätskarte anzuzeigen, wählen Sie Ansicht und dann Kartenansicht aus.

   

2. Um zur Aktivitätsliste zurückzukehren, wählen Sie das Zurück-Symbol aus.

In der Transkript- und Kartenansicht wird die Unterhaltung angezeigt, die während einer Aktivität zusammen mit der visuellen Aktivitätskarte mit dem Agent stattgefunden hat. Das Transkript zeichnet die Benutzereingabe auf, löst Nutzlasten und Agentantworten auf. Verwenden Sie die Transkriptionen, um zu sehen, wie Ihr Agent auf Unterhaltungen mit Benutzern reagiert. Sie können auch die Trigger-Payload-Nachrichten anzeigen, die Ihr Agent von Event-Triggers erhält.

Anzeige des Gedankenablaufs des Agenten

Das Feature "Chain of Thought" (CoT) bietet Einblicke in den Begründungsprozess Ihres Agenten während einer Aktivität. Es zeigt die Zwischenschritte, Überlegungen und Entscheidungen des Agents an, während sie Eingaben verarbeitet und Ausgaben generiert. Dieses Feature ist nützlich, um komplexe Interaktionen und Das Debuggen des Agentverhaltens zu verstehen. Sie können die Gedankenkette des Agenten nur in der Kartenansicht für eine bestimmte Aktivität anzeigen.

Um den Gedankenablauf oder die Begründung des Agenten für eine bestimmte Aktivität anzuzeigen:

1. Wählen Sie auf der Registerkarte " Aktivität " die Aktivität aus, die Sie überprüfen möchten. Standardmäßig wird die Transkript- und Kartenansicht angezeigt.
2. Wählen Sie in der Aktivitätsübersicht den Reasoning-Pfeil aus. Die Gedankenkette des Agenten wird angezeigt.

Anheften oder Ablösen von Aktivitäten

Auf der Seite "Aktivität " können Sie wichtige Aktivitäten an den Anfang der Aktivitätsliste anheften, um den Zugriff zu erleichtern oder sie zu lösen, wenn sie nicht mehr benötigt werden.

• Um eine Aktivität anzuheften, zeigen Sie mit der Maus auf die Aktivität und wählen Sie das Symbol "Anheften" neben dem Namen aus.
• Um eine Aktivität zu lösen, bewegen Sie den Mauszeiger über die angeheftete Sitzungsaktivität, und wählen Sie das Symbol „Lösen“ neben dem Namen aus.

Alle Agentenaktivitäten in der Aktivitätskarte anzeigen

Die Kartenansicht ist eine visuelle Darstellung des Flusses von Eingaben, Entscheidungen und Reaktionen, die während einer Aktivität auftreten. Jede Aktivität, die Ihr Agent, ein Benutzer oder ein Trigger mit einem Knoten ausführt. Wählen Sie beim Anzeigen der Aktivitätskarte einen Knoten aus, um Details zu den Eingaben, Entscheidungen und Ausgaben für diese Aktivität anzuzeigen.

Die folgende Abbildung ist ein Beispiel für das, was Sie sehen, wenn Sie einen Wissensknoten auswählen. Es zeigt:

• Die Abfrage, die der Agent zum Durchsuchen der Wissensquellen verwendet hat. Sie kann sich von der Abfrage unterscheiden, die von einem Benutzer geschrieben wurde, oder von der Eingabe, die von einem Trigger bereitgestellt wird.
• Die Antwort, die der Agent basierend auf den Wissensquellen erstellt hat.
• Die Quellen, auf die der Agent verweist.
• Andere Quellen, die der Agent durchsucht hat, aber nicht zum Erstellen der Antwort verwendet hat. Der Agent hat diese Quellen durchsucht, aber keine für die Abfrage relevanten Informationen gefunden.

In diesem Beispiel können Sie die Details eines Aktionsknotens für Prognose für morgen erhalten sehen, wobei Eingaben und Ausgaben angezeigt werden:

Wählen Sie "Bearbeiten" aus, um die der ausgewählten Aktivität zugeordnete Konfiguration anzuzeigen und zu ändern.

Begründung

Rationale bietet eine Erklärung dafür, wie ein Agent beschlossen hat, ein bestimmtes Tool aufzurufen. KI generiert die Begründung auf Abruf und beruht auf Agentmetadaten und -aktivitäten. Rationale wird für Wissensquellen oder Connectoren im Status "Abgeschlossen" angezeigt. Wählen Sie Rationale anzeigen aus, um die Rationale anzuzeigen.

Verwenden Sie rationale , wenn Sie die Agentaktivität überprüfen, um besser zu verstehen, warum ein Agent ein bestimmtes Tool aufruft oder Parameter einfüllt. Es hilft Ihnen bei der Fehlerbehebung des Agentverhaltens. Da KI jedoch die Rationale generiert, ist sie möglicherweise nicht korrekt. Verwenden Sie Ihr bestes Urteil, wenn Sie die bereitgestellte Begründung überprüfen.

Agentenstatus

Die folgende Tabelle enthält Informationen zu den verschiedenen Zuständen, auf die ein Agent während des Vorgangs stoßen kann:

Feedback senden

Wenn Sie Vorschläge zur Verbesserung ihrer Agentqualität haben, senden Sie Ihr Feedback über das Feedbacksymbol auf der Registerkarte " Aktivität ".