Power Platform API'siyle uyumlu olmayan aracıları karantinaya alma

Copilot Studio, yöneticilere aracı güvenliği ve uyumluluğunu yönetmek için sağlam araçlar sağlar; bu araçlar arasında Power Platform API aracılığıyla aracılar için karantina eylemleri de bulunur.

Aracıları karantinaya alma, 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, veri politikalarını ihlal eden veya uyumluluk dokümantasyonundan yoksun olan aracılar, denetimlerin, çalışma zamanı korumasının veya diğer yönetim raporlarının veya bildirimlerinin bir parçası olarak işaretlenebilir. Yöneticiler daha sonra güvenlik ve uyumluluk sorunlarını araştırıp giderirken uyumsuz aracıları ayırmak için API'leri karantinaya alma işlemini kullanabilir.

Karantinaya alınan aracılar, Copilot Studio'da aracı kullanıcıları ve oluşturucuları tarafından hala görülebilir, ancak aracıla etkileşim kurmak veya aracıyı kullanmak mümkün değildir.

Ö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.
    • Token'la 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ı karantina yönetimi için API işlemleri

Copilot Studio, Power Platform API'sinin bir parçası olarak aracı karantinasını yönetmek için üç temel REST API işlemini destekler.

Not

SetAsQuarantined ve SetAsUnquarantined API'leri klasik sohbet botlarını desteklemez. API, klasik bir sohbet botunu karantinaya almaya veya karantinadan çıkarmaya çalıştığınızda 405 Method Not Allowed kodunu 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ı karantina durumunu alma

  • Uç nokta: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Amaç: Bir aracının geçerli karantina durumunu almak
  • Yanıt: Bir boolean isBotQuarantined ve lastUpdateTimeUtc değerlerini döndürür

Detaylı bilgi için Bot Karantina Durumu API referans dokümanı'na bakın.

Aracıyı karantinaya alınmış olarak ayarlama

  • Uç nokta: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Amaç: Bir aracıyı karantinaya alınmış olarak işaretleyerek kullanılabilirliğini ve etkileşimlerini kısıtlamak
  • Yanıt: Karantina durumu güncelleştirmesi onaylanır

Detaylı bilgi için Set Bot As Quarantined API referans dokümanı.

Aracıyı karantinadan çıkarılmış olarak ayarlama

  • Uç nokta: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Amaç: Risk değerlendirmesi ve düzeltmeden sonra bir aracıyı karantinadan kaldırmak
  • Yanıt: Karantina durumu güncelleştirmesi onaylanır

Detaylı bilgi için Set Bot As Unquarantined API referans dokümantasyonu.

  • Last updated on