หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Copilot Studio ช่วยให้คุณขยายเอเจนต์ของคุณโดยใช้ ทักษะ หากคุณได้สร้างและปรับใช้เอเจนต์ในองค์กรของคุณอยู่แล้ว (โดยใช้ SDK เอเจนต์สำหรับ Microsoft 365 หรือเครื่องมือเขียนโค้ดระดับมืออาชีพอื่นๆ) สำหรับสถานการณ์เฉพาะ คุณสามารถแปลงบอทเหล่านั้นเป็นทักษะในเอเจนต์ Copilot Studio ได้
หมายเหตุ
หากต้องการเพิ่มทักษะจากภายในแอป Copilot Studio ใน Microsoft Teams คุณต้องมี การสมัครใช้งานแบบสแตนด์อโลนของ Microsoft Copilot Studio
บทความนี้จัดทำขึ้นสำหรับผู้ดูแลระบบหรือผู้เชี่ยวชาญด้านไอทีที่คุ้นเคยกับ ทักษะ
เมื่อคุณลงทะเบียนทักษะกับเอเจนต์ Copilot Studio คุณสามารถ ทริกเกอร์การดําเนินการทักษะในการสนทนา ได้อย่างราบรื่น
ข้อกำหนดเบื้องต้น
สำคัญ
เอเจนต์ Copilot Studio รองรับเฉพาะทักษะที่สร้างขึ้นโดยใช้ Bot Framework SDK ดั้งเดิมเวอร์ชัน 4.12.0+ และ SDK เอเจนต์สำหรับ Microsoft 365 v1.0.0+ เท่านั้น ควรสร้างทักษะใหม่โดยใช้ SDK เอเจนต์สำหรับ Microsoft 365
หากต้องการกำหนดค่าทักษะ ให้ตั้งค่าการลงทะเบียนแอปที่เกี่ยวข้องใน Microsoft Entra ID สำหรับทักษะของคุณเป็นการกำหนดค่าผู้เช่ารายเดียว
เมื่อต้องการใช้โฟลว์เอเจนต์เทียบกับทักษะ
ตารางต่อไปนี้จะช่วยพิจารณาว่าเมื่อใดควรใช้โฟลว์เอเจนต์หรือทักษะสำหรับการสนทนา
| แฟคเตอร์การทำงาน | เมื่อใดที่ควรใช้โฟลว์ตัวแทน | เมื่อใดควรใช้ทักษะ |
|---|---|---|
| ลักษณะ | ผู้สร้างเอเจนต์สามารถสร้างโฟลว์ที่ใช้ซ้ำได้เพื่อฝังลงในการสนทนาของเอเจนต์ | นักพัฒนาสามารถสร้าง ปรับใช้ และโฮสต์ทักษะที่กำหนดเองในสภาพแวดล้อมของตนเอง |
| ประเภทการสนทนา | ใช้โฟลว์สำหรับการใช้งานแบบครั้งเดียวที่เรียบง่าย ตัวอย่างเช่น สั่งซื้อ หรือรับสถานะคำสั่งซื้อ | ใช้ทักษะสำหรับการดำเนินการที่ซับซ้อน ตัวอย่างเช่น กำหนดเวลาการประชุมหรือจองเที่ยวบิน |
| การตอบสนอง | ใช้โฟลว์เพื่อแสดงคำตอบของเอเจนต์ ตัวอย่างเช่น แสดงข้อความส่วนบุคคลหรือรูปภาพแบบอินไลน์ | ใช้ทักษะเพื่อตอบสนองเอเจนต์ที่รองรับ ตัวอย่างเช่น แสดงการ์ดที่ปรับเปลี่ยนได้หรือส่งการตอบกลับแบบสุ่ม |
| การดำเนินการ | ใช้โฟลว์เพื่อทริกเกอร์การดำเนินการแบบครั้งเดียวฝั่งเซิร์ฟเวอร์ ตัวอย่างเช่น เรียก HTTP API หรือทริกเกอร์ตัวเชื่อมต่อที่กำหนดเอง | ใช้ทักษะเพื่อทริกเกอร์เหตุการณ์และการดำเนินการฝั่งเซิร์ฟเวอร์และฝั่งไคลเอ็นต์ ตัวอย่างเช่น ไปที่หน้าเมื่อตอบสนองของเอเจนต์ |
กำหนดค่าทักษะ
ก่อนอื่น ใช้ Copilot Studio เพื่อ สร้างเอเจนต์ และสร้างและปรับใช้ทักษะโดยใช้เครื่องมือเขียนโค้ดระดับมืออาชีพ โปรดดูตัวอย่างเหล่านี้:
ก่อนที่จะลงทะเบียนทักษะ ให้แจ้งรหัสของเอเจนต์แก่นักพัฒนาทักษะของคุณเพื่ออนุญาตให้เอเจนต์เรียกการดำเนินการในทักษะ ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการทักษะที่อนุญาต คุณสามารถรับรหัสเอเจนต์ของคุณได้จากหน้าต่าง เพิ่มทักษะ
หากต้องการเพิ่มทักษะให้กับเอเจนต์ของคุณ:
ไปยังเอเจนต์ของคุณ
เลือก การตั้งค่า>ทักษะ เพื่อไปที่หน้าทักษะ
เลือก เพิ่มทักษะ
คัดลอก ID เอเจนต์ของคุณ คุณจําเป็นต้องระบุ ID เอเจนต์ให้กับนักพัฒนาทักษะของคุณ
ป้อน URL ไปยัง รายการทักษะ รายการของทักษะประกอบด้วยข้อมูลที่เอเจนต์ของคุณจะต้องใช้เพื่อทริกเกอร์การดำเนินการภายในทักษะ
เลือก ถัดไป เพื่อเริ่ม การตรวจสอบความถูกต้อง เมื่อการตรวจสอบความถูกต้องสำเร็จ ทักษะของคุณจะถูกเพิ่มไปยังเอเจนต์ของคุณ ตอนนี้คุณสามารถ ใช้ทักษะนี้ในหัวข้อของคุณ
ข้อพิจารณาด้านการปฏิบัติตามกฎระเบียบ
เพื่อปกป้องความเป็นส่วนตัวของผู้ใช้ เราจำเป็นต้องมีทักษะในการลงทะเบียนเป็นแอปในผู้เช่า Microsoft Entra ID ของผู้ใช้ที่ลงชื่อเข้าใช้
แก้ไขข้อผิดพลาดระหว่างการลงทะเบียนทักษะ
ชุดของการตรวจสอบความถูกต้องจะดำเนินการกับ URL การตรวจสอบเหล่านี้ช่วยให้มั่นใจได้ถึงการปฏิบัติตาม การกำกับดูแล และความสามารถในการใช้งานของทักษะที่เพิ่มเข้าไปในเอเจนต์ของคุณ คุณต้องแก้ไขข้อผิดพลาดเหล่านี้ก่อนลงทะเบียนทักษะ
| ข้อความแสดงข้อผิดพลาด | แก้ไขปัญหา / บรรเทาผลกระทบ |
|---|---|
| เราประสบปัญหาในการรับรายการทักษะ ( MANIFEST_FETCH_FAILED) |
ลองเปิดไฟล์ URL รายการของคุณในเว็บเบราว์เซอร์ หาก URL แสดงผลหน้าเว็บภายใน 10 วินาที ให้ลงทะเบียนทักษะของคุณอีกครั้ง |
| ไฟล์รายการเข้ากันไม่ได้ ( MANIFEST_MALFORMED) |
(a) ตรวจสอบว่ารายการเป็นไฟล์ JSON ที่ถูกต้องหรือไม่ (b) ตรวจสอบว่ารายการมีคุณสมบัติที่จําเป็นหรือไม่ ตัวอย่างเช่น ( name, , single endpoint,idactivities/ , ,description/activities (/typeactivitiesเฉพาะeventหรือmessageรองรับ)) msaAppId |
| มีจุดสิ้นสุดที่ไม่ตรงกัน ( MANIFEST_ENDPOINT_ORIGIN_MISMATCH) |
ตรวจสอบว่าจุดสิ้นสุดทักษะตรงกับ Publisher domain การลงทะเบียนแอปพลิเคชัน Microsoft Entra ID ของคุณ (ที่ต้องการ) หรือฟิลด์ Home page URL หรือไม่
เรียนรู้เพิ่มเติมเกี่ยวกับการตั้งค่าหน้าแรกสำหรับจุดสิ้นสุด |
| ในการเพิ่มทักษะ ต้องลงทะเบียนก่อน ( APPID_NOT_IN_TENANT) |
ตรวจสอบว่ารหัสแอปพลิเคชันของทักษะของคุณได้รับการลงทะเบียนในผู้เช่า Microsoft Entra ID ขององค์กรของคุณหรือไม่ |
| ลิงค์ไม่ถูกต้อง ลิงก์ต้องขึ้นต้นด้วย https:// ( URL_MALFORMED, ) URL_NOT_HTTPS |
แก้ไขลิงก์เพื่อเพิ่ม URL ที่ปลอดภัย |
| รายการมีขนาดใหญ่เกินไป ( MANIFEST_TOO_LARGE) |
ตรวจสอบขนาดของรายการ ค่าต้องน้อยกว่าหรือเท่ากับ 500KB |
| เพิ่มทักษะนี้ในเอเจนต์ของคุณแล้ว ( MANIFEST_ALREADY_IMPORTED) |
ลบทักษะแล้วลองลงทะเบียนอีกครั้ง |
| ทักษะนี้จำกัดการดำเนินการไว้ที่ 100 รายการ ( LIMITS_TOO_MANY_ACTIONS) |
มีการกำหนดการดำเนินการของทักษะมากเกินไปในรายการทักษะ นำการดำเนินการเหล่านั้นออกและลองอีกครั้ง |
| การดำเนินการจำกัดข้อมูลที่ป้อนไว้ที่ 25 รายการ ( LIMITS_TOO_MANY_INPUTS) |
มีพารามิเตอร์ข้อมูลป้อนเข้าการดำเนินการทักษะมากเกินไป นำพารามิเตอร์เหล่านั้นออกและลองอีกครั้ง |
| การดำเนินการจำกัดผลลัพธ์ไว้ที่ 25 รายการ ( LIMITS_TOO_MANY_OUTPUTS) |
มีพารามิเตอร์ผลลัพธ์การดำเนินการทักษะมากเกินไป นำพารามิเตอร์เหล่านั้นออกและลองอีกครั้ง |
| เอเจนต์ของคุณสามารถมีทักษะได้สูงสุด 100 ทักษะ ( LIMITS_TOO_MANY_SKILLS) |
มีการเพิ่มทักษะในเอเจนต์มากเกินไป ลบทักษะที่มีอยู่แล้วลองอีกครั้ง |
| ดูเหมือนว่ามีบางอย่างผิดพลาด ( AADERROR_OTHER) |
เกิดข้อผิดพลาดชั่วคราวขณะตรวจสอบทักษะของคุณ ลองใหม่ |
| เกิดข้อผิดพลาดบางอย่างขณะตรวจสอบทักษะของคุณ ( ENDPOINT_HEALTHCHECK_FAILED, ) HEALTH_PING_FAILED |
ตรวจสอบว่าจุดสิ้นสุดทักษะของคุณออนไลน์อยู่หรือไม่และตอบสนองต่อข้อความ ตรวจสอบด้วยว่าการลงทะเบียนแอปของทักษะผู้เช่ารายเดียวถูกปรับใช้กับผู้เช่ารายเดียวกัน |
| ทักษะนี้ไม่อนุญาตให้ตัวแทนของคุณอยู่ในรายชื่อ ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) |
ตรวจสอบว่าเจ้าหน้าที่ของคุณถูกเพิ่มในรายการที่อนุญาตของทักษะหรือไม่ |