รวมแอปบนเว็บหรือแอปดั้งเดิมเข้ากับ Microsoft 365 Agents SDK

สําคัญ

เนื้อหานี้มีไว้สําหรับผู้เชี่ยวชาญด้าน IT ที่มีประสบการณ์ เช่น ผู้ดูแลระบบ IT หรือนักพัฒนาที่คุ้นเคยกับเครื่องมือนักพัฒนา โปรแกรมอรรถประโยชน์ และสภาพแวดล้อมการพัฒนาแบบรวม (IDEs) ซึ่งจําเป็นต้องใช้ความเชี่ยวชาญในการพัฒนาซอฟต์แวร์

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

หมายเหตุ

ถ้าคุณต้องการใช้โค้ดฝังตัวสําหรับเว็บแอปใน Copilot Studio คุณต้องตั้งค่าตัวเลือกการรับรองความถูกต้องความปลอดภัยของคุณเป็น ไม่มีการรับรองความถูกต้อง นําทางไปยังการรับรองความถูกต้องของการตั้งค่า>ความปลอดภัย> และเลือก ไม่มีการรับรองความถูกต้อง เพื่อให้พร้อมใช้งานแบบสาธารณะ

คู่มือนี้ครอบคลุมถึงวิธีการนําตัวแทน Copilot Studio ของคุณและรวมเข้ากับเว็บแอปพลิเคชันที่มีอยู่ของคุณ (โดยทั่วไปคือเว็บไซต์) หรือแอปพลิเคชันดั้งเดิมโดยใช้ไคลเอ็นต์ Copilot Studio กับ Microsoft 365 Agents SDK

ส่วนต่าง ๆ ของคู่มือนี้มีความเกี่ยวข้องโดยขึ้นอยู่กับว่าคุณมี UX/UI ที่มีอยู่ที่คุณต้องการรวมตัวแทนเข้าไปหรือหากคุณวางแผนที่จะใช้ UX/UI ที่ Microsoft ให้มา ใช้ตารางต่อไปนี้เพื่อค้นหาส่วนที่เหมาะสมกับสถานการณ์ของคุณ

วิธีการปรับใช้	วิธีการ ที่ไหน และเพราะอะไร	ลิงก์ด่วน
ใช้รหัสฝังตัวการสนทนาบนเว็บเริ่มต้น	ด้วยตัวแทนที่เปิดใช้งานการตั้งค่าความปลอดภัย ไม่มีการรับรองความถูกต้อง จะสามารถใช้งานได้บนบานหน้าต่างการเผยแพร่ช่องทาง เว็บ ใน Copilot Studio หมายเหตุ: ตัวเลือกนี้จะปรากฏขึ้นเฉพาะเมื่อคุณ ไม่ได้เลือกการรับรองความถูกต้อง ใน Copilot Studio	ใช้โค้ดฝังตัวของการสนทนาบนเว็บเริ่มต้น (โดยไม่มีการพัฒนา/รหัส)
เชื่อมต่อกับ Copilot Studio ด้วยการลงชื่อเข้าใช้ของผู้ใช้ SDK ตัวแทน	ใช้สตริงการเชื่อมต่อ Agents SDK หรือการตั้งค่าการกำหนดค่าเพื่อผสานรวมกับตัวแทนของคุณโดยตรงโดยใช้ข้อมูลประจำตัวของผู้ใช้ผ่าน copilot	กําหนดค่าการลงทะเบียนแอปของคุณสําหรับผู้ใช้ที่ลงชื่อเข้าใช้แบบโต้ตอบ
เชื่อมต่อกับ Copilot Studio ด้วยลงชื่อเข้าใช้บริการหลักของตัวแทน SDK	เพื่อใช้ในตําแหน่งที่คุณต้องการให้ตัวแทนมีข้อมูลประจําตัวของตนเองและไม่ใช้ในนามของผู้ใช้ที่เข้าถึงตัวแทน มีประโยชน์ในสถานการณ์ที่คุณไม่ต้องการบริบทของผู้ใช้ แต่คุณยังคงต้องเข้าถึง API หรือข้อมูลที่มีสิทธิพิเศษและต้องการการรับรองความถูกต้อง หมายเหตุ: เพื่อทํางานนี้ คุณต้องมีการรับรองความถูกต้องสําหรับตัวแทนนี้ใน Copilot Studio ที่ตั้งค่าเป็นไม่มีการรับรองความถูกต้อง	กําหนดค่าการลงทะเบียนแอปของคุณสําหรับองค์ประกอบหลักของบริการ
ใช้ DirectLine เดิมเพื่อเชื่อมต่อกับ Copilot Studio	คุณสามารถเชื่อมต่อกับ DirectLine โดยใช้ DirectLine API และควรใช้ในกรณีที่ SDK ตัวแทนไม่สนับสนุนสถานการณ์ของคุณ	เผยแพร่เอเจนต์ไปยังแอปสำหรับอุปกรณ์เคลื่อนที่หรือแบบกำหนดเอง

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

