แชร์ผ่าน


กำหนดค่าการลงชื่อเข้าระบบครั้งเดียวด้วย Microsoft Entra ID สำหรับเอเจนต์ใน Microsoft Teams

Copilot Studio รองรับการลงชื่อเพียงครั้งเดียว (SSO) สำหรับตัวแทนที่เผยแพร่ไปยัง Microsoft Teams แชทแบบ 1:1 ซึ่งหมายความว่าตัวแทนสามารถเข้าสู่ระบบผู้ใช้โดยอัตโนมัติด้วยข้อมูลประจำตัวของตน Microsoft Teams รองรับ SSO เมื่อใช้ Microsoft Entra ID เท่านั้น ผู้ให้บริการรายอื่น เช่น Azure AD v1 ไม่รองรับ SSO ใน Microsoft Teams

สำคัญ

สามารถใช้ SSO ในแชทของ Microsoft Teams ได้แล้ว และไม่จำเป็นต้องมีการรับรองความถูกต้องด้วยตนเอง หากต้องการใช้วิธีนี้กับเอเจนต์ที่เผยแพร่ก่อนหน้านี้ ให้กำหนดค่าเอเจนต์ใหม่เพื่อใช้ รับรองความถูกต้องกับ Microsoft แล้วเผยแพร่ไปยัง Microsoft Teams อีกครั้ง อาจต้องใช้เวลาสองสามชั่วโมงก่อนที่การเปลี่ยนแปลงจะมีผล หากผู้ใช้กำลังอยู่ระหว่างการสนทนา และการเปลี่ยนแปลงนั้นดูเหมือนไม่มีผลใดๆ ในแชท ผู้ใช้สามารถพิมพ์ "เริ่มใหม่" ในแชทเพื่อบังคับให้เริ่มการสนทนาใหม่กับเอเจนต์เวอร์ชันล่าสุด การเปลี่ยนแปลงเหล่านี้พร้อมใช้งานแล้วสำหรับการแชท Teams แบบ 1:1 ระหว่างผู้ใช้กับเอเจนต์ ยังไม่พร้อมใช้งานสำหรับการแชทเป็นกลุ่มหรือข้อความของช่องทาง

ไม่รองรับ SSO สำหรับเอเจนต์ที่รวมเข้ากับ Dynamics 365 Customer Service

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

หมายเหตุ

หากคุณกำลังใช้การรับรองความถูกต้อง SSO ของ Teams ด้วยตัวเลือกการรับรองความถูกต้องด้วยตนเอง และยังใช้เอเจนต์บนเว็บไซต์ที่กำหนดเองในเวลาเดียวกันด้วย คุณต้องปรับใช้แอป Teams โดยใช้รายการแอป

สำหรับข้อมูลเพิ่มเติม โปรดดู ดาวน์โหลดรายการแอป Teams สำหรับ ตัวแทน

การกำหนดค่าอื่นๆ เช่น ตัวเลือกการรับรองความถูกต้องนอกจากด้วยตนเองหรือผ่านการปรับใช้ Teams โดยใช้ Copilot Studio แบบคลิกเดียว จะไม่ทำงาน

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

กำหนดค่าการลงทะเบียนแอป

ก่อนกำหนดค่า SSO สำหรับ Teams คุณต้องกำหนดค่าการรับรองความถูกต้องผู้ใช้ด้วย Microsoft Entra ID กระบวนการนี้จะสร้างการลงทะเบียนแอปที่จำเป็นในการตั้งค่า SSO

  1. สร้างการลงทะเบียนแอป ดูคำแนะนำใน กำหนดค่าการรับรองความถูกต้องผู้ใช้ด้วยรหัส Microsoft Entra

  2. เพิ่ม URL การเปลี่ยนเส้นทาง

  3. สร้างข้อมูลลับของไคลเอ็นต์

  4. กำหนดค่าการรับรองความถูกต้องด้วยตนเอง

ค้นหารหัสแอปช่องทาง Microsoft Teams ของคุณ

  1. เปิด Copilot Studio ตัวแทน ที่คุณต้องการกำหนดค่า SSO

  2. ภายใต้การตั้งค่าสำหรับ ตัวแทน ให้เลือก ช่อง เลือกไทล์ Microsoft Teams

  3. หากช่องทาง Microsoft Teams ยังไม่ได้เชื่อมต่อกับเอเจนต์ของคุณ ให้เลือก เปิด Teams สำหรับข้อมูลเพิ่มเติม โปรดดู เชื่อมต่อเอเจนต์กับช่องทาง Microsoft Teams

  4. เลือก แก้ไขรายละเอียด ขยาย เพิ่มเติม แล้วเลือก คัดลอก ถัดจากฟิลด์ รหัสแอป

