Verwenden des Entwicklermodus in Microsoft 365 Copilot zum Testen und Debuggen von Agents

Tests sind ein wichtiger Teil des Prozesses der Entwicklung deklarativer Agents für Microsoft 365 Copilot. Sie können den Entwicklermodus in Copilot Studio verwenden, um Ihren Agent zu testen und zu überprüfen, ob und wie der Copilot-Orchestrator Ihre Wissensquellen zur Verwendung als Reaktion auf vorgegebene Eingabeaufforderungen auswählt.

Entwicklermodus in Copilot verwenden

Geben Sie -developer onein, um den Entwicklermodus in Copilot zu aktivieren. Um den Entwicklermodus zu deaktivieren, geben Sie -developer offein.

Screenshot der Microsoft 365 Copilot-Sitzung, in der der Benutzer

Wenn der Entwicklermodus aktiviert ist, wird eine Karte mit Debuginformationen zurückgegeben, wenn der Orchestrator speziell in Ihrem Unternehmen nach Kenntnissen (Daten), Fähigkeiten oder Fertigkeiten (Aktionen oder Plug-Ins) in Ihrem Agent sucht, um auf eine Eingabeaufforderung zu reagieren. Die Debug-Info-Karte enthält die folgenden Felder:

  • Agent-Metadaten: Bezeichner für den Agenten und die Konversation.
  • Funktionen: Eine Liste der für den Agent konfigurierten Funktionen.
  • Aktionen: Eine Liste der für den Agent konfigurierten Aktionen
    • Übereinstimmende Funktionen: Status von Funktionen, die in der Indexsuche der Laufzeit-App übereinstimmen
    • Ausgewählte Funktionen für die Ausführung: Status der Funktionen, die basierend auf Orchestrator-Überlegungen für den Aufruf ausgewählt wurden
  • Ausführung: Eine Liste der ausgeführten Funktionen und Aktionen für die Eingabeaufforderung
    • Ausgeführte Funktionen: Status und Antwortstatistiken für ausgeführte Funktionen.
    • Ausgeführte Aktionen: Status der Anforderungs- und Antwortausführung für Aktionen.

Abschnitt "Agent-Metadaten"

Screenshot der Microsoft 365 Copilot-Sitzung, in der Copilot eine Karte mit Debuginformationen zurückgegeben hat, die die Agent-Metadaten anzeigen

Die Agent-Metadaten liefern wichtige Details über den Agent und die aktuelle Debugsitzung, einschließlich:

  • Agent-ID – Ein eindeutiger Bezeichner für den Agenten, der die Titel-ID und die Manifest-ID enthält.
  • Agent-Version – Die Versionsnummer des aktuell verwendeten Agents.
  • Unterhaltungs-ID : Identifiziert die aktive Chatsitzung oder Konversation.
  • Anforderungs-ID : Identifiziert den spezifischen Prompt innerhalb der Unterhaltung.

Hinweis

Das Präfix in der Agent-ID gibt an, wie der Agent verteilt ist:

  • U_ Gibt einen benutzerbezogenen (quergeladenen) Agent an.
  • T_ Gibt einen mandantenbezogenen Agent an (veröffentlicht im Mandantenspeicher oder Organisationskatalog).
  • P_ Gibt einen öffentlich verfügbaren Agent an.

Entsprechende Veröffentlichungsanleitungen finden Sie unter:

Agent-Funktionen

Screenshot der Microsoft 365 Copilot-Sitzung, in der Copilot eine Karte mit Debuginformationen zurückgegeben hat, die die konfigurierten Agent-Funktionen anzeigen

Im Abschnitt Agent-Funktionen werden die konfigurierten Funktionen für den Agenten angezeigt und der Umfang seiner zugänglichen Wissensquellen definiert.

Wichtig

Wenn im Abschnitt Agent-Funktionen angegeben ist, dass WebSearch aktiviert ist, bedeutet dies nur, dass der Agent die Funktion aktiviert hat. Sie spiegelt nicht die Cloudrichtlinieneinstellung wider, die Allow web search in Copilot Administratoren verwenden können, um die Websuche für ihre organization zu deaktivieren. Weitere Informationen finden Sie unter Verwalten von Microsoft 365 Copilot-Szenarien im Microsoft 365 Admin Center.

Agentaktionen

Screenshot der Microsoft 365 Copilot-Sitzung, in der Copilot eine Karte mit Debuginformationen zurückgegeben hat, die die konfigurierten Agentaktionen anzeigen

Agentaktionen zeigen die Aktions-ID und Versionsnummer, konfigurierte Funktionen für die Aktion sowie deren Abgleichs- und Auswahl status an.

