Die Besitzrechte für verwaiste Agenten mit der Power Platform API neu zuweisen

Copilot Studio bietet Administratoren robuste Werkzeuge zur Verwaltung der Bot-Sicherheit und -compliance, einschließlich der Möglichkeit, das Eigentum an verwaisten Agenten über die Power Platform API neu zuzuweisen.

Die Übertragung der Eigentümerschaft verwaisten Agenten ist Teil des umfassenderen Sicherheitsrahmens von Copilot Studio und steht im Einklang mit Ihrem Gesamtsicherheitsansatz in Copilot Studio.

Wenn zum Beispiel der ursprüngliche Eigentümer eines Agenten die Organisation verlässt oder die Rolle wechselt, kann dies zu verwaisten Agenten führen, die keine angemessene Verwaltung haben. Diese Situation kann Geschäftsprozesse stören und Sicherheitsrisiken schaffen, da möglicherweise keine verantwortliche Person für die Einstellungen und Compliance-Anforderungen des Agenten zuständig ist. Administratoren können die Reassign-API nutzen, um das Eigentum dieser verwaisten Agenten neu zuzuweisen, damit sie ordnungsgemäß verwaltet und konform bleiben.

Agent-Nutzer und -Entwickler in Copilot Studio können Agenten sehen, die neu zugewiesen werden. Der neue Besitzer erhält Berechtigungen zum Environment Maker für die Umgebung des Bots. Der ehemalige Eigentümer verliert nach der Versetzung den Zugang zum Agenten.

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 Benutzerzugangstoken erhalten, das von Microsoft Entra ID OAuth2 ausgestellt wird. Informationen zum Abrufen eines Tokens finden Sie unter Authentifizierung.
    • Um den Besitzer eines in Copilot Studio erstellten Agents neu zuzuweisen, muss der dem Token zugeordnete Benutzer über eine der folgenden Administratorrollen verfügen:
      • Für globale Mandantenadministration zuständige Person
      • KI-Administrator
      • Power Platform-Administrator
      • Umgebungsadministrator
    • Um den Besitzer eines in Agent Builder erstellten Agenten neu zuzuweisen, muss der mit dem Token verknüpfte Benutzer 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.
  • Sie haben die Entra-Benutzer-ID des neuen Eigentümers, dem das Agenteneigentum zuzuweisen ist.
  • Der neue Eigentümer muss dem Mieter gehören.

API-Vorgänge zur Neuzuweisung der Eigentümerschaft eines Agenten

Copilot Studio unterstützt die REST-API-Funktion reassign zur Umzuweisung verwaister Agenten an neue Besitzer als Teil der Power Platform API.

Hinweis

Die Reassign-API unterstützt keine klassischen Chatbots. Die API gibt 405 Method Not Allowed zurück, wenn Sie versuchen, die Inhaberschaft eines klassischen Chatbots neu zuzuweisen.

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

Die Eigentümerschaft eines Agenten an einen neuen Eigentümer umzuweisen

  • Endpunkt:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations/reassign?api-version=1

  • Haupttext: {"NewOwnerAadUserId": "EntraUserId"}

    Ersetze EntraUserId sie durch die Entra-Benutzer-ID des neuen Eigentümers.

  • Zweck: Wechsel des Eigentümers des Maklers

  • Antwort: Kein Inhalt

  • Last updated on