เพิ่มรหัสแอปช่องทาง Microsoft Teams ของคุณลงในการลงทะเบียนแอป

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

  2. เลือก แสดง API บนบานหน้าต่างด้านข้าง สำหรับ URI ของรหัสแอปพลิเคชัน เลือก ตั้งค่า

    ภาพหน้าจอของตำแหน่งของปุ่มตั้งค่าสำหรับ URI ของรหัสแอปพลิเคชัน

  3. ป้อน api://botid-{teamsbotid} และแทนที่ {teamsbotid} ด้วย รหัสแอปช่องทาง Teams ที่คุณพบก่อนหน้านี้

    ภาพหน้าจอของ URI ที่มีรูปแบบถูกต้องซึ่งป้อนลงในช่อง URI ของรหัสแอปพลิเคชัน

  4. เลือก บันทึก

แอปพลิเคชันได้รับอนุญาตให้เรียกใช้ API เมื่อผู้ใช้/ผู้ดูแลระบบได้รับสิทธิ์ซึ่งเป็นส่วนหนึ่งของกระบวนการให้ความยินยอม หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการยินยอม โปรดดู สิทธิ์และความยินยอมในแพลตฟอร์มข้อมูลประจำตัวของ Microsoft

หากมีตัวเลือกความยินยอมของผู้ดูแลระบบ คุณต้องให้ความยินยอมดังนี้

  1. ในพอร์ทัล Azure บนแผ่นการลงทะเบียนแอปของคุณ ไปที่ สิทธิ์ API

  2. เลือก ให้คำยินยอมของผู้ดูแลระบบสำหรับ <ชื่อผู้เช่าของคุณ> แล้วเลือก ใช่

สำคัญ

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

เพิ่มสิทธิ์ API

  1. ในพอร์ทัล Azure บนแผ่นการลงทะเบียนแอปของคุณ ไปที่ สิทธิ์ API

  2. เลือก เพิ่มสิทธิ์ แล้วเลือก Microsoft Graph

  3. เลือก สิทธิ์ที่ได้รับมอบสิทธิ์ รายการสิทธิ์จะปรากฏขึ้น

  4. ขยาย สิทธิ์ OpenId

  5. เลือก openid และ โปรไฟล์

  6. เลือก เพิ่มสิทธิ์

    ภาพหน้าจอของสิทธิ์ openid และโปรไฟล์ที่เปิดอยู่

กำหนดขอบเขตที่กำหนดเองสำหรับเอเจนต์ของคุณ

  1. ในพอร์ทัล Azure บนแผ่นการลงทะเบียนแอปของคุณ ไปที่ แสดง API

  2. เลือก เพิ่มขอบเขต

    ภาพหน้าจอของปุ่มเพิ่มขอบเขตที่ไฮไลต์

  3. ตั้งค่าคุณสมบัติดังต่อไปนี้

    คุณสมบัติ มูลค่า
    ชื่อขอบเขต ป้อน Test.Read
    ใครสามารถยินยอม เลือก ผู้ดูแลระบบและผู้ใช้
    ชื่อที่แสดงของความยินยอมของผู้ดูแลระบบ ป้อน Test.Read
    คำอธิบายความยินยอมของผู้ดูแลระบบ ป้อน Allows the app to sign the user in.
    State เลือก เปิดใช้งาน

    หมายเหตุ

    ชื่อขอบเขต Test.Read เป็นค่าตัวยึดตำแหน่งและควรแทนที่ด้วยชื่อที่เหมาะสมในสภาพแวดล้อมของคุณ

  4. เลือก เพิ่มขอบเขต

เพิ่มรหัสไคลเอ็นต์ Microsoft Teams

สำคัญ

