Izoluj agentów, którzy są niezgodni, korzystając z interfejsu API platformy Power Platform.

Copilot Studio udostępnia administratorom solidne narzędzia do zarządzania zabezpieczeniami i zgodnością agentów, w tym działania kwarantanny dla agentów za pośrednictwem API Power Platform.

Agenci przeprowadzający kwarantannę są częścią szerszej struktury zabezpieczeń Copilot Studio i działa razem z ogólnym podejściem do zabezpieczeń w Copilot Studio.

Na przykład agenci, którzy naruszają polityki danych lub nie mają dokumentacji zgodności , mogą być oznaczoni jako część audytów, ochrony w czasie działania lub innych raportów czy powiadomień administratorów. Administratorzy mogą następnie użyć interfejsów API kwarantanny w celu izolowania agentów niespełniających wymagań podczas badania i korygowania problemów z zabezpieczeniami oraz zgodnością.

Agenci, którzy są objęci kwarantanną, są nadal widoczni dla użytkowników i twórców agentów w programie Copilot Studio, ale nie można z nim wchodzić w interakcję ani go używać.

Ważne

Przestrzeń nazw powervirtualgents jest odradzana. Używaj copilotstudio przestrzeni nazw w wywołaniach API.

Wymagania wstępne

• Masz identyfikator bota i identyfikator środowiska dla agenta docelowego.
• Należy uzyskać token dostępu użytkownika wystawiony przez Microsoft Entra ID OAuth2. Aby uzyskać token, zobacz Uwierzytelnianie.
  • Użytkownik powiązany z tokenem musi pełnić jedną z następujących ról administratora:
    • Administrator dzierżawy globalnej
    • Administrator sztucznej inteligencji
    • Administrator Power Platform
  • Musisz pozyskać token dostępu, używając identyfikatora klienta aplikacji zarejestrowanej, która posiada zakres CopilotStudio.AdminActions.Invoke przyznany przez interfejs API Power Platform.

Operacje API do zarządzania kwarantanną agenta

Copilot Studio obsługuje trzy kluczowe operacje REST API do zarządzania kwarantanną agenta w ramach Power Platform API.

Uwaga / Notatka

Interfejsy API SetAsQuarantined i SetAsUnquarantined nie obsługują klasycznych czatbotów. Interfejs API zwraca 405 Method Not Allowed, gdy próbujesz poddać kwarantannie lub wyjąć z niej klasycznego czatbota.

Aby uzyskać więcej informacji na temat, jak i kiedy korzystać z interfejsu API platformy Power Platform, zobacz:

• Interfejs API i zestawy SDK platformy Power Platform: od podejścia „UX-first” do „API-first” (blog) (blog programistów platformy Power Platform)
• Omówienie możliwości programowania i rozszerzalności (dokumentacja platformy Power Platform)
• Rozpocznij korzystanie z Power Platform API (dokumentacja Power Platform)
• Dokumentacja referencyjna dotycząca operacji API Power Platform

Pobierz stan kwarantanny agenta

• Punkt końcowy:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
• Cel: Odzyskanie aktualnego statusu kwarantanny agenta
• Odpowiedź: Zwraca wartość logiczną isBotQuarantined i lastUpdateTimeUtc

Dowiedz się więcej w dokumentacji referencyjnej API dotyczącej pobieraniu stanu kwarantanny bota.

Ustaw agenta jako poddanego kwarantannie

• Punkt końcowy:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
• Cel: Oznaczenie agenta jako poddanego kwarantannie, ograniczając jego dostępność i interakcje
• Odpowiedź: Potwierdza aktualizację statusu kwarantanny

Dowiedz się więcej w dokumentacji referencyjnej API Set Bot As Quarantined.

Ustaw agenta jako niepoddany kwarantannie

• Punkt końcowy:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
• Cel: Usunięcie czynnika z kwarantanny po ocenie ryzyka i jego naprawie
• Odpowiedź: Potwierdza aktualizację statusu kwarantanny

Dowiedz się więcej w dokumentacji referencyjnej interfejsu API dotyczącej ustawiania bota jako niepodlegającego kwarantannie.