Power Platform API'sini kullanarak aracıları program aracılığıyla silme

Copilot Studio, yöneticilere Power Platform API aracılığıyla aracıları silme olanağı da dahil olmak üzere aracı güvenliği ve uyumluluğunu yönetmek için robust araçları sağlar.

Note

API delete işlemi yalnızca Agent Builder ajanlarını destekler.

Aracıları silmek, 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 uyum içinde çalışır.

Örneğin, denetimler, çalışma zamanı koruması ve diğer yönetici raporları veya bildirimleri, güvenlik ve kimlik doğrulaması için kuruluş gereksinimlerini ihlal eden aracıları işaretleyebilir. Yöneticiler, güvenlik ve uyumluluk sorunlarını araştırıp giderirken uyumsuz aracıları kaldırmak için bu işlemi kullanabilir delete .

Aracıları sildiğinizde, bunları ortamınızdan kaldırırsınız. Yapımcılar ve önceki kullanıcılar artık bunları göremiyor.

Microsoft Entra Aracı Kimliği'si olan bir aracı sildiğinizde, ilişkili Aracı Kimliği (veya eski aracılar için uygulama kaydı) da Microsoft Entra ID'den kaldırılır. Daha fazla bilgi için Otomatik Microsoft Entra Agent ID'lerini oluşturabilirsiniz.

Important

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

Prerequisites

• 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 belirtecini, Power Platform API'si altında verilen CopilotStudio.AdminActions.Invoke kapsamına sahip bir uygulama kaydının istemci kimliğini kullanarak almanız gerekir.

Aracı silme için API işlemleri

Copilot Studio, Power Platform API'sinin bir parçası olarak aracıları kaldırmak için REST API delete işlemini destekler.

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

• Power Platform API'si ve SDK'ları: UX öncelikliden API öncelikliye (Blog) (Power Platform Geliştirici Blogu)
• Programlanabilirlik ve genişletilebilirliğe genel bakış (Power Platform belgeleri)
• Power Platform API ile Başlayın (Power Platform belgeleri)
• Power Platform API işlem referans dokümantasyonu

Aracıyı sil

• Endpoint:DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
• Amaç: Bir ajanı kalıcı olarak silmek
• Yanıt: Ajan başarıyla silindiyse iade 204 OK edilir

Delete Copilot Agent API başvuru belgelerinde daha fazla bilgi edinin.