ในขั้นตอนต่อไปนี้ ค่าที่ให้ไว้สำหรับรหัสไคลเอ็นต์ Microsoft Teams ควรใช้อย่างแท้จริง เนื่องจากเป็นรหัสเดียวกันในผู้เช่าทั้งหมด

  1. ในพอร์ทัล Azure บนแผนการลงทะเบียนแอปของคุณ ไปที่ แสดง API และเลือก เพิ่มแอปพลิเคชันไคลเอ็นต์

    ภาพหน้าจอของปุ่มเพิ่มแอปพลิเคชันไคลเอ็นต์ที่ไฮไลต์

  2. ในฟิลด์ รหัสไคลเอ็นต์ ให้ป้อนรหัสไคลเอ็นต์สำหรับ Microsoft Teams บนมือถือ/เดสก์ท็อป ซึ่งเป็น 1fec8e78-bce4-4aaf-ab1b-5451cc387264 เลือกกล่องกาเครื่องหมายสำหรับ ขอบเขตที่คุณสร้างก่อนหน้านี้

    ภาพหน้าจอของรหัสไคลเอ็นต์ที่ป้อนลงในบานหน้าต่างเพิ่มแอปพลิเคชันไคลเอ็นต์

  3. เลือก เพิ่มแอปพลิเคชัน

  4. ทำซ้ำขั้นตอนก่อนหน้า แต่สำหรับ รหัสไคลเอ็นต์ ให้ป้อนรหัสไคลเอ็นต์สำหรับ Microsoft Teams บนเว็บ ซึ่งก็คือ 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

  5. ยืนยันว่าหน้า แสดง API แสดงรายการรหัสแอปไคลเอ็นต์ Microsoft Teams

โดยสรุป รหัสไคลเอ็นต์ Microsoft Teams สองรหัสที่เพิ่มลงในหน้า เปิดเผย API ได้แก่:

  • 1fec8e78-bce4-4aaf-ab1b-5451cc387264
  • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

เพิ่ม URL การแลกเปลี่ยนโทเค็นในหน้าการรับรองความถูกต้องของเอเจนต์ของคุณ

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

  1. ในพอร์ทัล Azure บนแผ่นการลงทะเบียนแอปของคุณ ไปที่ แสดง API

  2. ภายใต้ ขอบเขต ให้เลือกไอคอน คัดลอกไปยังคลิปบอร์ด

  3. ใน Copilot Studio ภายใต้การตั้งค่าสำหรับเอเจนต์ ให้เลือก ความปลอดภัย แล้วเลือกไทล์ การรับรองความถูกต้อง

  4. สำหรับ URL การแลกเปลี่ยนโทเค็น (จำเป็นสำหรับ SSO) ให้วางขอบเขตที่คุณคัดลอกไว้ก่อนหน้านี้

  5. เลือก บันทึก

    ภาพหน้าจอของตำแหน่งที่จะวาง URL การแลกเปลี่ยนโทเค็นใน Copilot Studio

เพิ่ม SSO ลงในช่อง ตัวแทน Microsoft Teams

  1. ใน Copilot Studio ภายใต้การตั้งค่าสำหรับ ตัวแทน ให้เลือก ช่อง

  2. เลือกไทล์ Microsoft Teams

  3. เลือก แก้ไขรายละเอียด และขยาย เพิ่มเติม

  4. สำหรับ รหัสไคลเอ็นต์ของแอปพลิเคชัน AAD ป้อน รหัสแอปพลิเคชัน (ไคลเอ็นต์) จากการลงทะเบียนแอปของคุณ

    หากต้องการรับค่านี้ ให้เปิดพอร์ทัล Azure จากนั้นไปที่แผนการลงทะเบียนแอปของคุณ ไปที่ ภาพรวม คัดลอกค่าในช่อง รหัสแอปพลิเคชัน (ไคลเอ็นต์)

  5. สำหรับ URI ของทรัพยากร ป้อน URI ของรหัสแอปพลิเคชัน จากการลงทะเบียนแอปของคุณ

    หากต้องการรับค่านี้ ให้เปิดพอร์ทัล Azure จากนั้นไปที่แผนการลงทะเบียนแอปของคุณ ไปที่ แสดง API คัดลอกค่าในช่อง URI ของรหัสแอปพลิเคชัน

    ภาพหน้าจอของตำแหน่งที่จะวาง URI รหัสแอปพลิเคชันในช่องทาง Teams ของ Copilot Studio

  6. เลือก บันทึก และเลือก ปิด

  7. เผยแพร่เอเจนต์อีกครั้งเพื่อทำให้การเปลี่ยนแปลงล่าสุดสามารถใช้งานสำหรับลูกค้าของคุณ

  8. เลือก เปิดเอเจนต์ใน Teams เพื่อเริ่มการสนทนาใหม่กับเอเจนต์ของคุณใน Microsoft Teams และตรวจสอบว่าระบบจะลงชื่อเข้าใช้ให้คุณโดยอัตโนมัติหรือไม่

ปัญหาที่ทราบกันดี

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