Fehlercode-Referenz für Agenten (GitHub Copilot)

Wenn ein Agent, der vom GitHub Copilot-Harness betrieben wird, eine Runde nicht abschließen kann, zeigen die Reiter Vorschau, Testen und Bewerten eine Fehlermeldung zusammen mit einem kurzen Fehlercode an. Der Fehlercode identifiziert die Ursache, sodass Sie entscheiden können, ob Sie es erneut versuchen, Ihre Eingabe ändern oder Ihren Administrator kontaktieren.

Note

Funktionen in diesem Artikel werden von Agenten oder Workflows genutzt, die vom GitHub Copilot-Harness betrieben werden.

Nutzungsbasierte Abrechnung gilt für die Nutzung, den Bau, das Testen und die Bewertung von Agenten. Diese Aktionen könnten Copilot-Credits verbrauchen. Erfahren Sie mehr unter Kosten verwalten für Agenten, die vom GitHub Copilot-Harness betrieben werden.

Wo du Fehlercodes siehst

Fehlercodes erscheinen an mehreren Stellen bei Agenten, die mit dem GitHub Copilot-Harness betrieben werden:

Fehlercode-Zusammenfassung

Die folgende Tabelle fasst jeden Fehlercode zusammen, ob ein erneuter Versuch normalerweise hilft und ob der nächste Schritt bei Ihnen (dem Hersteller), dem Endnutzer oder Ihrem Administrator liegt.

Error code Meaning Ein erneuter Versuch hilft meistens Action owner
CONTENT_FILTERED Eine Inhaltssicherheitsrichtlinie blockierte die Anfrage oder Antwort. Nein, mit demselben Input End user
CONTEXT_LENGTH_EXCEEDED Die Anfrage war für das Modell zu groß. Nein, mit demselben Input Maker
CONVERSATION_BUSY Eine frühere Nachricht wird für dasselbe Gespräch noch verarbeitet. Ja, nachdem die vorherige Runde vorbei ist End user
CROSS_GEO_NOT_ALLOWED Die Daten-Wohnsitzeinstellungen Ihres Mieters verhindern, dass die Anfrage bearbeitet wird. No Administrator
DEPLOYMENT_NOT_FOUND Die konfigurierte KI-Modellbereitstellung konnte nicht gefunden werden. No Verwalter oder Schöpfer
MODEL_CONSENT_DENIED Das ausgewählte KI-Modell ist für Ihre Organisation nicht aktiviert. No Administrator
QUOTA_EXCEEDED Die KI-Servicequote Ihrer Organisation ist erschöpft. Ja, nach längerer Wartezeit Administrator
RATE_LIMIT_REACHED Der KI-Dienst ist vorübergehend beschäftigt. Ja, nach kurzer Wartezeit End user
SYSTEM_ERROR Ein unerwarteter Fehler ist aufgetreten, der untersucht werden muss. Manchmal; Versuchen Sie es noch einmal, bevor Sie eskalieren Support

Der Rest dieses Artikels beschreibt jeden Code im Detail.

CONTENT_FILTERED

Eine Inhaltssicherheitsrichtlinie blockierte die Anfrage oder Antwort.

Was es normalerweise bedeutet

Die Sicherheitsrichtlinien von Microsoft umfassen Kategorien wie Hass, Gewalt, sexuelle Inhalte, Selbstverletzung, Jailbreak-Versuche und indirekte Angriffe. Entweder die Anfrage des Nutzers oder die Antwort des Agenten löste eine dieser Kategorien aus.

Nächste Schritte

  • Formulieren Sie die Anfrage um, um die markierten Inhalte zu vermeiden.
  • Für Agenten, die diesen Fehler häufig bei legitimen Eingaben haben, verfeinern Sie die Anweisungen auf dem Bau-Reiter , um den vorgesehenen Umfang des Agenten zu verdeutlichen. Mehr erfahren Sie unter Agentenidentität und Anweisungen konfigurieren (Vorschau).
  • Der Agent verrät nicht, welche Kategorie ausgelöst wurde, um Informationslecks zu verhindern. Wenn du einen bestimmten Fall untersuchen musst, kontaktiere deinen Administrator mit der Konversations-ID aus der Aktivitätsverfolgung.

CONTEXT_LENGTH_EXCEEDED

Die Anfrage überschritt die maximale Eingabegröße des KI-Modells.

Was es normalerweise bedeutet

