Śledzenie i obsługa danych

Śledzenie w usłudze Foundry to funkcja obserwowalności w Microsoft Foundry, która przechwytuje Dane klienta od agentów SI. Pomaga to deweloperom i operatorom zrozumieć zachowanie systemu, debugować problemy i zoptymalizować wydajność.

Śledzenie rekordów rejestruje informacje, takie jak:

  • Wpisy i monity użytkownika
  • Dane wejściowe i wyjściowe agenta i modelu
  • Wywołania narzędzi i kroki pośrednie
  • Metadane wykonywania (znaczniki czasu, opóźnienie, użycie tokenu, błędy itp.)

Te dane mogą obejmować zawartość wygenerowaną przez użytkownika i dane telemetryczne operacyjne.

Te dane służą do zapewniania wglądu w sposób działania agentów, umożliwiając rozwiązywanie problemów i ulepszenia wydajności w przepływach pracy agenta. Usługa Foundry używa standardów OpenTelemetry i przechowuje dane śledzenia w połączonych systemach telemetrycznych Azure Monitor Application Insights.

Important

Po włączeniu usługi AppInsights dla projektu AppInsights rejestruje ślady, aby ułatwić monitorowanie i ocenę interakcji z agentami na poziomie użytkownika. Członkowie projektu z rolą Czytelnik Log Analytics w usłudze AppInsights mogą wyświetlać dane śledzenia, które mogą zawierać dane osobowe i zawartość klientów. Jeśli podstawowe tabele Log Analytics są chronione (ich poziom ochrony jest ustawiony na Chroniony), członkowie muszą mieć rolę Czytelnik danych monitorowania uprzywilejowanego, aby wyświetlić te dane śledzenia. Sprawdź, jakie dane śledzenia są zbierane i kto może wyświetlać i używać tych danych. Więcej informacji znajduje się w poniższej sekcji.

Stan domyślny:

  • Śledzenie jest domyślnie wyłączone.
  • Żadne dane śledzenia nie są zbierane ani przechowywane, chyba że jawnie włączone przez właściciela konta usługi Foundry lub właściciela usługi Foundry.

Dodatkowe opłaty za usługę App Insights w Azure Monitor mogą obowiązywać.

Dzięki temu klienci zachowają kontrolę nad rozpoczęciem zbierania danych.

Włącz śledzenie

Śledzenie jest włączone, gdy projekt jest połączony z zasobem usługi Azure Monitor Application Insights. Typowe przepływy włączania obejmują:

  • Tworzenie lub łączenie zasobu usługi Application Insights podczas tworzenia projektu.
  • Tworzenie lub łączenie zasobu usługi Application Insights z istniejącym projektem bez połączonego zasobu usługi Application Insights.

Po włączeniu śledzenia:

  • Dane śledzenia zaczynają być zbierane i przechowywane dla wszystkich agentów w projekcie.
  • Aby wyświetlić ślady w interfejsie użytkownika śledzenia usługi Foundry, użytkownicy muszą mieć dostęp do projektu Foundry i uprawnienia do odczytu w połączonym obszarze roboczym usługi Application Insights lub Log Analytics. Na przykład role takie jak Log Analytics Reader, Monitoring Reader lub Reader przypisane do zasobu usługi Application Insights, obszaru roboczego usługi Log Analytics lub odpowiedniego zakresu nadrzędnego mogą przyznawać ten dostęp. Jeśli bazowe tabele Log Analytics są chronione, przypisani użytkownicy muszą również mieć rolę Czytelnik uprzywilejowanych danych monitorowania, aby odczytywać te dane.

Wyłącz śledzenie

Wyłącz śledzenie w następujący sposób:

  • Odłączanie lub usuwanie zasobu usługi Application Insights.

Po wyłączeniu śledzenia:

  • W tym projekcie na agentach nie są zbierane żadne nowe dane śledzenia.
  • Wcześniej zebrane dane podlegają zasadom przechowywania usługi Application Insights.

