Sahipsiz kalan aracıların sahipliğini Power Platform API ile yeniden atayın

Copilot Studio, yöneticilere aracı güvenliğini ve uyumluluğunu yönetmek için sağlam araçlar sağlar; bu araçlar arasında Power Platform API aracılığıyla yetim kalmış aracıların sahipliğini yeniden atama yeteneği de bulunur.

Üst öğesiz aracıların sahipliğini yeniden atama işlevi, Copilot Studio'nun daha geniş güvenlik çerçevesinin bir parçasıdır ve Copilot Studio'daki genel güvenlik yaklaşımınızla birbirine bağlı olarak çalışır.

Örneğin, bir aracının ilk sahibi organizasyondan ayrıldığında veya rol değiştirdiğinde, uygun şekilde yönetilmeyen sahipsiz aracılara yol açabilir. Bu durum, iş süreçlerini bozabilir ve güvenlik riskleri oluşturabilir; çünkü aracının ayarlarını ve uyum gereksinimlerini yönetecek bir yönetici olmayabilir. Yöneticiler, bu yetim kalmış aracıların sahipliğini yeniden atamak için Reassign API'sini kullanabilir ve böylece aracıların doğru şekilde yönetilmesini ve uyumluluğunun sağlanmasını garanti edebilir.

Copilot Studio'daki aracı kullanıcıları ve oluşturucuları, yeniden atanan aracıları görebilir. Yeni sahip, aracının ortamında ortam oluşturucu izinlerine sahip olur. Yeniden atama sonrasında eski sahibi, aracıya erişim hakkını kaybeder. Bir aracının sahipliği yeniden atandıktan sonra, yeni sahibin Transkripti Okuma ayrıcalığı varsa aracının mevcut transkriptlerinin tümüne erişebilir.

Önemli

powervirtualgents isim alanı devre dışı bırakılmıştır. API isteklerinizde copilotstudio isim alanını kullanın.

Ön koşullar

  • Hedef aracı için Bot Kimliği ve Ortam Kimliğine sahipsiniz.
  • Microsoft Entra ID OAuth2 tarafından verilen bir kullanıcı erişim belirteci edinmeniz gerekir. Bir belirteç almak için bkz. Kimlik Doğrulama.
    • Copilot Studio'da oluşturulan bir aracının sahipliğini yeniden atamak için, tokenla ilişkili kullanıcının aşağıdaki yönetici rollerinden birine sahip olması gerekir:
      • Global kiracı yöneticisi
      • AI yöneticisi
      • Power Platform yöneticisi
      • Ortam yöneticisi
    • Agent Builder'da oluşturulan bir aracının sahibini yeniden atamak için, tokenla ilişkilendirilen kullanıcının aşağıdaki yönetici rollerinden birine sahip olması gerekir:
      • Global kiracı yöneticisi
      • AI yöneticisi
      • Power Platform yöneticisi
    • Power Platform API'si kapsamında atanmış CopilotStudio.AdminActions.Invoke kapsamına sahip bir uygulama kaydının istemci kimliğini kullanarak erişim belirtecini almanız gerekir.
  • Aracı sahipliğinin yeniden atanması gereken yeni sahibin Entra Kullanıcı ID'sine sahipsiniz.
  • Yeni sahip kiracıya bağlı olmalıdır.

Aracı sahipliğini yeniden atamak için API işlemleri

Copilot Studio, Power Platform API'sinin bir parçası olarak, yetim kalmış aracıları yeni sahiplerine yeniden atamak için REST API reassign işlemini destekler.

Not

Reassign API klasik sohbet botlarını desteklemez. API, klasik bir sohbet botunun sahipliğini yeniden atamaya çalıştığınızda 405 Method Not Allowed döndürür.

Power Platform API'sinin nasıl ve ne zaman kullanılacağı hakkında daha fazla bilgi için bakın:

Aracının sahipliğini yeni bir sahibine yeniden atayın

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

  • Gövde: {"NewOwnerAadUserId": "EntraUserId"}

    EntraUserId değerini yeni sahibin Entra kullanıcı kimliği ile değiştirin.

  • Amaç: Aracının sahibini değiştirmek

  • Yanıt: İçerik Yok

  • Last updated on