Rozwiązywanie problemów z operacjami agenta usługi Azure SRE — często zadawane pytania

W tym artykule opisano typowe problemy operacyjne podczas pracy z agentem usługi Azure SRE wraz z praktycznymi rozwiązaniami. Te problemy zwykle odnoszą się do uprawnień, dostępności regionalnej, problemów z wdrażaniem i wymagań dotyczących dostępu administracyjnego.

Typowe scenariusze rozwiązywania problemów

W poniższej tabeli przedstawiono typowe problemy i ich rozwiązania. Aby uzyskać więcej informacji na temat sposobu stosowania ról i uprawnień do agenta, zobacz Role i uprawnienia.

Problemy z wdrażaniem

W poniższych sekcjach opisano typowe problemy, które mogą wystąpić podczas wdrażania agenta usługi Azure SRE.

Nie znaleziono wdrożenia

Możesz napotkać błąd informujący, że wdrożenie nie zostało odnalezione, co może wynikać z kilku powodów. Najpierw upewnij się, że poprawnie nazywasz agenta i że masz odpowiednie reguły zapory:

• Upewnij się, że nazwa agenta jest unikatowa w ramach subskrypcji.
• Sprawdź reguły blokowania geograficznego lub zapory, które mogą uniemożliwić dostęp do punktu końcowego agenta.

Jeśli nazwa i konfiguracja sieci są poprawne, wykonaj następujące kroki, aby rozwiązać problem pojawiający się przy błędzie agenta "DeploymentNotFound".

1. Upewnij się, że twoje konto użytkownika ma uprawnienia właściciela lub administratora oraz uprawnienia do tworzenia zasobów w regionach Szwecja Środkowa, Wschodnie stany USA 2 lub Australia Wschodnia (w zależności od wdrożenia).

2. Sprawdź, czy subskrypcja znajduje się na liście dozwolonych dla SRE Agent. Uruchom następujące polecenie:

   az provider show -n Microsoft.App | grep -C 15 agents
   

   Jeśli twoja subskrypcja znajduje się na liście dozwolonych, otrzymasz dane wyjściowe podobne do poniższego komunikatu.

   

   Szukaj szczególnie "resourcetype : agents" i "defaultApiVersion : 2025-05-01-preview".

   Jeśli uruchomienie tego polecenia nie zwróci oczekiwanego wyniku, musisz zarejestrować subskrypcję.

3. Aby ponownie zarejestrować subskrypcję, uruchom az provider register polecenie w usłudze Azure Cloud Shell za pośrednictwem witryny Azure Portal:

   az provider register --namespace "Microsoft.App"
   

   Następnie spróbuj ponownie utworzyć agenta.

Błędy walidacji wdrożenia

Jeśli weryfikacja wdrożenia zakończy się niepowodzeniem:

1. Sprawdź limity przydziału zasobów: Upewnij się, że subskrypcja ma dostępny limit przydziału dla regionu wdrażania.
2. Sprawdź rejestrację dostawcy zasobów: Upewnij się, że dostawca Microsoft.App jest zarejestrowany.
3. Zapoznaj się z usługą Azure Policy: sprawdź, czy zasady organizacyjne blokują tworzenie zasobów.

Problemy z uprawnieniami i dostępem

Poniższe sekcje dotyczą problemów związanych z uprawnieniami i kontrolą dostępu dla agenta usługi Azure SRE.

Błędy uprawnień

Jeśli nie możesz rozmawiać lub korzystać z agenta, problem może być związany z błędem 403 Zabronione lub błędem zasad współużytkowania zasobów między źródłami (CORS). Poniższy zrzut ekranu przedstawia przykład komunikatu o błędzie.

Możesz też uzyskać następujący wynik w śladzie sieci.

Aby rozwiązać problem:

• Upewnij się, że masz dostęp współautora lub właściciela do grupy zasobów, która hostuje agenta.
• Unikaj polegania wyłącznie na przypisaniach ról opartych na grupach. Przypisz role bezpośrednio do konta, jeśli problemy będą się powtarzać.
• Użyj funkcji Sprawdź dostęp w witrynie Azure Portal, aby sprawdzić, czy masz odpowiednie uprawnienia.

Problemy z zarządzanymi tożsamościami agenta

Jeśli agent nie może uzyskać dostępu do zasobów platformy Azure:

1. Sprawdź tworzenie tożsamości zarządzanej: sprawdź, czy tożsamość zarządzana agenta została pomyślnie utworzona.
2. Sprawdź przypisania ról: upewnij się, że tożsamość zarządzana ma odpowiednie uprawnienia do zasobów docelowych.
3. Przejrzyj zasady dostępu warunkowego: upewnij się, że zasady organizacyjne nie blokują dostępu do tożsamości zarządzanej.

Problemy z siecią i łącznością

Poniższe sekcje ułatwiają rozwiązywanie problemów z siecią i łącznością, które mogą mieć wpływ na agenta usługi Azure SRE.

Portal przestaje odpowiadać

Jeśli witryna Azure Portal przestanie odpowiadać podczas próby użycia agenta SRE, reguły zapory mogą blokować dostęp do domeny platformy Azure.

