กักกันเอเจนต์ที่ไม่เป็นไปตามข้อกำหนดด้วย Power Platform API

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 ดูที่:

รับสถานะการกักกันเอเจนต์

  • จุดเชื่อมต่อ: 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

  • Last updated on