หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Copilot Studio ช่วยให้ผู้ดูแลระบบมีเครื่องมือ robust เพื่อจัดการความปลอดภัยและการปฏิบัติตามข้อบังคับของเจ้าหน้าที่ รวมถึงความสามารถในการลบตัวแทนผ่าน Power Platform API
Note
deleteการดําเนินการ API รองรับเฉพาะเอเจนต์ Agent Builder เท่านั้น
การลบตัวแทนเป็นส่วนหนึ่งของเฟรมเวิร์กความปลอดภัยที่กว้าง Copilot Studio และ ทํางานควบคู่ไปกับแนวทางการรักษาความปลอดภัยโดยรวมของคุณใน Copilot Studio
ตัวอย่างเช่น การตรวจสอบ การป้องกันรันไทม์ และรายงานผู้ดูแลระบบหรือการแจ้งเตือนอื่น ๆ สามารถตั้งค่าสถานะตัวแทนที่ละเมิดข้อกําหนดขององค์กรสําหรับการรักษาความปลอดภัยและการรับรองความถูกต้อง ผู้ดูแลระบบสามารถใช้ delete การดําเนินการเพื่อกําจัดเอเจนต์ที่ไม่สอดคล้องกันในขณะตรวจสอบและแก้ไขปัญหาความปลอดภัยและการปฏิบัติตามข้อกําหนด
เมื่อคุณลบเอเย่นต์ออกจากสภาพแวดล้อมของคุณ ผู้สร้างและผู้ใช้ก่อนหน้านี้จะไม่สามารถดูได้อีกต่อไป
เมื่อคุณลบตัวแทนที่มี ID เอเจนต์ของ Microsoft Entra ID ตัวแทนที่เกี่ยวข้อง (หรือการลงทะเบียนแอปสําหรับตัวแทนเดิม) จะถูกลบออกจาก Microsoft Entra ID ด้วย เรียนรู้เพิ่มเติมได้ที่ สร้าง Microsoft Entra Agent ID โดยอัตโนมัติ
สำคัญ
เนมสเปซ 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 ดูที่:
- Power Platform API และ SDK: จากเน้น UX ไปสู่การเน้น API (บล็อก) (บล็อกนักพัฒนา Power Platform)
- ภาพรวมความสามารถในการเขียนโปรแกรมและความสามารถในการขยาย (เอกสารประกอบ Power Platform)
- เริ่มต้นใช้งาน Power Platform API (เอกสารประกอบ Power Platform)
- เอกสารอ้างอิงการดําเนินงาน Power Platform API
ลบเอเจนต์
-
จุดสิ้นสุด:
DELETE https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations?api-version=1 - วัตถุประสงค์: ลบตัวแทนอย่างถาวร
-
การตอบกลับ: ส่งคืน
204 OKหากเอเจนต์ถูกลบสําเร็จ
เรียนรู้เพิ่มเติมในเอกสารอ้างอิง Delete Copilot Agent API