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

Copilot Studio, Power Platform API aracılığıyla ajanlar için karantina eylemleri de dahil olmak üzere yöneticilere ajan güvenliği ve uyumunu yönetmek için güçlü araçlar sunar.

Ajanları karantinaya almak, 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 paralel olarak çalışır.

Örneğin, veri politikalarını ihlal eden veya uyum dokümantasyonu olmayan ajanlar, denetimler, çalışma zamanı koruması veya diğer yönetici raporları veya bildirimleri kapsamında işaretlenebilir. Yöneticiler daha sonra güvenlik ve uyumluluk sorunlarını araştırıp giderirken uyumsuz aracıları yalıtmak için karantina API'lerini kullanabilir.

Karantinada olan ajanlar Copilot Studio'da ajan kullanıcıları ve üreticiler tarafından hâlâ görünür, ancak ajanla etkileşime girmek veya kullanmak mümkün değil.

Important

İsim powervirtualgents alanı kullanımdan kaldırılmıştır. API çağrılarınızda isim copilotstudio alanını kullanın.

Önkoş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 tokenı edinmeniz gerekir. 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:
      • Genel kiracı yöneticisi
      • Yapay zeka yöneticisi
      • Power Platform yöneticisi
    • Erişim tokenını, Power Platform API'si altında tanımlı CopilotStudio.AdminActions.Invoke kapsamına sahip bir uygulama kaydının istemci kimliğini kullanarak edinmelisiniz.

Ajan 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.

Note

SetAsQuarantined ve SetAsUnquarantined API'leri klasik sohbet botlarını desteklemez. Klasik bir sohbet botunu karantinaya almaya veya karantinadan çıkarmaya çalıştığınızda API 405 Method Not Allowed döndürüyor.

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

Aracı karantina durumunu alma

  • Endpoint:GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Amaç: Bir ajanın mevcut karantina durumunu geri almak
  • Yanıt: Bir boolean isBotQuarantined döndürür ve lastUpdateTimeUtc

Daha fazla bilgi için Get Bot Quarantine Status API reference documentation bölümüne bakın.

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

  • Endpoint:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Amaç: Bir ajanı karantinada olarak işaretlemek, erişilebilirliğini ve etkileşimlerini kısıtlamak
  • Yanıt: Karantina durum güncellemesini doğruladı

Daha fazla bilgi edin: Set Bot As Quarantined API referans dokümantasyonu.

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

  • Endpoint:POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Amaç: Risk değerlendirmesi ve iyileştirme sonrası bir ajanı karantinadan çıkarmak
  • Yanıt: Karantina durum güncellemesini doğruladı

Daha fazla bilgi için Set Bot As Unquarantined API referans dokümantasyonu.

  • Last updated on