หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
คุณสามารถใช้ REST API (รวมถึง OpenAI API) เพื่อเชื่อมต่อเอเจนต์ที่คุณสร้างกับระบบภายนอกและเข้าถึงข้อมูลที่มีอยู่เพื่อใช้ภายในเอเจนต์ของคุณ คุณสามารถเชื่อมต่อเอเจนต์ของคุณกับ REST API ได้โดยระบุสามสิ่งกับ Copilot Studio:
- ข้อกำหนด OpenAPI ที่กำหนดฟังก์ชันของ API และการดำเนินการที่มีอยู่
- รายละเอียดเกี่ยวกับประเภทของการรับรองความถูกต้องที่จำเป็นและรายละเอียดการรับรองความถูกต้องสำหรับผู้ใช้ในการเชื่อมต่อกับ API เพื่อเข้าถึงระบบภายนอก
- คำอธิบายเพื่อช่วยให้โมเดลภาษากำหนดว่าเมื่อใดควรเรียกใช้ API ที่จะใช้ข้อมูล
สามารถเพิ่ม REST API ลงในเอเจนต์ Copilot และเอเจนต์ที่กำหนดเองได้ผ่าน Copilot Studio
เอเจนต์ Copilot อนุญาตให้ผู้สร้างรวมแหล่งข้อมูลหลายแหล่ง เช่น ตัวเชื่อมต่อ, API, พร้อมท์ และแหล่งความรู้ไว้ในเอเจนต์เดียว คุณสามารถใช้เอเจนต์นี้เพื่อขยายประสบการณ์การใช้งานเอเจนต์ของ Microsoft เช่น Microsoft 365 Copilot
เอเจนต์ที่กำหนดเองคือเอเจนต์แบบสแตนด์อโลนที่มีตัวเชื่อมต่อ, API, พร้อมท์ และแหล่งความรู้ คุณสามารถใช้เอเจนต์ที่กำหนดเองได้โดยตรงโดยการรวมเข้ากับเว็บไซต์หรือช่องทางอื่นๆ
หมายเหตุ
ต้องสร้างการดำเนินการ API จากข้อกำหนด OpenAPI v2 ข้อกำหนดนี้เกิดจากลักษณะการทำงานของ Power Platform ในการประมวลผลข้อกำหนด API หากมีการส่งข้อมูลจำเพาะ v3 ระบบจะแปลเป็นข้อกำหนด v2 โดยอัตโนมัติในระหว่างกระบวนการสร้าง
ข้อกำหนดเบื้องต้น
จำเป็นต้องมีข้อกำหนดเบื้องต้นบางประการเพื่อขยายประสบการณ์การทำงานของเอเจนต์ของ Microsoft ด้วยการดำเนินการของตัวเชื่อมต่อ
สำหรับประสบการณ์เอเจนต์ทุกชนิด คุณต้องมีข้อมูลประจำตัวระดับผู้สร้างและสิทธิการใช้งาน Copilot Studio
คุณต้องมีสำเนาของข้อกำหนด OpenAPI ความรู้เกี่ยวกับประเภทของการรับรองความถูกต้องที่จำเป็น และรายละเอียดการรับรองความถูกต้อง
เพิ่มการดำเนินการของ REST API ให้กับเอเจนต์
การเพิ่ม REST API ลงในเอเจนต์ของคุณใช้ไม่กี่ขั้นตอน ส่วนต่อไปนี้จะอธิบายให้คุณทราบถึงกระบวนการนี้
ขั้นตอนในการเพิ่ม REST API จะเหมือนกันสำหรับทั้งเอเจนต์ที่กำหนดเองและเอเจนต์ Copilot
มีไม่กี่ขั้นตอนในกระบวนการ
เพิ่มการดำเนินการในเอเจนต์
เริ่มต้นที่หน้า ภาพรวม ของเอเจนต์ของคุณ
ในส่วน การดำเนินการ ให้เลือก เพิ่มการดำเนินการ คุณยังสามารถไปที่แท็บ การดำเนินการ และเลือก เพิ่มการดำเนินการ
ตัวช่วยสร้างการดำเนินการจะเริ่มทำงานพร้อมกับการแสดงหน้า เลือกการดำเนินการ
ระบุข้อกำหนด API, คำอธิบาย, และโซลูชัน
ที่ด้านล่างของหน้า ให้เลือก เพิ่ม API สำหรับตัวเชื่อมต่อที่กำหนดเอง
อัปโหลดไฟล์ข้อมูลจำเพาะ OpenAPI สำหรับ REST API ที่คุณต้องการเชื่อมต่อ คุณสามารถลากและวางไฟล์ข้อมูลจำเพาะลงในหน้าจอ อัปโหลด REST API หรือเรียกดูระบบของคุณเพื่อค้นหาไฟล์ที่คุณต้องการใช้
หมายเหตุ
ข้อมูลจำเพาะ OpenAPI ต้องเป็นไฟล์ JSON ในรูปแบบ v2 หากมีการส่งข้อมูลจำเพาะ v3 ระบบจะแปลเป็นข้อกำหนด v2 โดยอัตโนมัติในระหว่างกระบวนการสร้าง
หลังจากที่คุณอัปโหลดข้อมูลจำเพาะ หน้าจอจะอัปเดตเพื่อระบุชื่อไฟล์ข้อมูลจำเพาะและรายละเอียด
ในขั้นตอนที่ตามมา เราจะให้พื้นฐานขั้นตอนในตัวอย่างเฉพาะของ SunnyADO ซึ่งเป็นระบบจัดการตั๋ว ADO ในตัวอย่าง ความตั้งใจคือการอนุญาตให้ผู้ใช้ดึงและอัปเดตตั๋วผ่านเอเจนต์
ตรวจสอบรายละเอียด และจากนั้น คลิก ถัดไป
คุณจะเห็นหน้า รายละเอียดปลั๊กอิน API ซึ่งคุณสามารถให้ข้อมูลเพิ่มเติมเกี่ยวกับ API ได้
ฟิลด์คำอธิบายจะเริ่มต้นด้วยคำอธิบายในข้อกำหนด API ที่คุณอัปโหลด ระบุคำอธิบายโดยละเอียด เนื่องจากการประสานรวมเอเจนต์ของคุณใช้คำอธิบายเพื่อกำหนดว่าเมื่อใดควรใช้การดำเนินการเฉพาะ ระบุรายละเอียด รวมถึงคำพ้องความหมาย เพื่อช่วยเอเจนต์ของคุณในกระบวนการคัดเลือก
ตัวอย่างเช่น คำอธิบายเบื้องต้นที่ให้ไว้คือ: "บริการง่ายๆ ในการจัดการตั๋ว"
คำอธิบายที่ดีกว่าคือ: "ระบบที่ใช้ในการรับ ดึง ค้นหา และแสดงตั๋วที่มีอยู่จาก SunnyADO ซึ่งช่วยให้ผู้ใช้สามารถอัปเดต เปลี่ยนแปลง และจัดการตั๋วเพื่อให้ข้อมูลเพิ่มเติมเพื่อปรับปรุงบันทึกข้อมูล"
ป้อนคำอธิบายที่ได้รับการปรับปรุงภายใต้ฟิลด์ คำอธิบาย
ภายใต้ โซลูชัน เมนูดรอปดาวน์แสดงรายการโซลูชันทั้งหมดที่มีอยู่ในสภาพแวดล้อมปัจจุบัน เลือกโซลูชันที่คุณต้องการใช้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับโซลูชัน ให้ดูที่ แนวคิดของโซลูชัน
หากคุณมีโซลูชันที่ต้องการหรือตัวเชื่อมต่อที่คุณเลือกอยู่ในโซลูชันอยู่แล้ว โซลูชันนั้นจะถูกเลือกโดยอัตโนมัติ
คุณสามารถเลือกโซลูชันอื่นหรือปล่อยว่างไว้ก็ได้ หากคุณปล่อยโซลูชันว่างไว้ จะมีการสร้างโซลูชันให้กับคุณโดยใช้ชื่อการดำเนินการและผู้เผยแพร่เริ่มต้น การจัดเก็บการดำเนินการของคุณในโซลูชันช่วยให้คุณเคลื่อนย้ายข้ามสภาพแวดล้อมได้ง่ายๆ
หมายเหตุ
หากคุณไม่เห็นโซลูชันเริ่มต้นหรือโซลูชันเริ่มต้นของ CDS เป็นตัวเลือกในกรณีนี้ เราจะแนะนำให้มีโซลูชันแบบกำหนดเองเพื่อการจัดการที่ง่ายดาย สำหรับข้อมูลเพิ่มเติม ดูที่: โซลูชันเริ่มต้นเทียบกับโซลูชันแบบกำหนดเอง
เมื่อเลือกโซลูชันแล้ว ให้เลือก ถัดไป เพื่อดำเนินการต่อ
ระบุรายละเอียดการรับรองความถูกต้อง
หน้า การรับรองความถูกต้อง จะปรากฏขึ้น เพื่อเลือกประเภทของการรับรองความถูกต้องที่จะใช้สำหรับ API
หมายเหตุ
ขณะนี้ ตัวเลือกที่ใช้ได้คือ ไม่มี, Auth 2.0 และ API
เลือกวิธีการรับรองความถูกต้องจากรายการ
กรอกข้อมูลในฟิลด์ที่จำเป็นสำหรับวิธีการรับรองความถูกต้อง ฟิลด์จะแตกต่างกันไปตามวิธีการรับรองความถูกต้อง
- ไม่มี: ไม่มีฟิลด์อื่นที่จำเป็น
-
คีย์ API:
- ป้ายชื่อพารามิเตอร์: ป้ายชื่อข้อความสำหรับพารามิเตอร์ API
- ชื่อพารามิเตอร์: ชื่อข้อความสำหรับพารามิเตอร์ API
- ตำแหน่งพารามิเตอร์: ตำแหน่งที่สามารถค้นหาพารามิเตอร์ได้
-
Auth 2.0:
- รหัสไคลเอ็นต์: GUID ไคลเอ็นต์สำหรับบริการเป้าหมาย
- ข้อมูลลับไคลเอ็นต์ – ค่าข้อมูลลับสำหรับไคลเอ็นต์ ข้อมูลลับจะไม่แสดงเมื่อผู้ใช้เปิดแผงแก้ไขในภายหลัง อย่างไรก็ตาม ให้เก็บข้อมูลลับไว้ เพราะคุณจะต้องใช้ข้อมูลนั้นหากคุณเลือกที่จะทำการแก้ไขเพิ่มเติม
- URL การอนุญาต: URL ที่ใช้เพื่ออนุญาตระบบต้นทาง
- URL โทเค็น: URL ที่สามารถดึงโทเค็นได้
- URL การรีเฟรช: URL ที่จะนำคุณไปยังสถานการณ์การรีเฟรช
- ขอบเขต: URL ขอบเขตที่กำหนดให้กับ API สำหรับแอป Microsoft Entra
- องค์กร Microsoft 365 ใดเข้าถึงตำแหน่งข้อมูล: จำกัดการเข้าถึงแหล่งที่มาสำหรับองค์กรของผู้สร้างหรือทุกองค์กร
- แอป (ไคลเอ็นต์) ใดที่สามารถใช้ตำแหน่งข้อมูล: GUID ที่กำหนดระบบไคลเอ็นต์ที่สามารถใช้เข้าถึงข้อมูลนี้ได้ แอปอาจรวมถึง Microsoft 365, Power Automate และตัวเลือกอื่นๆ
เมื่อฟิลด์ทั้งหมดเสร็จสมบูรณ์แล้ว ให้เลือก ถัดไป
คุณจะเห็นหน้า เลือกและกำหนดค่าการดำเนินการปลั๊กอินของคุณ ซึ่งคุณสามารถเลือกการดำเนินการที่จะเปิดใช้งานสำหรับ API
เลือกการดำเนินการสำหรับ API
เลือกการดำเนินการที่รองรับ API เพื่อเปิดใช้งาน โดยทั่วไป REST API จะมีการดำเนินการที่หลากหลายผ่านการผสานระหว่างตำแหน่งข้อมูลและวิธีการ HTTP (รับ วาง โพสต์ ลบ และอื่นๆ) ที่กำหนดไว้ในข้อกำหนด API ในบางกรณี คุณอาจไม่ต้องการให้ผู้ใช้ของเอเจนต์มีความสามารถในการดำเนินการ ทุกอย่าง ที่ API เสนอให้โดยทั่วไป ตัวอย่างเช่น ข้อกำหนด API ของคุณอาจมีการดำเนินการเพื่ออัปเดตและลบ แต่คุณต้องการให้ผู้ใช้เอเจนต์ของคุณสร้างเรกคอร์ดได้เท่านั้น
เลือกการดำเนินการจากรายการที่จะกำหนดค่า
หน้า กำหนดค่าการดำเนินการปลั๊กอินของคุณ จะปรากฏขึ้น
กำหนดค่าการดำเนินการที่เลือก เช่นเดียวกับ API โดยรวม ระบบจะขอให้คุณระบุ ชื่อการดำเนินการ และ คำอธิบายการดำเนินการ คำอธิบายจะถูกเติมไว้ล่วงหน้าในขั้นต้นจากคำอธิบายในข้อกำหนด API ชื่อไม่จำเป็นต้องไม่ซ้ำกัน แต่ควรแสดงถึงการดำเนินการนั้น คำอธิบาย เช่นเดียวกับคำอธิบาย API โดยรวม ควรมีลักษณะเฉพาะเจาะจงเพียงพอที่จะให้รายละเอียดแก่โมเดลภาษาเพื่อให้ระบุได้ดีขึ้นว่าข้อความค้นหาของคุณสอดคล้องกับการดำเนินการเฉพาะนี้
เมื่อกรอกข้อมูลในฟิลด์แล้ว ให้เลือก ถัดไป
หน้า ตรวจสอบพารามิเตอร์ของการดำเนินการ จะปรากฏขึ้น
หน้านี้แสดงค่าที่ระบุเป็นส่วนหนึ่งของค่าอินพุตและเอาต์พุตที่เป็นไปได้ ไม่สามารถเปลี่ยนค่าเหล่านี้ได้ แต่ คำอธิบาย ของอินพุตและเอาต์พุตสามารถอัปเดตได้ เนื้อหาทั้งหมดในหน้านี้ดึงมาจากข้อกำหนด API ที่อัปโหลดโดยตรง
กรอกค่าตามความจำเป็นสำหรับคำอธิบาย คำอธิบายให้คำจำกัดความว่าค่านั้นใช้สำหรับอะไร หากคำอธิบายใดว่างเปล่า ต้องระบุให้เสร็จก่อนจึงจะสามารถดำเนินการต่อได้ คุณสามารถวางชื่อได้หากคุณไม่มีคำอธิบายที่ดีกว่านี้
หลังจากระบุคำอธิบายเสร็จแล้ว ให้เลือก ถัดไป
ขณะนี้การดำเนินการแรกได้รับการกำหนดค่าและปรากฏในรายการของ การดำเนินการที่เลือก บนหน้า เลือกและกำหนดค่าการดำเนินการปลั๊กอินของคุณ
เพิ่มการดำเนินการอื่นๆ ที่คุณต้องการรวมไว้ในตอนนี้ เมื่อคุณเพิ่มการดำเนินการที่คุณต้องการให้เอเจนต์สนับสนุนเสร็จแล้ว ให้เลือก ถัดไป
หน้า ตรวจสอบการดำเนินการ ของคุณจะปรากฏขึ้น หน้านี้แสดงรายละเอียดของการดำเนินการ REST API ที่กำหนดค่าไว้
ตรวจทานและเผยแพร่
หากคุณต้องการทำการอัปเดตใดๆ คุณสามารถเลือก ย้อนกลับ และทำการเปลี่ยนแปลงได้ มิฉะนั้น เลือก ถัดไป
หน้าจอจะปรากฏขึ้นเพื่อแสดงว่าการดำเนินการของคุณกำลังถูกเผยแพร่ในขณะที่กระบวนการกำลังเสร็จสมบูรณ์ คุณจะได้รับแจ้งเมื่อการเผยแพร่เสร็จสมบูรณ์
หลังจากเผยแพร่เสร็จแล้ว คุณจะกลับไปที่หน้าจอ เลือกการดำเนินการ ที่นี่คุณสามารถเพิ่ม REST API ที่กำหนดค่าใหม่ลงในเอเจนต์ Copilot หรือเอเจนต์ที่กำหนดเอง และทำการกำหนดค่าส่วนประกอบให้เสร็จสิ้น
การดำเนินการ REST API พร้อมใช้งานในเอเจนต์ของคุณแล้ว
เคล็ดลับ
หากต้องการให้ค้นหาการดำเนินการของคุณง่ายขึ้น ให้ใช้แถบค้นหาเพื่อค้นหาการดำเนินการนั้น