Włączanie obsługi usługi Application Insights w programie Copilot Studio

Włącz wsparcie Application Insights w Copilot Agent Kit, aby poprawić telemetrię, monitorować wydajność i diagnozować problemy. Postępuj zgodnie z instrukcjami krok po kroku, aby ustawić i skonfigurować usługę Application Insights dla Twojego środowiska.

wymagania wstępne

Utworzony zasób usługi Application Insights i agent skonfigurowany do wysyłania do niego danych telemetrycznych. Dowiedz się więcej w Connect your Copilot Studio copilot to Application Insights.

Rejestrowanie nowej aplikacji w portalu Azure

Aby umożliwić wsparcie Application Insights w Copilot Agent Kit, zarejestruj nową aplikację w Microsoft Azure Portal.

Uwaga / Notatka

Jeśli już utworzyłeś rejestrację aplikacji Copilot Agent Kit do uwierzytelniania użytkownika, możesz ponownie użyć tej aplikacji do wzbogacania wyników App Insights zamiast tworzyć nową. Jeśli tak jest, możesz przejść do kroku 3 po przejściu do istniejącej rejestracji aplikacji w portalu Azure.

  1. Zaloguj się do portalu Azure

  2. Zarejestruj nową aplikację i dodaj dla niej nowy klucz tajny klienta. Zanotuj tajny klucz, aby użyć go jako tajnego klucza usługi App Insights w konfiguracji agenta (w zależności od skonfigurowanej lokalizacji tajnego klucza usługi App Insights).

  3. Zwróć uwagę na identyfikatory katalogu (dzierżawy) i aplikacji (klienta) aplikacji, aby używać ich jako identyfikatora dzierżawy usługi App Insights i identyfikatora klienta usługi App Insights w konfiguracji agenta.

  4. Wybierz pozycję Wyświetl uprawnienia interfejsu API w obszarze Przegląd (lub przejdź do pozycji Zarządzanie uprawnieniami>interfejsu API na pasku bocznym).

  5. Wybierz Dodaj uprawnienie.

  6. Wybierz interfejsy API używane przez moją organizację i wyszukaj interfejs API Application Insights. Wybierz z listy pozycję Application Insights API.

  7. Wybierz pozycję Uprawnienia delegowane.

  8. Sprawdź pozycję Data.Read i kontynuuj dodawanie uprawnień.

 Zrzut ekranu przedstawiający widok uprawnień interfejsu API w portalu Azure.

Zapewnianie dostępu do zasobu usługi Application Insights

Udziel zarejestrowanej aplikacji dostępu do zasobu usługi Application Insights:

  1. Przejdź do zasobu usługi Application Insights w portalu Azure.
  2. Wybierz Kontrola dostępu (IAM).
  3. Wybierz opcję Dodaj przypisanie roli.
  4. Wybierz pozycję Czytelnik z listy i wybierz pozycję Dalej.
  5. Wybierz Wybierz członków.
  6. Wyszukaj i wybierz swoją aplikację z listy. Zakończ, wybierając pozycję Wybierz.
  7. Wybierz pozycję Dalej , aby przejść do pozycji Przeglądanie i przypisywanie.
  8. Przejrzyj uprawnienia i wybierz pozycję Przejrzyj i przypisz w dolnej części ekranu.

Więcej informacji: Przypisywanie ról platformy Azure za pomocą portalu Azure

Lokalizowanie identyfikatora appid

Zanotuj identyfikator AppId zasobu usługi Application Insights, aby użyć go jako identyfikatora aplikacji usługi App Insights w konfiguracji agenta.

Aby uzyskać identyfikator AppId:

  1. Przejdź do zasobu usługi Application Insights ze strony Overview portalu Azure.

  2. Wybierz Widok JSON.

    Zrzut ekranu przedstawiający stronę Przegląd zasobu na platformie Microsoft Azure z wyróżnionym widokiem JSON w prawym górnym rogu.

  3. W wyświetlonym widoku JSON znajdź i zanotuj wartość w pliku properties.AppId. Ten sam identyfikator aplikacji można również znaleźć w sekcji Konfigurowanie>dostępu do interfejsu API.

    Zrzut ekranu przedstawiający ekran JSON zasobu na platformie Microsoft Azure z wyróżnioną właściwością AppId.