Freigeben über

Quarantäne von mit der Power Platform-API nicht kompatiblen Agents

Copilot Studio bietet Administratoren robuste Werkzeuge zum Verwalten der Agentensicherheit und -compliance, einschließlich Quarantäneaktionen für Agenten über die Power Platform API.

Quarantäne-Agenten sind Teil des umfassenderen Sicherheitsframeworks von Copilot Studio und arbeiten in Kombination mit Ihrem allgemeinen Sicherheitsansatz in Copilot Studio.

Zum Beispiel können Agenten, die gegen Datenrichtlinien verstoßen oder keine Compliance-Dokumentation haben, im Rahmen von Audits, Laufzeitschutz oder anderen Admin-Berichten oder -benachrichtigungen markiert werden. Administratoren können dann die Quarantäne-APIs verwenden, um die nicht kompatiblen Agents beim Untersuchen und Beheben von Sicherheits- und Complianceproblemen zu isolieren.

Agents, die unter Quarantäne gestellt werden, sind für Agentbenutzer und -hersteller in Copilot Studio weiterhin sichtbar, aber es ist nicht möglich, mit dem Agent zu interagieren oder zu verwenden.

Wichtig

Der Namensraum powervirtualgents ist veraltet. Nutze den copilotstudio Namespace in deinen API-Aufrufen.

Voraussetzungen

  • Sie verfügen über die Bot-ID und die Umgebungs-ID für den Ziel-Agent.
  • Sie müssen ein Benutzerzugriffstoken abrufen, das von Microsoft Entra ID OAuth2 ausgestellt wurde. Informationen zum Abrufen eines Tokens finden Sie unter Authentifizierung.
    • Der Benutzer, der mit dem Token verknüpft ist, muss eine der folgenden Admin-Rollen haben:
      • Für globale Mandantenadministration zuständige Person
      • KI-Administrator
      • Power Platform Administrator
    • Sie müssen das Zugriffstoken mit der Client-ID einer App-Registrierung erhalten, die den CopilotStudio.AdminActions.Invoke-Bereich enthält, der unter der Power Platform API gewährt wurde.

API-Vorgänge für die Agentquarantäneverwaltung

Copilot Studio unterstützt drei wichtige REST-API-Vorgänge für die Verwaltung der Agentquarantäne im Rahmen der Power Platform-API.

Hinweis

Die SetAsQuarantined - und SetAsUnquarantined-APIs unterstützen keine klassischen Chatbots. Die API gibt zurück 405 Method Not Allowed , wenn Sie versuchen, einen klassischen Chatbot unter Quarantäne zu stellen oder zu entquarantinieren.

Weitere Informationen darüber, wie und wann Sie die Power Platform-API verwenden können, finden Sie unter:

Agent-Quarantänestatus abrufen

  • Endpunkt:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Zweck: Den aktuellen Quarantänestatus eines Agenten abrufen
  • Antwort: Gibt ein Boolean isBotQuarantined zurück und lastUpdateTimeUtc

Erfahren Sie mehr in der Referenzdokumentation der Get Bot Quarantine Status API.

Agent als unter Quarantäne gestellt markieren

  • Endpunkt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Zweck: Einen Agenten als unter Quarantäne setzen, wodurch seine Verfügbarkeit und Interaktionen eingeschränkt werden
  • Antwort: Bestätigt Aktualisierung des Quarantänestatus

Erfahren Sie mehr in der Referenzdokumentation der Set Bot As Quarantined API.

Agent als nicht unter Quarantäne gestellt kennzeichnen

  • Endpunkt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Zweck: Entfernung eines Erregers aus der Quarantäne nach Risikobewertung und Sanierung
  • Antwort: Bestätigt Aktualisierung des Quarantänestatus

Mehr erfahren Sie in der Referenzdokumentation der Set Bot As Unquarantined API.

  • Last updated on