Debuggen eines Copilot-Plug-Ins im Entwicklermodus
Sie können den Entwicklermodus verwenden, während Sie Ihr Plug-In testen, um zu überprüfen, ob und wie der Orchestrator Ihr Plug-In als Reaktion auf eine bestimmte Aufforderung zur Verwendung ausgewählt hat.
Verwenden des Copilot-Plug-In-Entwicklermodus
In copilot Chat können Sie den Entwicklermodus aktivieren, indem Sie eingeben -developer on
(oder off
deaktivieren).
Während der Entwicklermodus aktiviert ist, wird ein Karte mit Debuginformationen zurückgegeben, wenn der Orchestrator speziell in Ihrem Unternehmenswissen (Daten) und/oder Skills (Plug-Ins) sucht, um auf eine Eingabeaufforderung zu reagieren. Die Debuginformationen Karte enthält die folgenden Felder:
- Aktivierte Plug-Ins: Eine Liste der vom Benutzer aktivierten Plug-Ins (über das Plug-In-Steuerelement unterhalb des Chateingabefelds)
- Übereinstimmene Funktionen: Eine Liste der Plug-Ins und Funktionen, die in der Laufzeit-App-Indexsuche übereinstimmen
- Ausgewählte Funktionen für die Ausführung: Eine Liste von Plug-In-Funktionen, die für den Aufruf ausgewählt wurden, basierend auf Orchestratorargumenten
- Details zur Funktionsausführung: Anforderungs- und Antwortfunktionsausführung status
Problembehandlung bei Ausführungsfehlern
Im Folgenden finden Sie einige häufige Fehler, die beim Debuggen der Plug-In-Ausführung auftreten können, und mögliche Ursachen.
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.
Karte ohne aktivierte Plug-Ins
Wenn keine Plug-Ins aktiviert wurden, wird im Abschnitt Aktivierte Plug-Ins angegeben, dass keine Plug-Ins aktiviert sind.
Karte ohne übereinstimmene Funktionen
Wenn relevante Plug-Ins aktiviert sind, aber keine übereinstimmenden Funktionen für die angegebene Eingabeaufforderung zurückgegeben wurden, deutet dies wahrscheinlich darauf hin, dass die Eingabeaufforderung den Namen des Plug-Ins nicht explizit Erwähnung hat.
Karte mit "Keine Funktionen" für die Ausführung ausgewählt
Wenn kein aktiviertes Plug-In mit der Suchabsicht der Eingabeaufforderung übereinstimmt, melden die Debuginformationen Karte Keine für die Ausführung ausgewählten Funktionen. Dies liegt wahrscheinlich daran, dass die Befehlsbeschreibung im Manifest nicht semantisch mit der Suchabsicht der angegebenen Eingabeaufforderung verknüpft ist.
Wenn Copilot ihre Plug-In-Funktionen zuvor erfolgreich abgleichte und ausführte, könnte 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, deutet dies auf einen Fehler beim Versuch von Copilot hin, der ausgewählten Funktion Ihres Plug-Ins Parameter zuzuweisen. Wenn der Fehler konsistent ist, ist dies höchstwahrscheinlich auf unklare Plug-In- 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
Bitte melden Sie Feedback oder Probleme mit Ihrem Plug-In, indem Sie die Schaltfläche "Daumen nach oben" oder "Daumen nach unten" verwenden. Fügen Sie das tag #extensibility in Ihren Bericht ein. Wählen Sie direkt nach der Copilot-Antwort aus, ob Sie den Daumen nach oben ("Ich mag etwas") oder daumenabwärts ('Ich mag etwas nicht') )
Geben Sie dann eine Nachricht ein, die das tag #extensibility in das Textfeld enthält.