Programowe usuwanie agentów przy użyciu interfejsu API platformy Power Platform

Copilot Studio udostępnia administratorom solidne narzędzia do zarządzania zabezpieczeniami i zgodnością agentów, w tym możliwość usuwania agentów za pośrednictwem interfejsu API platformy Power Platform.

Usuwanie agentów jest częścią szerszej struktury zabezpieczeń Copilot Studio i działa razem z ogólnym podejściem do zabezpieczeń w Copilot Studio.

Na przykład inspekcje, ochrona środowiska uruchomieniowego i inne raporty lub powiadomienia administratora mogą oznaczać agentów naruszających wymagania organizacji dotyczące zabezpieczeń i uwierzytelniania. Administratorzy mogą użyć delete operacji , aby usunąć niezgodnych agentów podczas badania i korygowania problemów z zabezpieczeniami i zgodnością.

Usunięcie agentów powoduje usunięcie ich ze środowiska. Twórcy i poprzedni użytkownicy nie mogą ich już zobaczyć.

Usunięcie agenta, który ma Identyfikator agenta Microsoft Entra, powoduje usunięcie skojarzonego identyfikatora agenta (lub rejestracji aplikacji dla starszych agentów) z systemu Microsoft Entra ID. Dowiedz się więcej w Automatycznie tworz identyfikatory agentów Microsoft Entra.

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 globalny dzierżawy
    • Administrator sztucznej inteligencji
    • 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 usuwania agenta

Copilot Studio, jako część Power Platform API, obsługuje operację API REST na potrzeby usuwania agentów.

Aby uzyskać więcej informacji o sposobie i czasie korzystania z interfejsu API Power Platform, odwiedź:

• 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

Usuwanie agenta

• Punkt końcowy:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Cel: Trwałe usunięcie agenta
• Odpowiedź: Zwraca 204 OK jeśli agent został pomyślnie usunięty

Dowiedz się więcej w dokumentacji referencyjnej Delete Copilot Agent API.