หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Copilot Studio ช่วยให้ผู้ดูแลระบบมี เครื่องมือที่มีประสิทธิภาพในการจัดการความปลอดภัยและการปฏิบัติตามข้อบังคับของเอเจนต์ รวมถึงการดำเนินการกักกันสำหรับเอเจนต์ผ่าน Power Platform API
การกักกันเอเจนต์เป็นส่วนหนึ่งของเฟรมเวิร์กการรักษาความปลอดภัยที่กว้างขึ้นของ Copilot Studio และ ทำงานควบคู่ไปกับวิธีการรักษาความปลอดภัยโดยรวมของคุณใน Copilot Studio
ตัวอย่างเช่น เอเจนต์ที่ ละเมิดนโยบายข้อมูล หรือ ไม่มีเอกสารการปฏิบัติตามกฎระเบียบ สามารถถูกตั้งค่าสถานะเป็นส่วนหนึ่งของการตรวจสอบ การป้องกันรันไทม์ หรือรายงานหรือการแจ้งเตือนของผู้ดูแลระบบอื่นๆ จากนั้นผู้ดูแลระบบสามารถใช้ API การตรวจสอบเพื่อแยกเอเจนต์ที่ไม่เป็นไปตามข้อกำหนดในขณะตรวจสอบและแก้ไขปัญหาด้านความปลอดภัยและการปฏิบัติตามกฎระเบียบ
ผู้ใช้และผู้สร้างเอเจนต์สามารถเห็นเอเจนต์ที่ถูกโอนหรือเปลี่ยนเจ้าของแล้วใน Copilot Studio ผู้สร้างสามารถโต้ตอบกับเอเจนต์ในระหว่างการทดสอบ แต่ไม่สามารถโต้ตอบกับเอเจนต์ที่ถูกกักกันในช่องทางอื่นได้
สำคัญ
Namespace powervirtualgents ไม่สนับสนุนอีกต่อไป ใช้ Namespace copilotstudio ในการเรียก API
ข้อกำหนดเบื้องต้น
- คุณมี ID บอทและ ID สภาพแวดล้อมสำหรับเอเจนต์เป้าหมาย
- คุณต้องได้รับโทเค็นการเข้าถึงของผู้ใช้ที่ออกโดย Microsoft Entra ID OAuth2 หากต้องการรับโทเค็น โปรดดู การรับรองความถูกต้อง
- ผู้ใช้ที่เชื่อมโยงกับโทเค็นต้องมีบทบาทผู้ดูแลระบบอย่างใดอย่างหนึ่งต่อไปนี้:
- ผู้ดูแลระบบของผู้เช่าส่วนกลาง
- ผู้ดูแลระบบ AI
- ผู้ดูแลระบบ Power Platform
- คุณต้องรับโทเค็นการเข้าถึงโดยใช้รหัสไคลเอ็นต์ของการลงทะเบียนแอปที่ได้รับอนุญาตขอบเขต CopilotStudio.AdminActions.Invoke ภายใต้ Power Platform API
- ผู้ใช้ที่เชื่อมโยงกับโทเค็นต้องมีบทบาทผู้ดูแลระบบอย่างใดอย่างหนึ่งต่อไปนี้:
การดำเนินการ API สำหรับการจัดการกักกันเอเจนต์
Copilot Studio สนับสนุนการดำเนินการ REST API หลักสามรายการสำหรับการจัดการการกักกันเอเจนต์ซึ่งเป็นส่วนหนึ่งของ Power Platform API
ธนบัตร
SetAsQuarantined และ SetAsUnquarantined API ไม่รองรับแชทบอทแบบคลาสสิก API จะแสดงผล 405 Method Not Allowed เมื่อคุณพยายามกักกันหรือยกเลิกการกักบริเวณแชทบอทแบบคลาสสิก
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการและเวลาที่ใช้ Power Platform API ดูที่:
- Power Platform API และ SDK: จากเน้น UX ไปสู่การเน้น API (บล็อก) (บล็อกนักพัฒนา Power Platform)
- ภาพรวม ความสามารถในการเขียนโปรแกรมและความสามารถในการขยาย (เอกสารประกอบ Power Platform)
- เริ่มต้นใช้งาน Power Platform API (เอกสารประกอบของ Power Platform)
- คู่มืออ้างอิงการดำเนินงานของ Power Platform API
รับสถานะการกักกันเอเจนต์
-
จุดเชื่อมต่อ:
GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1 - วัตถุประสงค์: ดึงข้อมูลสถานะการกักกันปัจจุุบันของเอเจนต์
-
การตอบกลับ: ส่งกลับบูลีน
isBotQuarantinedและlastUpdateTimeUtc
ศึกษาข้อมูลเพิ่มเติมได้ใน เอกสารอ้างอิง API Get บอท Quarantine Status
ตั้งค่าเอเจนต์ให้อยู่ในสถานะกักกัน
-
จุดเชื่อมต่อ:
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1 - วัตถุประสงค์: ทำเครื่องหมายเอเจนต์ว่าถูกกักกัน โดยจำกัดความพร้อมใช้งานและการโต้ตอบ
- การตอบกลับ: ยืนยันการอัปเดตสถานะการกักกัน
ศึกษาข้อมูลเพิ่มเติมได้ใน เอกสารอ้างอิง API Set บอท As Quarantined
ตั้งค่าเอเจนต์เป็นถูกยกเลิกการกักกัน
-
จุดเชื่อมต่อ:
POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1 - วัตถุประสงค์: นำเอเจนต์ออกจากการกักกันหลังจากการประเมินความเสี่ยงและการแก้ไข
- การตอบกลับ: ยืนยันการอัปเดตสถานะการกักกัน
ศึกษาข้อมูลเพิ่มเติมได้ใน เอกสารอ้างอิง API Set บอท As Unquarantined