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

Microsoft Copilot Studio bietet Administratoren robuste Tools zum Verwalten von Bot-Sicherheit und -Compliance, einschließlich Quarantäneaktionen für Agents über die Power Platform-API.

Die Quarantäne von Agents ist Teil des umfassenden Sicherheitsframeworks von Copilot Studio und arbeitet in Verbindung mit Ihrem allgemeinen Sicherheitsansatz in Copilot Studio.

Beispielsweise können Bots, die gegen Richtlinien zur Verhinderung von Datenverlusten (DLP) verstoßen oder über keine Dokumentation für Konformität verfügen, im Rahmen von Audits, Laufzeitschutz oder anderen Administratorberichten 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 wurden, sind weiterhin für Agent-Benutzer (und Agent-Maker in Copilot Studio) sichtbar, aber sie können nicht mit dem Agent interagieren oder verwenden.

Wichtig

Der ältere powervirtualgents Namespace ist veraltet und wird bis Ende 2025 entfernt. Verwenden Sie den copilotstudio Namespace in Ihren API-Aufrufen, wie in diesem Artikel aufgeführt.

Voraussetzungen

• Sie müssen ein Power Platform-Mandantenadministrator oder ein Power Platform-Administrator oder Dynamics 365-Dienstadministrator sein.
• Sie verfügen über die Bot-ID und die Umgebungs-ID für den Ziel-Agent.
• Sie verfügen über Authentifizierungstoken für den Dienst oder Benutzer, der die API verwendet.
• Sie werden über die Microsoft Entra ID OAuth2 authentifiziert, wobei der implizite Flow in der Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com verwendet wird.

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.

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

• Power Platform-API und SDKs: Von UX-first bis API-first (Blog) (Power Platform Developer Blog)
• Übersicht über die Programmierbarkeit und Erweiterbarkeit (Dokumentation zur Power Platform)
• Erste Schritte mit der Power Platform-API (Vorschau) (Power Platform-Dokumentation)

In diesem Artikel werden die verfügbaren Vorgänge beschrieben, die auch in der Referenzdokumentation zur Power Platform-API definiert sind.

Wichtig

Der copilotstudio Namespace sollte für Copilot Studio-bezogene API-Vorgänge verwendet werden. Der ältere powervirtualgents Namespace ist veraltet und wird bis Ende 2025 entfernt.

Wenn Sie den powervirtualagents Namespace zuvor verwendet haben, aktualisieren Sie Ihre API-Aufrufe, um den copilotstudio Namespace zu verwenden, um die fortgesetzte Funktionalität sicherzustellen.

Agent-Quarantänestatus abrufen

• Endpunkt: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/GetBotQuarantineStatus?api-version=1.
• Zweck: Abrufen des aktuellen Quarantänestatus eines Agents.
• Antwort: Gibt einen booleschen isBotQuarantined und lastUpdateTimeUtc zurück.

Die Anforderungen an die Parameter und die Antwortcodes entnehmen Sie der API-Referenzdokumentation zum Quarantänestatus.

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: Markieren Sie einen Agent als in Quarantäne und schränken Sie seine Verfügbarkeit und Interaktionen ein.
• Antwort: Bestätigt die Aktualisierung des Quarantänestatus.

Die Anforderungen an die Parameter und die Antwortcodes entnehmen Sie der API-Referenzdokumentation zur Quarantäne von Agents.

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: Entfernen Sie einen Agent nach der Risikobewertung und Behebung aus der Quarantäne.
• Antwort: Bestätigt die Aktualisierung des Quarantänestatus.

Bitte beachten Sie die API-Referenzdokumentation zum Aufheben der Quarantäne von Agents für Parameteranforderungen und Antwortcodes.