Aby udzielić dostępu do odpowiedniej domeny, dodaj *.azuresre.ai do listy dozwolonych w ustawieniach zapory. Rozwiązanie Zscaler może domyślnie blokować dostęp do *.azuresre.ai domeny.

Błędy połączeń protokołu WebSocket

Jeśli funkcje czatu w czasie rzeczywistym nie działają:

1. Sprawdź ustawienia serwera proxy: firmowe serwery proxy mogą blokować połączenia protokołu WebSocket.
2. Sprawdź reguły zapory: Upewnij się, że *.azuresre.ai znajduje się na liście dozwolonych zarówno dla ruchu HTTP, jak i WebSocket.
3. Testowanie łączności sieciowej: użyj narzędzi deweloperskich przeglądarki, aby sprawdzić, czy występują błędy połączenia.

Problemy z wydajnością

W poniższych sekcjach opisano typowe problemy związane z wydajnością agenta usługi Azure SRE.

Powolne czasy odpowiedzi

Jeśli odpowiedzi agenta są wolniejsze niż oczekiwano:

1. Sprawdź kondycję usługi platformy Azure: sprawdź brak przestojów w regionie wdrażania.
2. Przejrzyj złożoność zapytania: Złożone zapytania dzienników mogą być przetwarzane dłużej.
3. Monitorowanie limitów zasobów: Upewnij się, że zasoby docelowe (Log Analytics i inne) nie są poddawane ograniczeniom przepustowości.

Problemy z ładowaniem interfejsu czatu

Jeśli interfejs czatu nie zostanie załadowany:

1. Wyczyść pamięć podręczną przeglądarki: Wymuś odśwież stronę (Ctrl+F5).
2. Spróbuj użyć trybu incognito lub przeglądania prywatnego: wyklucz konflikty rozszerzeń przeglądarki.
3. Sprawdź konsolę języka JavaScript: poszukaj komunikatów o błędach w narzędziach deweloperskich przeglądarki.

Rozwiązywanie problemów z integracją

Poniższe sekcje ułatwiają rozwiązywanie problemów z integracją usług zewnętrznych.

Błędy połączeń z usługą GitHub lub Azure DevOps

Jeśli integracja kontroli źródła nie powiedzie się:

1. Weryfikowanie uwierzytelniania: sprawdź uprawnienia jednostki usługi lub osobistego tokenu dostępu.
2. Dostęp do testowego interfejsu API: upewnij się, że agent może uzyskiwać dostęp do interfejsów API usługi zewnętrznej.
3. Przejrzyj reguły zapory: potwierdź dostęp wychodzący do github.com lub dev.azure.com.

Problemy z niestandardowym serwerem MCP

Jeśli niestandardowe serwery protokołu kontekstu modelu nie działają:

1. Sprawdź kondycję serwera: Sprawdź, czy serwer MCP jest uruchomiony i dostępny.
2. Testowanie uwierzytelniania: upewnij się, że konfiguracja uwierzytelniania jest prawidłowa.
3. Przejrzyj dzienniki: Sprawdź logi agenta pod kątem błędów połączenia lub protokołu.

Problemy z danymi i magazynem

W poniższych sekcjach omówiono problemy związane z magazynem danych i pobieraniem w agencie usługi Azure SRE.

Brak historii konwersacji

Jeśli wątki konwersacji znikną:

1. Sprawdź ustawienia przechowywania danych: Sprawdź skonfigurowane zasady przechowywania.
2. Przejrzyj uprawnienia dostępu: Upewnij się, że masz dostęp do danych konwersacji.
3. Skontaktuj się z pomocą techniczną: Aby uzyskać pomoc dotyczącą odzyskiwania danych.

Problemy z przesyłaniem bazy wiedzy

Jeśli przekazywanie dokumentu do bazy wiedzy nie powiedzie się:

1. Sprawdź limity rozmiaru pliku: upewnij się, że dokumenty znajdują się w ramach ograniczeń rozmiaru.
2. Sprawdź formaty plików: Potwierdź obsługiwane typy dokumentów.
3. Przejrzyj uprawnienia dotyczące magazynu: Sprawdź dostęp tożsamości zarządzanej do zasobów BLOB.

Uzyskiwanie pomocy

Jeśli potrzebujesz dodatkowej pomocy poza tym, co obejmuje ten przewodnik, skorzystaj z poniższych zasobów.

Ścieżki eskalacji

W przypadku problemów, które nie zostały omówione w tym przewodniku, wypróbuj następujące opcje:

• Pomoc techniczna platformy Azure: utwórz bilet pomocy technicznej na potrzeby problemów z wdrażaniem lub usługą.
• Microsoft Docs: zapoznaj się z oficjalną dokumentacją dotyczącą aktualizacji.
• Stan platformy Azure: monitoruj stronę Stan platformy Azure pod kątem awarii usług.

Treści powiązane

• Ogólne często zadawane pytania
• Często zadawane pytania dotyczące zabezpieczeń i zgodności
• Role i uprawnienia
• Tryby uruchamiania agenta