Kody błędów dla agentów (GitHub Copilot)

Gdy agent zasilany przez wiązkę GitHub Copilot nie może wykonać obrotu, zakładki Podgląd,Test i Ocena wyświetlają komunikat o błędzie wraz z krótkim kodem błędu. Kod błędu wskazuje przyczynę, dzięki czemu możesz zdecydować, czy spróbować ponownie, zmienić dane wejściowe, czy skontaktować się z administratorem.

Note

Uzbrojenie użyte do budowy tego agenta wykorzystuje rozliczenia oparte na użytkowaniu. Używanie, budowanie, testowanie i ocena agentów mogą zużywać kredyty Copilot. Dowiedz się więcej w Przegląd rozliczeń opartych na zużyciu.

Gdzie widzisz kody błędów

Kody błędów pojawiają się w kilku miejscach u agentów zasilanych przez wiązkę GitHub Copilot:

Podsumowanie kodu błędu

Poniższa tabela podsumowuje każdy kod błędu, czy powtórka zwykle pomaga, oraz czy kolejny krok należy do Ciebie (twórcy), użytkownika końcowego czy administratora.

Error code Meaning Zazwyczaj pomaga ponowna próba Action owner
CONTENT_FILTERED Polityka bezpieczeństwa treści blokowała żądanie lub odpowiedź. Nie, z tym samym wkładem End user
CONTEXT_LENGTH_EXCEEDED Żądanie było zbyt duże jak na model. Nie, z tym samym wkładem Maker
CONVERSATION_BUSY Poprzednia wiadomość wciąż jest przetwarzana na tę samą rozmowę. Tak, po zakończeniu poprzedniej tury End user
CROSS_GEO_NOT_ALLOWED Ustawienia rezydencji danych najemcy uniemożliwiają przetwarzanie żądania. No administratorzy
DEPLOYMENT_NOT_FOUND Nie udało się zlokalizować skonfigurowanego modelu AI. No Administrator lub twórca
MODEL_CONSENT_DENIED Wybrany model AI nie jest włączony w Twojej organizacji. No administratorzy
QUOTA_EXCEEDED Limit usług AI w Twojej organizacji został wyczerpany. Tak, po dłuższym oczekiwaniu administratorzy
RATE_LIMIT_REACHED Usługa AI jest tymczasowo zajęta. Tak, po krótkim oczekiwaniu End user
SYSTEM_ERROR Wystąpił nieoczekiwany błąd, który wymaga zbadania. Czasami; spróbuj jeszcze raz, zanim eskalujesz Support

Reszta tego artykułu szczegółowo opisuje każdy kod.

CONTENT_FILTERED

Polityka bezpieczeństwa treści blokowała żądanie lub odpowiedź.

Co to zwykle oznacza

Polityki bezpieczeństwa treści Microsoft obejmują takie kategorie jak nienawiść, przemoc, treści seksualne, samookaleczenia, próby jailbreaku oraz ataki pośrednie. Albo żądanie użytkownika, albo odpowiedź agenta wywołały jedną z tych kategorii.

Co zrobić

  • Przeformułuj prośbę, aby uniknąć oznaczonej treści.
  • Dla agentów, którzy często napotykają ten błąd przy legalnych wejściach, doprecyzuj instrukcje na zakładce Build , aby wyjaśnić zamierzony zakres agenta. Dowiedz się więcej w Konfiguruj tożsamość agenta i instrukcje (podgląd).
  • Agent nie ujawnia, która kategoria została wywołana, aby zapobiec wyciekowi informacji. Jeśli musisz zbadać konkretną sprawę, skontaktuj się z administratorem i podaj identyfikator rozmowy z śledzenia aktywności.

CONTEXT_LENGTH_EXCEEDED

Żądanie przekroczyło maksymalny rozmiar wejściowy modelu AI.

Co to zwykle oznacza

Łączny rozmiar instrukcji agenta, historii rozmów, definicji narzędzi oraz wyników narzędzi jest większy niż model jest w stanie przetworzyć w jednym ruchu. Długie rozmowy i duża liczba narzędzi to najczęstsze przyczyny.

Co zrobić

CONVERSATION_BUSY

Poprzednia wiadomość w tej samej rozmowie jest nadal przetwarzana.

Co to zwykle oznacza

Agent przetwarza kolejne tury w ramach jednej rozmowy. Jeśli wyślesz drugą wiadomość przed końcem poprzedniej tury, nowa wiadomość nie może się rozpocząć, dopóki agent nie ukończy tury w trakcie.

Co zrobić

  • Poczekaj, aż poprzednia odpowiedź się skończy, a potem wyślij nową wiadomość.
  • Jeśli wysłałeś drugą wiadomość przez pomyłkę (na przykład przez podwójne kliknięcie Wyślij), nie podejmuj żadnych działań. Duplikat zostaje odrzucony, a oryginalna tura trwa dalej.
  • Jeśli agent utknął w poprzedniej turze, rozpocznij nową rozmowę. Dowiedz się więcej w Zarządzaj rozmowami podglądowymi (podgląd).

