Kwarantanna niezgodnych agentów przy użyciu interfejsu API platformy Power Platform

Program Microsoft Copilot Studio udostępnia administratorom niezawodne narzędzia do zarządzania zabezpieczeniami i zgodnością botów, w tym możliwość akcji kwarantanny dla agentów za pośrednictwem interfejsu API platformy Power Platform.

Kwarantanna agentów jest częścią szerszej struktury zabezpieczeń Copilot Studio i wiąże się z ogólnym podejściem do zabezpieczeń w Copilot Studio.

Na przykład agenty naruszające zasady ochrony przed utratą danych (DLP) lub dokumentację zgodności mogą być oflagowane w ramach inspekcji, ochrony środowiska uruchomieniowego lub innych raportów lub powiadomień administratora. Administratorzy mogą następnie użyć kwarantanny API, aby izolować niezgodnych agentów podczas badania i korygowania problemów z zabezpieczeniami i zgodnością.

Użytkownicy agentów i twórcy w Copilot Studio mogą widzieć agentów, którzy zotali poddani kwarantannie. Twórcy mogą wchodzić w interakcje z agentami podczas testów, ale nie mogą wchodzić w interakcje z agentami w kwarantannie w żadnym innym kanale.

Ważne

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

Wymagania wstępne

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

Operacje interfejsu API na potrzeby zarządzania kwarantanną agenta

Narzędzie Copilot Studio obsługuje trzy kluczowe operacje interfejsu API REST do zarządzania kwarantanną agenta za pomocą interfejsu API platformy Power Platform.

Notatka

SetAsQuarantined i SetAsUnquarantined API nie obsługują klasycznych czatbotów. Interfejs API zwraca błąd 405 Method Not Allowed gdy próbujesz poddać kwarantannie lub usunąć z kwarantanny klasycznego czatbota.

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

Pobierz stan kwarantanny agenta

  • Punkt końcowy: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Cel: pobieranie bieżącego stanu 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ę stanu kwarantanny

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

Ustaw agenta jako usuniętego z kwarantanny

  • Punkt końcowy: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Cel: usuwanie agenta z kwarantanny po ocenie ryzyka i korygowaniu
  • Odpowiedź: potwierdza aktualizację stanu kwarantanny

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

  • Last updated on