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

Copilot Studio มอบเครื่องมือที่มีประสิทธิภาพให้กับผู้ดูแลระบบเพื่อจัดการความปลอดภัยและการปฏิบัติตามข้อกําหนดของตัวแทน รวมถึงการดําเนินการกักกันสําหรับตัวแทนผ่าน Power Platform API

ตัวแทนกักกันเป็นส่วนหนึ่งของเฟรมเวิร์กการรักษาความปลอดภัยที่กว้างขึ้นของ Copilot Studio และทํางานควบคู่ไปกับแนวทางการรักษาความปลอดภัยโดยรวมของคุณใน Copilot Studio

ตัวอย่างเช่น ตัวแทนที่ ละเมิดนโยบายข้อมูล หรือ ขาดเอกสารการปฏิบัติตามข้อกําหนด อาจถูกตั้งค่าสถานะว่าเป็นส่วนหนึ่งของการตรวจสอบ การป้องกันรันไทม์ หรือรายงานหรือการแจ้งเตือนอื่นๆ ของผู้ดูแลระบบ จากนั้นผู้ดูแลระบบสามารถใช้ API การตรวจสอบเพื่อแยกเอเจนต์ที่ไม่เป็นไปตามข้อกำหนดในขณะตรวจสอบและแก้ไขปัญหาด้านความปลอดภัยและการปฏิบัติตามกฎระเบียบ

ตัวแทนที่ถูกกักกันยังคงมองเห็นได้แก่ผู้ใช้ตัวแทนและผู้สร้างใน Copilot Studio แต่ไม่สามารถโต้ตอบหรือใช้ตัวแทนได้

สำคัญ

เนมสเปซ powervirtualgents นี้เลิกใช้งานแล้ว ใช้ 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 ไม่สนับสนุน chatbots แบบคลาสสิก 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 รับสถานะการกักกันของบอท

ตั้งค่าเอเจนต์ให้อยู่ในสถานะกักกัน

  • จุดสิ้นสุด: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • วัตถุประสงค์: ทําเครื่องหมายตัวแทนว่าถูกกักกัน โดยจํากัดความพร้อมใช้งานและการโต้ตอบ
  • การตอบกลับ: ยืนยันการอัปเดตสถานะการกักกัน

เรียนรู้เพิ่มเติมในเอกสารอ้างอิง API ตั้งค่าบอทเป็น Quarantined

ตั้งค่าเอเจนต์เป็นถูกยกเลิกการกักกัน

  • จุดสิ้นสุด: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • วัตถุประสงค์: นําตัวแทนออกจากการกักกันหลังจากการประเมินความเสี่ยงและการแก้ไข
  • การตอบกลับ: ยืนยันการอัปเดตสถานะการกักกัน

เรียนรู้เพิ่มเติมในเอกสารอ้างอิง API ตั้งค่าบอทเป็น API ที่ไม่ได้กักบริเวณ

  • Last updated on