CROSS_GEO_NOT_ALLOWED

Ustawienia rezydencji danych twojego najemcy nie pozwalają na przetwarzanie żądania w innym regionie.

Co to zwykle oznacza

Polityka Twojej organizacji wymaga, aby dane pozostały w określonym regionie, a wdrożenie żądanego modelu w regionie nie jest dostępne dla Twojego tenanta.

Co zrobić

  • Skontaktuj się z administratorem, aby połączyć się z tym:
    • Włącz przepływ danych między regionami dla usług AI w ustawieniach tenantów, lub
    • Zapewnij wdrożenie modelu w regionie.
  • Jako twórca zmień model agenta na taki, który jest wdrożony w twoim regionie. Dowiedz się więcej w modelu Wybierz agenta (podgląd).

DEPLOYMENT_NOT_FOUND

Nie można znaleźć skonfigurowanego modelu AI.

Co to zwykle oznacza

Model, do którego skonfigurowany jest Twój agent, został wycofany, usunięty lub w inny sposób niedostępny w Twoim środowisku. Takie zachowanie może wystąpić po wycofaniu modelu lub po zmianie konfiguracji tenanta.

Co zrobić

  • Na zakładce Buduj otwórz wybór modelu i wybierz dostępny model. Dowiedz się więcej w modelu Wybierz agenta (podgląd).
  • Jeśli wcześniej dostępny model zniknął, skontaktuj się z administratorem, aby zweryfikować wdrożenie modelu w Twoim środowisku.

Model AI, którego używa Twój agent, nie jest włączony dla najemcy ani środowiska.

Co to zwykle oznacza

Niektóre modele wymagają wyraźnej zgody na poziomie najemcy lub środowiska, zanim agenci mogą z nich korzystać. Jeśli zgoda nie zostanie udzielona, agent nie może zadzwonić do modelki.

Co zrobić

  • Skontaktuj się z administratorem, aby włączyć wymagany model w ustawieniach Copilot Studio.
  • Jeśli Twój agent jest skonfigurowany z modelem awaryjnym, automatycznie próbuje ponownie z tym modelem. W takim przypadku nie ma potrzeby działać.
  • Jeśli nie potrzebujesz tego konkretnego modelu, zmień go na zakładce Buduj . Dowiedz się więcej w sekcji Wybierz model agenta (podgląd).

QUOTA_EXCEEDED

Twoja organizacja przekroczyła kwotę dla usługi AI.

Co to zwykle oznacza

W przeciwieństwie do RATE_LIMIT_REACHED, który jest krótkotrwałym limitem burst, oznacza, QUOTA_EXCEEDED że Twoja organizacja osiągnęła limit zużycia na dłuższy czas. Te kwoty zazwyczaj śledzą tokeny lub żądania w okresie rozliczeniowym.

Co zrobić

  • Zaczekaj i spróbuj ponownie później. Normy zazwyczaj resetują się według stałego harmonogramu.
  • Skontaktuj się z administratorem, aby przejrzeć limit usług AI w organizacji i poprosić o podwyższenie, jeśli będzie to konieczne.
  • Do bieżących prac rozwojowych planuj duże oceny poza godzinami szczytu.

RATE_LIMIT_REACHED

Usługa AI jest tymczasowo zajęta i odrzuciła prośbę.

Co to zwykle oznacza

Popyt na usługę AI gwałtownie wzrósł lub Twoja organizacja wysłała wiele próśb w krótkim czasie. To zachowanie jest przejściowe.

Co zrobić

  • Poczekaj kilka sekund i spróbuj ponownie.
  • Do testów w Evaluate ponownie uruchom nieudane przypadki testowe.
  • Jeśli błąd powtarza się wielokrotnie, skontaktuj się z administratorem, aby sprawdzić przepustowość.

SYSTEM_ERROR

Wystąpił niespodziewany błąd, który nie pasuje do żadnego z bardziej szczegółowych kodów.

Co to zwykle oznacza

SYSTEM_ERROR jest zbiorem dotyczącym przejściowych problemów infrastrukturalnych, nieoczekiwanych awarii wewnętrznych lub warunków wymagających badań inżynieryjnych. Nowe kategorie błędów mogą się pojawić, dopóki SYSTEM_ERROR nie dostaną dedykowanego kodu w przyszłej wersji.

Co zrobić

  • Spróbuj ponownie wysłać żądanie. Problem może być przemijający.
  • Jeśli błąd się utrzymuje, zrób ID rozmowy z śledzenia aktywności oraz czas awarii, a następnie skontaktuj się z pomocą techniczną.
  • Jeśli problem dotyczy wielu użytkowników jednocześnie, poproś administratora o sprawdzenie panelu zdrowia usług Microsoft 365.