Karte ohne aktivierte Aktionen

Wenn keine Aktionen aktiviert wurden, zeigt der Abschnitt Aktionen an, dass keine Aktionen aktiviert sind.

Karte ohne übereinstimmende Funktionen

Wenn für die angegebene Eingabeaufforderung keine übereinstimmenden Funktionen zurückgegeben wurden, deutet dies wahrscheinlich darauf hin, dass der Aktionsname in der Eingabeaufforderung nicht explizit Erwähnung wurde.

Ausführungsdetails

In den Abschnitten mit den Ausführungsdetails wird angezeigt, ob und welche der konfigurierten Funktionen oder Aktionen für die Eingabeaufforderung ausgeführt wurden, sowie die Ausführungsdetails und der Status.

Details zur Ausführung der Funktion

Screenshot der Microsoft 365 Copilot-Sitzung, in der Copilot eine Karte mit Debuginformationen zurückgegeben hat, die die ausgeführten Funktionen anzeigen

Details zur Funktionsausführung zeigen die ausgeführte Fähigkeit und ihren Status an. Jede Funktion kann unterschiedliche Ausführungsdetails aufweisen, z. B. den verwendeten Suchtext, die Antwort der Funktion und/oder die Anzahl der zurückgegebenen Ergebnisse.

Details zur Ausführung der Aktion

Screenshot der Microsoft 365 Copilot-Sitzung, in der Copilot eine Karte mit Debuginformationen zurückgegeben hat, die die ausgeführten Aktionen anzeigen

Details zur Ausführung von Aktionen umfassen die Funktion und ihren Status sowie die Latenz, Anforderungsinformationen (Anforderungsendpunkt, HTTP-Methode, Anforderungsheader) und die Antwort.

Karte ohne Funktionen zur Ausführung ausgewählt

Wenn keine Aktionsfunktion mit der Suchabsicht der Eingabeaufforderung übereinstimmt, meldet die Debug-Info-Karte, dass keine Funktionen zur Ausführung ausgewählt wurden. Dies liegt wahrscheinlich daran, dass die Befehlsbeschreibung im Manifest nicht semantisch mit der Suchabsicht der angegebenen Eingabeaufforderung zusammenhängt.

Wenn Copilot Ihre Funktionen zuvor erfolgreich abgeglichen und ausgeführt hat, kann dies ein Hinweis auf eine Drosselung sein.

Karte mit leerer oder ausgefallener Karte Keine Details zur Funktionsausführung

Wenn bei Nicht-Nachrichtenerweiterungs-Plug-Ins Fehler oder keine Details zur Funktionsausführung vorhanden sind, weist dies auf einen Fehler beim Versuch Ihres Agenten hin, der ausgewählten Funktion Ihres Plug-Ins Parameter zuzuweisen. Wenn der Fehler konsistent ist, liegt dies höchstwahrscheinlich an unklaren Aktions- oder Parameterbeschreibungen, ungültigen Host-URLs oder anderen Problemen mit Ihrer Open API-Definition.

Für Nachrichtenerweiterungs-Plug-Ins besteht die bewährte Methode darin, Antworten unter neun Sekunden zu optimieren. Weitere Informationen finden Sie in den technischen Anforderungen für Nachrichtenerweiterungs-Plug-Ins.

Derzeit ist das Timeoutlimit für die Copilot-Ausführung einer Plug-In-API auf 10 Sekunden festgelegt.

Fehler bei Problembehandlung

Im Folgenden sind häufige Fehler aufgeführt, die beim Debuggen des Agents auftreten können, sowie mögliche Ursachen für die Fehler.

Keine Debug-Karte

Wenn der Orchestrator Ihre Microsoft 365-Daten oder -Skills nicht benötigt, um auf eine Eingabeaufforderung zu reagieren, wird keine Debug-Info-Karte zurückgegeben.

Debugkarten werden auch im Falle einer Kapazitätsdrosselung nicht zurückgegeben, wo in der Regel eine Fehlermeldung angezeigt wird, die Sie später erneut versuchen sollten.

Melden eines Problems

Melden Sie Feedback oder Probleme mit Ihrem Agent, indem Sie die Schaltfläche "Daumen hoch" oder "Daumen runter" verwenden. Fügen Sie das #extensibility-Tag in den Bericht ein.

Screenshot der Feedbackoptionen

Geben Sie eine Nachricht einschließlich des Tags "#extensibility" in das Textfeld ein.

Screenshot von Feedback zu Microsoft 365 Copilot im Textfeld