Foutcode-referentie voor agenten (GitHub Copilot)

Wanneer een agent die wordt aangedreven door de GitHub Copilot-kabel een beurt niet kan voltooien, tonen de tabbladen Preview, Test en Evaluate een foutmelding samen met een korte foutcode. De foutcode identificeert de oorzaak, zodat je kunt beslissen of je het opnieuw probeert, je invoer verandert of contact opneemt met je beheerder.

Note

Het harnas dat wordt gebruikt om dit middel te bouwen, gebruikt gebruiksgebaseerde facturering. Het gebruiken, bouwen, testen en evalueren van agenten kan Copilot Credits kosten. Lees meer in Overzicht van gebruiksgebaseerde facturering.

Waar je foutcodes ziet

Foutcodes verschijnen op verschillende plaatsen in agenten die worden aangedreven door het GitHub Copilot-harnas

Foutcode-samenvatting

De volgende tabel vat elke foutcode samen, of opnieuw proberen meestal helpt, en of de volgende stap bij jou (de maker), de eindgebruiker of je beheerder ligt.

Error code Meaning Opnieuw proberen helpt meestal Action owner
CONTENT_FILTERED Een inhoudsveiligheidsbeleid blokkeerde het verzoek of de reactie. Nee, met dezelfde input End user
CONTEXT_LENGTH_EXCEEDED De aanvraag was te groot voor het model. Nee, met dezelfde input Maker
CONVERSATION_BUSY Een eerder bericht wordt nog verwerkt voor hetzelfde gesprek. Ja, nadat de vorige beurt is afgelopen End user
CROSS_GEO_NOT_ALLOWED De gegevensresidentie-instellingen van je huurder voorkomen dat het verzoek wordt verwerkt. No Administrator
DEPLOYMENT_NOT_FOUND De geconfigureerde AI-modelimplementatie kon niet worden gelokaliseerd. No Beheerder of maker
MODEL_CONSENT_DENIED Het gekozen AI-model is niet ingeschakeld voor jouw organisatie. No Administrator
QUOTA_EXCEEDED Het AI-servicequotum van uw organisatie is uitgeput. Ja, na een langere wachttijd Administrator
RATE_LIMIT_REACHED De AI-dienst is tijdelijk bezet. Ja, na een korte wachttijd End user
SYSTEM_ERROR Er is een onverwachte fout opgetreden die onderzoek vereist. Soms; Probeer het opnieuw voordat je het escaleert. Support

De rest van dit artikel beschrijft elke code in detail.

CONTENT_FILTERED

Een inhoudsveiligheidsbeleid blokkeerde het verzoek of de reactie.

Wat het meestal betekent

Het inhoudsveiligheidsbeleid van Microsoft omvat categorieën zoals haat, geweld, seksuele inhoud, zelfbeschadiging, jailbreakpogingen en indirecte aanvallen. Ofwel het verzoek van de gebruiker of het antwoord van de agent heeft een van deze categorieën getriggerd.

Wat u moet doen

  • Herformuleer het verzoek om de gemarkeerde inhoud te vermijden.
  • Voor agenten die deze fout vaak tegenkomen bij legitieme invoer, verfijn de Instructies op het tabblad Bouwen om de bedoelde scope van de agent te verduidelijken. Lees meer in Configureer agentidentiteit en instructies (preview).
  • De agent onthult niet welke categorie is geactiveerd, om informatielekkage te voorkomen. Als je een specifiek geval moet onderzoeken, neem dan contact op met je beheerder met de conversatie-ID uit de activiteitstrace.

CONTEXT_LENGTH_EXCEEDED

Het verzoek overschreed de maximale invoergrootte van het AI-model.

Wat het meestal betekent

De gecombineerde omvang van de instructies van de agent, de gespreksgeschiedenis, de tooldefinities en eventuele resultaten van het tool is groter dan het model in één beurt kan verwerken. Lange gesprekken en grote aantallen hulpmiddelen zijn de meest voorkomende oorzaken.

Wat u moet doen

CONVERSATION_BUSY

Een eerder bericht in hetzelfde gesprek wordt nog verwerkt.

Wat het meestal betekent

De agent verwerkt één beurt tegelijk binnen één gesprek. Als je een tweede bericht stuurt voordat de vorige beurt is afgelopen, kan het nieuwe bericht pas starten als de agent de lopende beurt heeft voltooid.

Wat u moet doen

  • Wacht tot het vorige antwoord klaar is en stuur dan het nieuwe bericht.
  • Als je per ongeluk het tweede bericht hebt verzonden (bijvoorbeeld door dubbel op Verzenden te klikken), neem dan geen actie. De duplicaat wordt afgewezen en de oorspronkelijke beurt gaat verder.
  • Als de agent vastzit in een vorige beurt, begin dan een nieuw gesprek. Lees meer in Voorbeeldgesprekken beheren (voorbeeld).

CROSS_GEO_NOT_ALLOWED

De gegevensresidentie-instellingen van je huurder staan niet toe dat het verzoek in een andere regio wordt verwerkt.

Wat het meestal betekent

Het beleid van uw organisatie vereist dat gegevens binnen een specifieke regio blijven, en er is geen in-regio implementatie van het gevraagde model beschikbaar voor uw tenant.

Wat u moet doen

  • Neem contact op met je beheerder om:
    • Schakel cross-region gegevensbeweging in voor AI-diensten in tenantinstellingen in, of
    • Bied een in-regio implementatie van het model aan.
  • Als maker verander je het model van de agent naar een model dat in jouw regio wordt ingezet. Lees meer in Selecteer een agentmodel (preview).