• .NET Core / JS/ Python
• แพ็คเกจ–ไคลเอ็นต์ Copilot Studio
• ตัวแทน

วิธีการผสานการทำงานของตัวแทน Copilot Studio ของคุณ

• ไคลเอ็นต์ Copilot Studio (โดยใช้ Agents SDK): วิธีนี้เป็นวิธีที่คุณต้องการรวมกับ Copilot Studio

• DirectLine: DirectLine เป็นวิธีดั้งเดิมในการผสานรวมกับ Copilot Studio และควรใช้ในกรณีที่ไม่มีการสนับสนุนสําหรับกรณีการใช้งานของคุณกับ Copilot Studio client

  • ไม่รองรับโทเค็นหลักบริการ

เริ่มต้นใช้งาน: การกําหนดค่าพื้นฐานและการทดสอบการเชื่อมต่อของบริษัทตัวแทนโดยใช้ SDK ตัวแทน Microsoft 365

1. ดาวน์โหลดตัวอย่างไคลเอ็นต์ Copilot Studio จาก SDK ตัวแทน Microsoft 365

   เราประยุกต์การรวมกับ SDK ตัวแทนสําหรับแอปเว็บและเนทีฟของคุณ โดยการให้ไลบรารีไคลเอ็นต์ที่ช่วยให้นักพัฒนาสามารถป้อนรายละเอียดบางอย่างเกี่ยวกับตัวแทนของคุณ และรวมเข้ากับแอปพลิเคชันของคุณได้อย่างง่ายดาย

2. รับ ตัวอย่างไคลเอ็นต์ Copilot Studio จาก Repo Agents SDK GitHub ใน C#, JavaScript หรือ Python

3. รับโค้ดฝังตัวหรือสตริงการเชื่อมต่อสําหรับตัวแทนของคุณใน Copilot Studio

   คุณต้องเข้าถึงเจ้าหน้าที่ของคุณใน Copilot Studio เพื่อรับรายละเอียดสตริงการเชื่อมต่อ (หรือรายละเอียดสําหรับการตั้งค่าการกําหนดค่า) เพื่อให้สามารถเชื่อมต่อได้

   ใน Copilot Studio ให้เปิดตัวแทนของคุณ เลือกการตั้งค่า>การรับรองความถูกต้องความปลอดภัย> และจากนั้นตรวจสอบการตั้งค่าของเจ้าหน้าที่ของคุณ

   • ถ้าอย่างใดอย่างหนึ่ง การรับรองความถูกต้องกับ Microsoft หรือ รับรองความถูกต้องด้วยตนเอง ถูกเลือก คุณจะเห็นเฉพาะตัวเลือก สตริงการเชื่อมต่อ เพื่อรวมกับ SDK ตัวแทน

   • ถ้า ไม่มีการรับรองความถูกต้อง ถูกเลือก คุณจะเห็นทั้งโค้ดฝังตัวที่คุณสามารถเพิ่มลงในเว็บไซต์ของคุณและสตริงการเชื่อมต่อ ตัวเลือก โค้ดฝังตัว ไม่ได้ใช้ SDK ของตัวแทน และใช้คอมโพเนนต์การสนทนาบนเว็บแบบคิดนอกกรอบแบบมาตรฐาน

   

