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.
Darüber hinaus können Sie das Feature Vorschau Ihrer App (F5) im Microsoft 365 Agents Toolkit verwenden, um Ihre Agents in einer lokalen Entwicklungsumgebung zu testen. Dieses Feature bietet eine interaktive Möglichkeit, das Verhalten zu überprüfen und Probleme direkt über die Entwicklungsschnittstelle zu beheben.
Verwenden des Entwicklermodus im Copilot Chat and Agents Toolkit
Sie können Ihren Agent über das Agents-Toolkit in Visual Studio Code testen, indem Sie im Bereich Agents Toolkit die Option Vorschau Ihrer App (F5) auswählen. Dadurch wird Ihr Agent in einer browserbasierten Copilot Chat gestartet, sodass Sie schnell überprüfen können, wie er sich als Reaktion auf Eingabeaufforderungen verhält.
Nachdem Sie Ihren Agent in Microsoft 365 Copilot Chat ausgewählt haben, aktivieren Sie den Entwicklermodus, indem -developer onSie eingeben. 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 nach Unternehmenswissen (Daten), Funktionen oder Fähigkeiten (Aktionen oder Plug-Ins) sucht. Im Agent-Toolkit werden diese Debuginformationen im Bereich Debuggen angezeigt und umfassen die folgenden Felder:
- Agent-Metadaten: Bezeichner für den Agent und die Konversation
- Funktionen: Eine Liste der für den Agent konfigurierten Funktionen sowie deren Ausführungs- status und Antwortstatistiken (falls ausgeführt)
-
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
Abschnitt "Agentmetadaten"
Die Agent-Metadaten enthalten wichtige Details zum Agent und zur aktuellen Debugsitzung, einschließlich:
- Zusammenfassung : Eine allgemeine Übersicht über die konfigurierten Wissensquellen und deren Nutzungsstatistiken
- 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 : Bezeichner für die aktive Chatsitzung oder Unterhaltung
- Anforderungs-ID : Bezeichner für die spezifische Eingabeaufforderung innerhalb der Unterhaltung
Agent-Funktionen
Im Abschnitt Agent-Funktionen werden die konfigurierten Funktionen für den Agent angezeigt, wobei der Umfang der verfügbaren Wissensquellen definiert wird. Die folgenden Details werden für jede Funktion bereitgestellt, die von der Eingabeaufforderung verwendet wird.
- Ausführung status – Gibt an, ob die Funktion während der Orchestrierung verwendet wurde.
- Diagnoseprotokolldatei : Eine herunterladbare .txt-Datei mit detaillierten Ausführungsergebnissen, einschließlich Erfolgs- oder Fehlermeldungen, die bei der Problembehandlung und Überprüfung hilfreich sein können
Agentaktionen
Der Abschnitt Agent-Aktionen bietet einen detaillierten Einblick in die Verarbeitung der Aktionen Ihres Agents (Funktionen oder Plug-Ins) während der Orchestrierung. Diese Informationen sind in drei Schlüsselbereiche unterteilt: Aktionsmetadaten, Funktionsabgleich und -auswahl sowie Ausführungsdetails.
Aktionsmetadaten
In diesem Abschnitt werden allgemeine Informationen zu den Aktionen angezeigt, die für Ihren Agent registriert sind. Diese Informationen umfassen die Aktions-ID (der eindeutige Bezeichner für die Aktion) und die Versionsnummer (die Version der verwendeten Aktionsdefinition).
Funktionsabgleich und -auswahl
In diesem Teil wird gezeigt, wie der Orchestrator die Benutzeraufforderung interpretiert hat und ob Funktionen als für die Ausführung relevant angesehen wurden:
Übereinstimmene Funktionen : Funktionen, die semantisch mit der Benutzeraufforderung während der Laufzeit-App-Indexsuche übereinstimmen. Wenn für die angegebene Eingabeaufforderung keine übereinstimmenen Funktionen zurückgegeben wurden, ist es wahrscheinlich, dass die Eingabeaufforderung den Aktionsnamen nicht explizit Erwähnung hat.
Ausgewählte Funktionen für die Ausführung : Funktionen, die für den Aufruf basierend auf der Argumentation des Orchestrators und der Relevanz für die Eingabeaufforderung ausgewählt wurden. Wenn keine Aktionen aktiviert wurden, gibt der Abschnitt aktionen an, dass keine Aktionen aktiviert sind.
Ausführungsdetails
Details zur Aktionsausführung umfassen die Funktion und deren status sowie Latenz, Anforderungsinformationen (Anforderungsendpunkt, HTTP-Methode, Anforderungsheader) und die Antwort.
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 Debuginformationen
Überprüfen Sie nach dem Starten des Agents, ob die Verbindung mit dem Browser im Debugbereich als erfolgreich markiert ist. Wenn dies nicht der Fall ist, versuchen Sie erneut, F5 in Visual Studio Code auszuführen, um eine neue Sitzung zu starten.
Wenn die Verbindung erfolgreich hergestellt wurde, Aber keine Debuginformationen angezeigt werden, kann dies daran zurückzuführen sein, dass der Orchestrator ihre Microsoft 365-Daten oder -Fähigkeiten nicht benötigt, um zu reagieren. In diesem Fall werden keine Debuginformationen Karte zurückgegeben.
Debuginformationen werden auch bei Kapazitätsdrosselung nicht zurückgegeben, bei denen in der Regel eine Fehlermeldung angezeigt wird, die Sie später erneut versuchen können.
Debuginformationen, bei denen keine Funktionen für die Ausführung ausgewählt sind
Wenn keine Aktionsfunktion mit der Suchabsicht der Eingabeaufforderung übereinstimmt, meldet die Debuginformation Karte Keine Funktionen, die für die Ausführung ausgewählt wurden. Die Ursache ist wahrscheinlich, 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, werden die Anforderungen möglicherweise gedrosselt.
Debuginformationen mit leeren oder fehlgeschlagenen Details zur Ausführung ohne Funktion
Wenn bei API-Plug-Ins 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.
Melden eines Problems
Melden Sie Feedback oder Probleme mit Ihrem Agent, indem Sie die Schaltfläche "Daumen nach oben" oder "Daumen nach unten" verwenden. Fügen Sie das #extensibility Tag in Ihren Bericht ein.