Note

Dokładne kroki dotyczące wyłączania śledzenia zależą od interfejsu użytkownika lub powierzchni zestawu SDK i powinny być zgodne z dokumentacją produktu.

Miejsce przechowywania danych

Zagadnienia dotyczące udostępniania danych

  • Dane śledzenia mogą być dostępne dla użytkowników z odpowiednimi uprawnieniami do połączonego zasobu telemetrii.
  • W zależności od konfiguracji użytkownicy należący do tego samego projektu lub dzierżawcy mogą widzieć dane.
  • Aby wyświetlić ślady w interfejsie użytkownika śledzenia usługi Foundry, użytkownicy muszą mieć dostęp do projektu Foundry i uprawnienia do odczytu w połączonym obszarze roboczym usługi Application Insights lub Log Analytics. Na przykład role takie jak Log Analytics Reader, Monitoring Reader lub Reader dla zasobu Application Insights, obszaru roboczego Log Analytics lub odpowiedniego zakresu nadrzędnego mogą przyznawać ten dostęp. Jeśli bazowe tabele usługi Log Analytics są chronione, osoby przypisane muszą również mieć rolę Privileged Monitoring Data Reader, aby móc odczytywać te dane.
  • Aby uzyskać dodatkowe informacje i ważne kwestie dotyczące hostowanych agentów, zapoznaj się z informacjami o hostowanych agentach oraz o zmiennych środowiskowych wstrzykiwanych przez platformę dla hostowanego agenta.

Klienci są odpowiedzialni za konfigurowanie kontroli dostępu i zapewnianie zgodności z zasadami organizacji.

Prywatność

Śledzenie może przechwytywać dane osobowe, w tym:

  • Polecenia i odpowiedzi użytkownika
  • Zawartość specyficzna dla aplikacji

Najlepsze rozwiązania

  • Unikaj rejestrowania wpisów tajnych, poświadczeń lub tokenów.
  • Zredaguj lub zminimalizuj dane osobowe przed ich zarejestrowaniem.
  • Stosowanie kontroli dostępu i zasad przechowywania w celu śledzenia danych.

Mechanizmy kontroli ochrony danych

  • Maskowanie danych osobowych: Maskuj dane osobowe, takie jak adresy e-mail i numery telefonów.
  • Ogranicz dostęp do danych śledzenia, dokładnie kontrolując, którym użytkownikom jest przypisywana rola RBAC Log Analytics Reader. Gdy bazowe tabele usługi Log Analytics są chronione, zarządzaj również tym, kto ma rolę Privileged Monitoring Data Reader, ponieważ przyznaje ona dostęp do odczytu chronionych tabel.
  • Konfigurowalne zasady: określ, jakie dane są przechwytywane i widoczne.

Te mechanizmy kontroli pomagają zarządzać ryzykiem i spełniać wymagania dotyczące prywatności.

Obowiązki klienta

Po włączeniu śledzenia odpowiadasz za:

  • Informowanie użytkowników końcowych o zbieraniu danych, w tym o typach zbieranych danych, celu, widoczności, ich opcjach i innych informacjach potrzebnych do dokonania rozsądnych wyborów (jeśli ma to zastosowanie).
  • Zapewnienie zgodności z wymaganiami dotyczącymi prywatności, praw i przepisów prawnych.
  • Konfigurowanie odpowiednich mechanizmów kontroli dostępu i zasad przechowywania danych.

Podsumowanie

Foundry Tracing to zaawansowana funkcja obserwowalności, która umożliwia debugowanie, monitorowanie i optymalizację agentów AI. To jest:

  • Domyślnie wyłączone.
  • Jawnie włączone przez łączenie zasobów telemetrii.
  • Zaprojektowana z kontrolą klienta nad zbieraniem i obsługą danych.

Treści powiązane

  • Ostatnia aktualizacja o