4. รับรหัสเชื่อมต่อของคุณ

   เมื่อต้องการรับสตริงการเชื่อมต่อสําหรับตัวแทนของคุณใน Copilot Studio ให้เลือก เว็บแอป หรือ แอปแบบดั้งเดิม บนหน้า แชนเน ล เลือก คัดลอก ถัดจากสตริงการเชื่อมต่อภายใต้ Microsoft 365 Agents SDK ใช้สตริงนี้เพื่อเชื่อมต่อกับเอเจนต์นี้จากโค้ดของแอปหรือเว็บดั้งเดิมของคุณ

   

   

5. ดูข้อมูลสำหรับการตั้งค่าแบบดั้งเดิม

   ถ้าคุณไม่ต้องการใช้วิธี สตริงการเชื่อมต่อ และใช้การตั้งค่าการกําหนดค่าแบบดั้งเดิมแทน คุณจําเป็นต้องมีเมตาดาต้าอื่น ๆ จากตัวแทน Copilot Studio ของคุณ

   เลือกการตั้งค่า>ขั้นสูง ภายใต้เมตาดาต้า คุณจําเป็นต้องมี ID สภาพแวดล้อมรหัสผู้เช่า และชื่อ Schema บันทึกค่าเมตาดาต้าเหล่านี้สําหรับในภายหลัง

   

6. กําหนดค่าการลงทะเบียนแอปพลิเคชันของคุณสําหรับสิทธิ์ที่ถูกต้องในการเข้าถึง Copilot Studio

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

   หมายเหตุ

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

กําหนดค่าการลงทะเบียนแอปของคุณสําหรับผู้ใช้ที่ลงชื่อเข้าใช้แบบโต้ตอบ

1. นําทางไปยังสิทธิ์> APIเพิ่มสิทธิ์ เลือก API ที่องค์กรของฉันใช้ และค้นหาPower Platform API

2. เลือกสิทธิ์>ที่ได้รับมอบสิทธิ์Copilot Studio>Copilot Studio.Copilots.Invoke สิทธิ์ เลือก เพิ่มสิทธิ์

สําหรับการลงชื่อเข้าใช้ของผู้ใช้ คุณสามารถทดสอบตัวอย่างการทํางานกับการลงทะเบียนแอปพลิเคชันและตัวแทน Copilot Studio ของคุณ โดย:

เพิ่มสตริงการเชื่อมต่อลงในการตั้งค่าไคลเอ็นต์ Copilot Studio ในไฟล์ appsettings.config :

• DirectConnectUrl
• TenantID:
• ClientID:
• ClientSecret:

เพิ่มการตั้งค่าไคลเอ็นต์ Copilot Studio ในไฟล์ appsettings.config :

• EnvironmentID:
• SchemaName:
• TenantID:
• AppClientID:
• AppClientSecret:

ในตอนนี้คุณควรสามารถเรียกใช้ตัวอย่างและเชื่อมต่อกับตัวแทนผ่านการตั้งค่าการลงทะเบียนแอปของคุณโดยใช้แอปพลิเคชันคอนโซลตัวอย่าง

กําหนดค่าการลงทะเบียนแอปของคุณสําหรับองค์ประกอบหลักของบริการ

อีกวิธีหนึ่งคือ คุณอาจเลือกกําหนดค่าการลงทะเบียนแอปของคุณสําหรับการรับรองความถูกต้องของบริการแทนสําหรับการรับรองความถูกต้องผู้ใช้

