Mengarantina agen yang tidak patuh aturan menggunakan API Power Platform

Copilot Studio memberi administrator alat yang kuat untuk mengelola keamanan dan kepatuhan agen, termasuk tindakan mengarantina agen melalui API Power Platform.

Mengarantina agen merupakan bagian dari kerangka kerja keamanan Copilot Studio yang lebih luas dan berfungsi bersama dengan pendekatan keamanan Anda secara keseluruhan di Copilot Studio.

Misalnya, agen yang melanggar kebijakan data atau kurangnya dokumentasi kepatuhan dapat ditandai sebagai bagian dari audit, perlindungan runtime, atau laporan atau pemberitahuan admin lainnya. Admin kemudian dapat menggunakan API karantina untuk mengisolasi agen yang tidak patuh saat menyelidiki dan memulihkan masalah keamanan dan kepatuhan.

Agen yang sedang dikarantina masih terlihat oleh pengguna agen dan pembuat agen di Copilot Studio, tetapi mereka tidak dapat berinteraksi atau menggunakan agen tersebut.

Penting

Namespace powervirtualgents sudah tidak digunakan lagi. Gunakan copilotstudio namespace dalam panggilan API Anda.

Prasyarat

• Anda memiliki ID Bot dan ID Lingkungan untuk agen target.
• Anda harus mendapatkan token akses pengguna yang dikeluarkan oleh Microsoft Entra ID OAuth2. Untuk mendapatkan token, lihat Autentikasi.
  • Pengguna yang terkait dengan token harus memiliki salah satu peran admin berikut:
    • Administrator penyewa global
    • Administrator AI
    • Administrasi Power Platform
  • Anda harus memperoleh token akses menggunakan ID klien dari pendaftaran aplikasi yang memiliki cakupan CopilotStudio.AdminActions.Invoke yang diberikan dalam naungan Power Platform API.

Operasi API untuk manajemen karantina agen

Copilot Studio mendukung tiga operasi REST API utama untuk mengelola karantina agen, sebagai bagian dari API Power Platform.

Catatan

API SetAsQuarantined dan SetAsUnquarantined tidak mendukung chatbot klasik. API mengembalikan 405 Method Not Allowed saat Anda mencoba mengarantina atau mengeluarkan dari karantina chatbot klasik.

Untuk informasi selengkapnya tentang cara dan waktu penggunaan API Power Platform, lihat:

• API dan SDK Power Platform: Dari mengutamakan UX hingga mengutamakan API (Blog) (Blog Pengembang Power Platform)
• Ikhtisar keterprograman dan ekstensibilitas (dokumentasi Power Platform)
• Dimulai dengan API Power Platform (dokumentasi Power Platform)
• Dokumentasi referensi operasi API Power Platform

Mendapatkan status karantina agen

• Titik akhir: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
• Tujuan: Mengambil alih status karantina agen saat ini
• Respons: Mengembalikan boolean isBotQuarantined dan lastUpdateTimeUtc

Pelajari selengkapnya di dokumentasi referensi API Get bot Quarantine Status.

Mengatur agen sebagai dikarantina

• Titik akhir: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
• Tujuan: Menandai agen sebagai dikarantina, membatasi ketersediaan dan interaksinya
• Respons: Mengonfirmasi pembaruan status karantina

Pelajari selengkapnya di dokumentasi referensi API Set Bot As Quarantined.

Mengatur agen sebagai tidak dikarantina

• Titik akhir: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
• Tujuan: Menghapus agen dari karantina setelah penilaian risiko dan remediasi
• Respons: Mengonfirmasi pembaruan status karantina

Pelajari selengkapnya di dokumentasi referensi API Set bot As Unquarantined.