Die kombinierte Größe der Anweisungen des Agenten, der Gesprächshistorie, der Werkzeugdefinitionen und der Ergebnisse eines Werkzeugs ist größer, als das Modell in einer einzigen Runde verarbeiten kann. Lange Gespräche und eine große Anzahl von Werkzeugen sind die häufigsten Ursachen.

Nächste Schritte

CONVERSATION_BUSY

Eine frühere Nachricht im selben Gespräch wird noch verarbeitet.

Was es normalerweise bedeutet

Der Agent verarbeitet einen Zug nach dem anderen innerhalb eines einzigen Gesprächs. Wenn du eine zweite Nachricht schickst, bevor die vorherige Runde endet, kann die neue Nachricht erst starten, wenn der Agent die laufende Runde abgeschlossen hat.

Nächste Schritte

  • Warte, bis die vorherige Antwort fertig ist, und sende dann die neue Nachricht.
  • Wenn du die zweite Nachricht versehentlich gesendet hast (zum Beispiel durch Doppelklick auf Senden), unternimm keine Aktion. Das Duplikat wird abgelehnt und der ursprüngliche Zug geht weiter.
  • Wenn der Agent in einer vorherigen Runde feststeckt, beginnen Sie ein neues Gespräch. Erfahren Sie mehr unter Verwalten von Vorschaugesprächen (Vorschau).

CROSS_GEO_NOT_ALLOWED

Die Datenresidenz-Einstellungen Ihres Mieters erlauben keine Bearbeitung der Anfrage in einer anderen Region.

Was es normalerweise bedeutet

Die Richtlinie Ihrer Organisation verlangt, dass Daten innerhalb einer bestimmten Region bleiben, und für Ihren Mieter ist keine Bereitstellung des angeforderten Modells innerhalb der Region verfügbar.

Nächste Schritte

  • Kontaktieren Sie Ihren Administrator, um entweder:
    • Aktivieren Sie die Querschnittsdatenbewegung für KI-Dienste in Mietereinstellungen oder
    • Bieten Sie eine regionale Bereitstellung des Modells bereit.
  • Als Maker ändere das Modell des Agenten zu einem, das in deiner Region eingesetzt wird. Erfahren Sie mehr unter Select a agent model (Vorschau).

DEPLOYMENT_NOT_FOUND

Die konfigurierte KI-Modellbereitstellung kann nicht gefunden werden.

Was es normalerweise bedeutet

Das Modell, das Ihr Agent verwenden soll, wurde zurückgezogen, entfernt oder ist in Ihrer Umgebung anderweitig nicht verfügbar. Dieses Verhalten kann auftreten, nachdem ein Modell veraltet wurde oder nach einer Änderung der Mieterkonfiguration.

Nächste Schritte

  • Öffne im Reiter "Bauen " den Modellwähler und wähle ein verfügbares Modell aus. Erfahren Sie mehr unter Select a agent model (Vorschau).
  • Wenn ein zuvor verfügbares Modell verschwunden ist, wenden Sie sich an Ihren Administratoren, um die Modellbereitstellung in Ihrer Umgebung zu überprüfen.

Das KI-Modell, das Ihr Agent verwendet, ist für Ihren Mieter oder Ihre Umgebung nicht aktiviert.

Was es normalerweise bedeutet

Einige Modelle verlangen eine ausdrückliche Zustimmung auf Tenant- oder Environment-Ebene, bevor Agenten sie nutzen dürfen. Wenn keine Zustimmung erteilt wird, kann der Makler das Model nicht anrufen.

Nächste Schritte

  • Kontaktieren Sie Ihren Administrator, um das erforderliche Modell in den Copilot Studio-Einstellungen zu aktivieren.
  • Wenn dein Agent mit einem Fallback-Modell konfiguriert ist, versucht der Agent es automatisch erneut mit dem Fallback. In diesem Fall ist keine Maßnahme erforderlich.
  • Wenn Sie dieses spezielle Modell nicht benötigen, ändern Sie das Modell im Reiter "Bauen". Erfahren Sie mehr unter Auswählen eines Agentenmodells (Vorschau).

QUOTA_EXCEEDED

Ihre Organisation hat ihre Quote für den KI-Dienst überschritten.

Was es normalerweise bedeutet