1. ในการลงทะเบียนแอปของคุณ ไปที่สิทธิ์ API เพิ่มสิทธิ์ เลือก API ที่องค์กรของฉันใช้ และค้นหาPower Platform API
2. เลือก สิทธิ์แอปพลิเคชัน>Copilot Studio และตรวจสอบสิทธิ์ Copilot Studio.Copilots.Invoke
3. เลือก เพิ่มสิทธิ์

สําหรับการลงชื่อเข้าใช้ของผู้ใช้ คุณสามารถทดสอบตัวอย่างการทํางานกับการลงทะเบียนแอปพลิเคชันและตัวแทน Copilot Studio ของคุณ โดย:

1. เพิ่มสตริงการเชื่อมต่อลงในการตั้งค่าไคลเอ็นต์ Copilot Studio ในไฟล์ appsettings.config :

   • DirectConnectUrl
   • TenantID:
   • UseS2SConnection: true
   • ClientID:
   • ClientSecret:

2. เพิ่มการตั้งค่าไคลเอ็นต์ Copilot Studio ในไฟล์ appsettings.config :

   • EnvironmentID:
   • SchemaName:
   • TenantID:
   • UseS2SConnection: true
   • AppClientID:
   • AppClientSecret:

ตอนนี้คุณควรสามารถเรียกใช้ตัวอย่างและเชื่อมต่อกับตัวแทนด้วยการตั้งค่าการลงทะเบียนแอปของคุณโดยใช้แอปพลิเคชันคอนโซลตัวอย่าง

รวมไคลเอ็นต์ Copilot Studio ลงใน UI/UX ที่มีอยู่ของคุณ

ตอนนี้ คุณได้ทดสอบตัวแทนของคุณกับไคลเอ็นต์ Copilot Studio แล้ว การทดสอบของคุณยืนยันว่าตัวแทนของคุณเชื่อมต่อกับแอปคอนโซลตัวอย่าง คุณพร้อมที่จะรวมไลบรารีลงในเว็บไซต์หรือแอปที่มีอยู่ของคุณ และเชื่อมต่อ/แสดงด้วย UI ที่มีอยู่ของคุณ

วิธีที่คุณรวมตัวแทนของคุณลงในแอปพลิเคชันขึ้นอยู่กับคุณและฐานโค้ดที่มีอยู่ของคุณ โดยทั่วไป ขั้นตอนการรวมตัวแทนของคุณอาจรวมถึง:

1. การอ้างอิงไลบรารีในแอปพลิเคชันของคุณ
2. การใช้ออบเจ็กต์และวิธีการจากไลบรารีไคลเอ็นต์ในโครงการของคุณ
3. การนำเข้าด้วย DI หรือการจัดการไคลเอ็นต์ตามการออกแบบแอปพลิเคชันที่มีอยู่ของคุณ เพื่อให้แน่ใจว่าคุณอ้างอิงการตั้งค่าแอปสําหรับรายละเอียดการกําหนดค่าสําหรับเอเจนต์

ใช้โค้ดฝังตัวของการสนทนาบนเว็บเริ่มต้น (โดยไม่มีการพัฒนา/รหัส)

คุณสามารถเพิ่มตัวแทน Copilot Studio ไปยังเว็บไซต์ของคุณโดยใช้ iFrame ที่ฝังอยู่ใน HTML ของเว็บไซต์/เว็บแอปได้

รหัสนี้จะมองเห็นได้เฉพาะเมื่อเลือกตัวเลือกไม่มีการรับรองความถูกต้องในการตั้งค่าของตัวแทนใน Copilot Studio ภายใต้ความปลอดภัย ถ้า เลือกรับรองความถูกต้องกับ Microsoft หรือ รับรองความถูกต้องด้วยตนเอง จะมองไม่เห็นโค้ดฝังตัว

ใช้ DirectLine เพื่อเชื่อมต่อกับ Copilot Studio

ดู เผยแพร่ตัวแทนไปยังแอปสําหรับอุปกรณ์เคลื่อนที่หรือแบบกําหนดเอง เพื่อใช้ DirectLine เพื่อรวมกับตัวแทน Copilot Studio ของคุณ