Eigentum verwaister Agents mit der Power Platform-API neu zuweisen

Microsoft Copilot Studio bietet Administratoren mit zuverlässige Tools zur Verwaltung der Bot-Sicherheit und Compliance, einschließlich der Möglichkeit, Agents über die Power Platform-API zu löschen.

Die Neuzuweisung des Besitzes an verwaisten Agents ist Teil des umfassenden Sicherheitsframeworks von Copilot Studio und agiert in Verbindung mit Ihrem allgemeinen Sicherheitsansatz in Copilot Studio.

Zum Beispiel kann es zu verwaisten Agenten kommen, denen eine angemessene Verwaltung fehlt, wenn der ursprüngliche Eigentümer die Organisation verlässt oder die Rolle wechselt. 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 API Neuzuweisung verwenden, um das Eigentum an diesen verwaisten Agenten neu zuzuweisen, damit sie weiterhin ordnungsgemäß verwaltet werden und den Compliance-Anforderungen entsprechen.

Agent-Benutzer und -Erstellende in Copilot Studio können Agents anzeigen, die neu zugewiesen sind. Der neue Eigentümer erhält Umgebungsersteller-Berechtigungen für die Umgebung des Agenten. Der ehemalige Eigentümer verliert nach der Neuzuweisung den Zugang zum Agenten. Nach der Übertragung des Eigentums eines Agenten kann der neue Inhaber, wenn er das Recht hat, das Transkript lesen, er kann auf alle bestehenden Transkripte des Agenten zugreifen.

Wichtig

Die powervirtualgents Namespace ist veraltet. Verwenden Sie den copilotstudio-Namespace in Ihren API-Aufrufen.

Voraussetzungen

  • Sie verfügen über die Bot-ID und die Umgebungs-ID für den Ziel-Agent.
  • Sie müssen ein Benutzerzugangstoken beziehen, das von Microsoft Entra ID OAuth2 ausgestellt wird. Um ein Token zu erhalten, siehe Authentication.
    • Um den Besitzer eines in Copilot Studio erstellten Agents neu zuzuweisen, muss der mit dem Token verbundene Benutzer eine der folgenden Admin-Rollen haben:
      • Für globale Mandantenadministration zuständige Person
      • KI Administrator
      • Power Platform Administrator
      • Umgebungsadministrierender
    • Um den Besitzer eines in Agent Builder erstellten Agents neu zuzuweisen, muss der mit dem Token verbundene Benutzer eine der folgenden Admin-Rollen haben:
      • Für globale Mandantenadministration zuständige Person
      • KI Administrator
      • Power Platform Administrator
    • Sie müssen das Zugriffstoken mithilfe der Client-ID einer App-Registrierung abrufen, die über den Bereich CopilotStudio.AdminActions.Invoke verfügt, der unter der Power Platform-API gewährt wird.
  • Sie haben die Entra-Benutzer-ID des neuen Eigentümers, dem der Agentenbesitz zugewiesen werden muss.
  • Der neue Eigentümer muss zum Mandanten gehören.

API-Operationen zur Neuzuweisung des Agentbesitzes

Copilot Studio unterstützt den REST-API-Vorgang reassign zum Neuzuweisen verwaister Agents an neue Besitzende als Teil der Power Platform-API.

Anmerkung

Die API Neuzuweisung unterstützt keine klassischen Chatbots. Die API gibt 405 Method Not Allowed zurück, wenn versucht wird, den Besitz eines klassischen Chatbots neu zuzuweisen.

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

Agent-Besitz einem neuen Besitzenden neu zuweisen

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

  • Text: {"NewOwnerAadUserId": "EntraUserId"}

    EntraUserId durch die Entra User ID des neuen Eigentümers ersetzen.

  • Zweck: Wechsel des Agentbesitzes

  • Antwort: Kein Inhalt

  • Last updated on