ลบตัวแทนทางโปรแกรมโดยใช้ API ของแพลตฟอร์ม Power

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

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

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

เมื่อคุณลบเอเย่นต์ออกจากสภาพแวดล้อมของคุณ ผู้สร้างและผู้ใช้ก่อนหน้านี้จะไม่สามารถดูได้อีกต่อไป

เมื่อคุณลบตัวแทนที่มี ID เอเจนต์ของ Microsoft Entra ID ตัวแทนที่เกี่ยวข้อง (หรือการลงทะเบียนแอปสําหรับตัวแทนเดิม) จะถูกลบออกจาก Microsoft Entra ID ด้วย สําหรับข้อมูลเพิ่มเติม โปรดดู สร้างข้อมูลประจําตัวของเจ้าหน้าที่ Microsoft Entra

สำคัญ

เนมสเปซ powervirtualgents นี้เลิกใช้งานแล้ว ใช้ copilotstudio เนมสเปซในการเรียก API ของคุณ

ข้อกำหนดเบื้องต้น

  • คุณมี ID บอทและ ID สภาพแวดล้อมสำหรับเอเจนต์เป้าหมาย
  • คุณต้องขอรับโทเค็นการเข้าถึงของผู้ใช้ที่ออกโดย Microsoft Entra ID OAuth2 หากต้องการรับโทเค็น ให้ดู การรับรองความถูกต้อง
    • ผู้ใช้ที่เชื่อมโยงกับโทเค็นต้องมีบทบาทผู้ดูแลระบบอย่างใดอย่างหนึ่งต่อไปนี้:
      • ผู้ดูแลระบบผู้เช่าส่วนกลาง
      • ผู้ดูแลระบบ AI
      • ผู้ดูแลระบบ Power Platform
    • คุณต้องได้รับโทเค็นการเข้าถึงโดยใช้ ID ไคลเอ็นต์ของการลงทะเบียนแอปที่มี CopilotStudio.AdminActions.Invoke ขอบเขตที่มอบให้ภายใต้ Power Platform API

การดำเนินการ API สำหรับการลบเอเจนต์

Copilot Studio ซึ่งเป็นส่วนหนึ่งของ Power Platform API สนับสนุนการดําเนินการ REST API delete สําหรับการเอาตัวแทนออก

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการและเวลาที่ใช้ Power Platform API ดูที่:

ลบเอเจนต์

  • จุดสิ้นสุด: DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1
  • วัตถุประสงค์: ลบตัวแทนอย่างถาวร
  • การตอบกลับ: ส่งคืน 204 OK หากเอเจนต์ถูกลบสําเร็จ

เรียนรู้เพิ่มเติมในเอกสารอ้างอิง Delete Copilot Agent API