Reference codes

Niektóre komunikaty o błędach zawierają kod referencyjny zaczynający się od MCS- czterech cyfr, wraz z identyfikatorem rozmowy. Na przykład: "Proszę spróbować ponownie lub skontaktować się z administratorem pod kodem referencyjnym MCS-4063 (rozmowa ...)." Te komunikaty zwykle pojawiają się z kodem SYSTEM_ERROR błędu. Kod referencyjny pomaga administratorowi i pomoc techniczna firmy Microsoft zidentyfikować przyczynę awarii.

Poniższa tabela przedstawia kody referencyjne, które mają konkretną przyczynę, na którą możesz działać. W przypadku kodu referencyjnego, który nie jest wymieniony, postępuj zgodnie z wytycznymi dotyczącymi SYSTEM_ERROR i dołącz kod referencyjny oraz identyfikator rozmowy przy kontakcie z administratorem lub wsparciem.

Reference code Co to znaczy Co zrobić
MCS-2012 Rozmowa osiągnęła limit pamięci, więc agent nie mógł zapisać ostatniej tury. W większości przypadków nowa rozmowa zaczyna się automatycznie, a agent nie ma już wcześniejszej historii rozmowy. Wyślij jeszcze raz swoją ostatnią wiadomość. Jeśli komunikat o błędzie prosi o zresetowanie rozmowy, postępuj zgodnie z instrukcjami lub rozpocznij nową rozmowę. Jeśli błąd się powtarza, skontaktuj się z administratorem i podaj kod referencyjny oraz identyfikator rozmowy.
MCS-4042 Rozmowa, taka jak czat grupowy Teams czy wątek e-mailowy, ma więcej uczestników niż agent wspiera, więc agent nie może zweryfikować, czy wszyscy mają dostęp. Ten sam kod pojawia się, gdy wiadomość lub udostępnienie, które agent miał wysłać, dotrze do większej liczby osób, niż agent jest w stanie zweryfikować. Użyj rozmowy z mniejszą liczbą uczestników lub wyślij prośbę do mniejszej liczby odbiorców. Twój administrator nie może podnieść tego limitu.
MCS-4043 Agent nie mógł potwierdzić, czy wszyscy w rozmowie mają dostęp lub do kogo dotrze wiadomość, udostępnienie czy inne działania. Try again. W przypadku prośby o przesłanie lub udostępnienie treści sprawdź odbiorców lub poproś o jedno działanie naraz. Jeśli błąd się powtarza, skontaktuj się z administratorem i podaj kod referencyjny oraz identyfikator rozmowy.
MCS-4063 Agent osiągnął maksymalną liczbę połączeń modelu AI, które mógł wykonać, aby odpowiedzieć na jedną wiadomość, zanim zdążył zakończyć odpowiedź. Ponowne próbowanie tego samego żądania zwykle powoduje ten sam błąd. Podziel prośby na mniejsze i wysyłaj je pojedynczo. Jako twórca zapoznaj się z instrukcjami agenta na zakładce Buduj, aby jedna wiadomość nie wymagała tylu kroków. Dowiedz się więcej w Konfiguruj tożsamość agenta i instrukcje (podgląd).

Komenda zablokowana dla bezpieczeństwa

Gdy agent wykonuje polecenia, Copilot Studio przeprowadza kontrole bezpieczeństwa przed każdym poleceniem. Jeśli polecenie nie przejdzie tych kontroli, nie jest uruchamiane, a agent zgłasza, że operacja została zablokowana. Blok pojawia się jako krok w śledzeniu aktywności z komunikatem, że polecenie zostało odrzucone.

Co zrobić

  • Użytkownicy końcowi: Spróbuj innego sformułowania, które pozwoli uniknąć zablokowanej operacji, lub poproś agenta, by osiągnął ten sam cel w bezpieczniejszy sposób.
  • Twórcy: Na zakładce Buduj przejrzyj opis narzędzia oraz instrukcje agenta, aby agent pozostał w oczekiwanym zakresie. Dowiedz się więcej w Konfiguruj tożsamość agenta i instrukcje (podgląd).
  • Jeśli legalna operacja jest wielokrotnie blokowana, przechwyć identyfikator rozmowy z śledzenia aktywności i skontaktuj się z administratorem.

Forward compatibility

Lista kodów błędów może się powiększyć w przyszłych wydaniach. Jeśli budujesz automatyzację lub dashboardy na kodach błędów (na przykład w przetwarzaniu wyników ewaluacji), traktuj każdy nieznany kod tak samo jak SYSTEM_ERROR: pokaż ogólny komunikat i pozwól na ponowną próbę.

  • Ostatnia aktualizacja o