Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Testen ist ein wichtiger Teil des Prozesses der Entwicklung deklarativer Agents für Microsoft 365 Copilot Chat. Sie können den Entwicklermodus verwenden, während Sie Ihren Agent testen, um zu überprüfen, ob und wie der Copilot-Orchestrator Ihre Wissensquellen für die Verwendung als Reaktion auf bestimmte Eingabeaufforderungen auswählt.
Verwenden des Entwicklermodus in Copilot Chat
Um den Entwicklermodus zu aktivieren, geben Sie in Microsoft 365 Copilot Chat ein-developer on. Um den Entwicklermodus zu deaktivieren, geben Sie ein -developer off.
Während der Entwicklermodus aktiviert ist, wird ein Karte mit Debuginformationen zurückgegeben, wenn der Orchestrator in Ihrem Agent speziell innerhalb Ihres Unternehmenswissens (Daten), Funktionen oder Fähigkeiten (Aktionen oder Plug-Ins) durchsucht, um auf eine Eingabeaufforderung zu reagieren. Die Karte mit Debuginformationen enthält die folgenden Felder:
- Agent-Metadaten: Bezeichner für den Agent und die Konversation.
- Funktionen: Eine Liste der für den Agent konfigurierten Funktionen.
-
Aktionen: Eine Liste der für den Agent konfigurierten Aktionen
- Übereinstimmene Funktionen: status von Funktionen, die in der Laufzeit-App-Indexsuche übereinstimmen
- Ausgewählte Funktionen für die Ausführung: status von Funktionen, die basierend auf Orchestratorargumenten 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: Anforderungs- und Antwortausführung status für Aktionen.
Abschnitt "Agentmetadaten"
Die Agent-Metadaten enthalten wichtige Details zum Agent und zur aktuellen Debugsitzung, einschließlich:
- Agent-ID : Ein eindeutiger Bezeichner für den Agent, der die Titel-ID und die Manifest-ID enthält.
- Agent-Version : Die Versionsnummer des derzeit verwendeten Agents.
- Unterhaltungs-ID : Identifiziert die aktive Chatsitzung oder Unterhaltung.
- Anforderungs-ID : Identifiziert die spezifische Eingabeaufforderung innerhalb der Konversation.
Agent-Funktionen
Im Abschnitt Agent-Funktionen werden die konfigurierten Funktionen für den Agent angezeigt, wobei der Umfang der verfügbaren Wissensquellen definiert wird.
Agentaktionen
Agentaktionen zeigen die Aktions-ID und Versionsnummer, konfigurierte Funktionen für die Aktion sowie deren Abgleich und Auswahl status an.
Karte ohne aktivierte Aktionen
Wenn keine Aktionen aktiviert wurden, gibt der Abschnitt aktionen an, dass keine Aktionen aktiviert sind.
Karte ohne übereinstimmene Funktionen
Wenn für die angegebene Eingabeaufforderung keine übereinstimmenen Funktionen zurückgegeben wurden, deutet dies wahrscheinlich darauf hin, dass die Eingabeaufforderung den Aktionsnamen nicht explizit Erwähnung hat.
Ausführungsdetails
In den Abschnitten mit den ausgeführten Details wird angezeigt, ob und welche der konfigurierten Funktionen oder Aktionen für die Eingabeaufforderung ausgeführt wurden, sowie die Ausführungsdetails und status.
Details zur Funktionsausführung
Details zur Funktionsausführung zeigen die ausgeführte Funktion und deren 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 Aktionsausführung
Details zur Aktionsausführung umfassen die Funktion und deren status sowie Latenz, Anforderungsinformationen (Anforderungsendpunkt, HTTP-Methode, Anforderungsheader) und die Antwort.
Karte mit "Keine Funktionen" für die Ausführung ausgewählt
Wenn keine Aktionsfunktion mit der Suchabsicht der Eingabeaufforderung übereinstimmt, meldet die Debuginformation Karte Keine Funktionen, die für die 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 leeren oder fehlgeschlagenen Details zur Ausführung ohne Funktion
Wenn bei Plug-Ins für Nicht-Nachrichtenerweiterungen fehler oder keine Funktionsausführungsdetails vorhanden sind, weist dies auf einen Fehler beim Versuch Ihres Agents hin, der ausgewählten Funktion Ihres Plug-Ins Parameter zuzuweisen. Wenn der Fehler konsistent ist, ist dies höchstwahrscheinlich auf unklare Aktions- oder Parameterbeschreibungen, ungültige Host-URLs oder andere Probleme mit Ihrer Open API-Definition zurückzuführen.
Für Nachrichtenerweiterungs-Plug-Ins besteht die bewährte Methode darin, für 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.
Problembehandlung bei Fehlern
Im Folgenden finden Sie häufige Fehler, die beim Debuggen ihres Agents auftreten können, sowie mögliche Ursachen für die Fehler.
Keine Debug-Karte
Wenn der Orchestrator ihre Microsoft 365-Daten oder -Fähigkeiten nicht benötigt, um auf eine Eingabeaufforderung zu reagieren, werden keine Debuginformationen Karte zurückgegeben.
Debugkarten werden auch nicht zurückgegeben, wenn die Kapazität gedrosselt wird. In der Regel wird eine Fehlermeldung angezeigt, die Sie später erneut versuchen können.
Melden eines Problems
Melden Sie Feedback oder Probleme mit Ihrem Agent, indem Sie die Daumen nach oben oder die Daumen nach unten drücken. Fügen Sie das tag #extensibility in Ihren Bericht ein.
Geben Sie eine Nachricht einschließlich des #extensibility-Tags in das Textfeld ein.