Im Gegensatz zu RATE_LIMIT_REACHED, das eine kurzlebige Burst-Grenze ist, zeigt an, QUOTA_EXCEEDED dass Ihre Organisation eine längerfristige Nutzungsquote erreicht hat. Diese Quoten verfolgen typischerweise Token oder Anfragen über einen Abrechnungszeitraum.

Nächste Schritte

  • Warten Sie, und versuchen Sie es später noch einmal. Quoten setzen sich in der Regel nach einem festen Zeitplan zurück.
  • Kontaktieren Sie Ihren Administrator, um die KI-Servicequote der Organisation zu überprüfen und gegebenenfalls eine Erhöhung zu beantragen.
  • Für die laufende Entwicklungsarbeit planen Sie große Evaluationsläufe außerhalb der Hauptverkehrszeiten.

RATE_LIMIT_REACHED

Der KI-Dienst ist vorübergehend beschäftigt und hat die Anfrage abgelehnt.

Was es normalerweise bedeutet

Die Nachfrage nach dem KI-Dienst stieg stark an, oder Ihre Organisation hat in kurzer Zeit viele Anfragen gesendet. Dieses Verhalten ist vorübergehend.

Nächste Schritte

  • Warten Sie einige Sekunden, und versuchen Sie es noch mal.
  • Für Testläufe in Evaluate, führe die fehlgeschlagenen Testfälle erneut aus.
  • Wenn der Fehler wiederholt auftritt, kontaktiere deinen Administrator, um die Kapazität zu überprüfen.

SYSTEM_ERROR

Ein unerwarteter Fehler trat auf, der mit keinem der spezifischeren Codes übereinstimmt.

Was es normalerweise bedeutet

SYSTEM_ERROR ist ein Sammelbegriff für vorübergehende Infrastrukturprobleme, unerwartete interne Ausfälle oder Bedingungen, die technisch untersucht werden müssen. Neue Fehlerkategorien könnten ebenfalls auftauchen, bis SYSTEM_ERROR sie in einer zukünftigen Version einen dedizierten Code erhalten.

Nächste Schritte

  • Versuchen Sie die Anforderung erneut. Das Problem könnte vorübergehend sein.
  • Wenn der Fehler weiterhin auftritt, erfassen Sie die Konversations-ID aus der Aktivitätsverfolgung und den Zeitpunkt des Ausfalls und kontaktieren Sie dann den Support.
  • Wenn das Problem mehrere Nutzer gleichzeitig betrifft, bitten Sie Ihren Administrator, das Gesundheits-Dashboard des Microsoft 365-Dienstes zu überprüfen.

Kommando aus Sicherheitsgründen blockiert

Wenn ein Agent ein Tool verwendet, das Befehle ausführt (zum Beispiel einen Code-Interpreter oder ein Shell-Tool), führt Copilot Studio Sicherheitsprüfungen durch, bevor jeder Befehl ausgeführt wird. Wenn ein Befehl einem unsicheren Muster entspricht, wird der Befehl nicht ausgeführt und der Agent meldet, dass die Operation blockiert wurde. Zum Beispiel eine destruktive Dateisystemoperation, eine Änderung der Netzwerkkonfiguration oder eine andere Aktion außerhalb des vorgesehenen Anwendungsbereichs des Werkzeugs. Der Block erscheint als Schritt in der Aktivitätsverfolgung mit der Nachricht, dass der Befehl verweigert wurde.

Nächste Schritte

  • Endnutzer: Probieren Sie eine andere Formulierung, die die blockierte Operation vermeidet, oder bitten Sie den Agenten, dasselbe Ziel durch einen sichereren Schritt zu erreichen.
  • Makers: Im Reiter "Bauen " die Beschreibung des Tools und die Anweisungen des Agenten überprüfen, damit der Agent im von dir erwarteten Umfang bleibt. Mehr erfahren Sie unter Agentenidentität und Anweisungen konfigurieren (Vorschau).
  • Wenn eine legitime Operation wiederholt blockiert wird, erfassen Sie die Konversations-ID aus der Aktivitätsverfolgung und kontaktieren Sie Ihren Administrator.

Forward compatibility

Die Liste der Fehlercodes könnte in zukünftigen Veröffentlichungen wachsen. Wenn du Automatisierung oder Dashboards auf Fehlercodes baust (zum Beispiel bei der Verarbeitung von Evaluationsergebnissen), behandle unbekannten Code gleich wie SYSTEM_ERROR: eine generische Nachricht anzeigen und einen erneuten Versuch erlauben.