DEPLOYMENT_NOT_FOUND

De geconfigureerde AI-modelimplementatie is niet te vinden.

Wat het meestal betekent

Het model waarop uw agent is ingesteld is te gebruiken is met pensioen gestuurd, verwijderd of is anderszins niet beschikbaar in uw omgeving. Dit gedrag kan optreden nadat een model is verouderd of na een wijziging in de tenantconfiguratie.

Wat u moet doen

  • Open op het tabblad Bouw de modelkiezer en selecteer een beschikbaar model. Lees meer in Selecteer een agentmodel (preview).
  • Als een eerder beschikbaar model verdwenen is, neem dan contact op met je beheerder om de implementatie van het model in je omgeving te verifiëren.

Het AI-model dat je agent gebruikt is niet ingeschakeld voor je tenant of omgeving.

Wat het meestal betekent

Sommige modellen vereisen expliciete toestemming op het niveau van de tenant of omgeving voordat agenten ze mogen gebruiken. Als er geen toestemming wordt gegeven, kan de makelaar het model niet bellen.

Wat u moet doen

  • Neem contact op met je beheerder om het vereiste model in de Copilot Studio-instellingen in te schakelen.
  • Als je agent is geconfigureerd met een fallback-model, probeert de agent automatisch opnieuw met de fallback. In dat geval is geen actie nodig.
  • Als je dit specifieke model niet nodig hebt, verander dan het model op het tabblad Bouw. Lees meer in Selecteer een agentmodel (preview).

QUOTA_EXCEEDED

Uw organisatie heeft haar quotum voor de AI-dienst overschreden.

Wat het meestal betekent

In tegenstelling tot RATE_LIMIT_REACHED, wat een kortstondige burstlimiet is, QUOTA_EXCEEDED geeft aan dat uw organisatie een langlopende gebruiksquota heeft bereikt. Deze quota volgen doorgaans tokens of verzoeken over een factureringsperiode.

Wat u moet doen

  • Wacht en probeer het later opnieuw Quota worden meestal op een vast schema gezet.
  • Neem contact op met uw beheerder om de AI-servicequota van de organisatie te beoordelen en indien nodig een verhoging aan te vragen.
  • Voor doorlopende ontwikkelingswerk, plan grote evaluatierondes buiten de spitsuren in.

RATE_LIMIT_REACHED

De AI-dienst is tijdelijk druk en heeft het verzoek afgewezen.

Wat het meestal betekent

De vraag naar de AI-dienst steeg sterk, of je organisatie stuurde in korte tijd veel verzoeken. Dit gedrag is tijdelijk.

Wat u moet doen

  • Wacht een paar seconden en probeer het opnieuw.
  • Voor testruns in Evaluate voer je de mislukte testcases opnieuw uit.
  • Als de fout herhaaldelijk gebeurt, neem dan contact op met je beheerder om de capaciteit te controleren.

SYSTEM_ERROR

Er is een onverwachte fout opgetreden die niet overeenkomt met een van de meer specifieke codes.

Wat het meestal betekent

SYSTEM_ERROR is een verzamelverzamelaar voor tijdelijke infrastructuurproblemen, onverwachte interne storingen of omstandigheden die technisch onderzoek vereisen. Nieuwe foutcategorieën kunnen ook opduiken SYSTEM_ERROR totdat ze een speciale code krijgen in een toekomstige release.

Wat u moet doen

  • Probeer de aanvraag opnieuw. Het probleem kan tijdelijk zijn.
  • Als de fout blijft bestaan, registreer dan de conversatie-ID uit de activiteitstrace en het tijdstip van de mislukking, en neem dan contact op met support.
  • Als het probleem meerdere gebruikers tegelijk treft, vraag dan je beheerder om het gezondheidsdashboard van de Microsoft 365-service te controleren.

Commando geblokkeerd voor veiligheid

Wanneer een agent een tool gebruikt die commando's uitvoert (bijvoorbeeld een code-interpreter of een shelltool), voert Copilot Studio veiligheidscontroles uit voordat elk commando wordt uitgevoerd. Als een commando overeenkomt met een onveilig patroon, wordt het commando niet uitgevoerd en meldt de agent dat de operatie is geblokkeerd. Bijvoorbeeld een destructieve bestandssysteemoperatie, een wijziging in de netwerkconfiguratie, of een andere actie buiten het beoogde bereik van het gereedschap. De blokkade verschijnt als een stap in de activiteitstrace met een melding dat het commando is geweigerd.

Wat u moet doen

  • Eindgebruikers: probeer een andere formulering die de geblokkeerde operatie vermijdt, of vraag de agent om hetzelfde doel te bereiken via een veiligere stap.
  • Makers: bekijk op het tabblad Bouwen de beschrijving van de tool en de instructies van de agent zodat de agent binnen het bereik blijft dat je verwacht. Lees meer in Configureer agentidentiteit en instructies (preview).
  • Als een legitieme operatie herhaaldelijk wordt geblokkeerd, verzamel dan de conversatie-ID uit de activiteitstrace en neem contact op met je beheerder.

Forward compatibility

De lijst met foutcodes kan in toekomstige releases groeien. Als je automatisering of dashboards bovenop foutcodes bouwt (bijvoorbeeld bij evaluatieresultatenverwerking), behandel dan onbekende code hetzelfde als SYSTEM_ERROR: toon een generiek bericht en sta opnieuw proberen toe.

  • Laatst bijgewerkt om