เพิ่มการรับรองความถูกต้องของผู้ใช้ไปยังบอท Power Virtual Agents

เลือกเวอร์ชันของ Power Virtual Agents ที่คุณกำลังใช้ที่นี่:

คุณสามารถเปิดใช้งานการรับรองความถูกต้องของผู้ใช้ได้โดยตรงภายในการสนทนาของบอท Power Virtual Agents การรับรองความถูกต้องของผู้ใช้หมายความว่า คุณจะได้รับคุณสมบัติพื้นฐานของผู้ใช้ เช่น ชื่อ และ ID ในตัวแปรบอท แต่ยังแจ้งให้ผู้ใช้เข้าสู่ระบบโดยใช้โหนดการรับรองความถูกต้อง ดึงโทเค็นผู้ใช้สำหรับผู้ใช้นั้น และจากนั้น ใช้โทเค็นนั้นเพื่อดึงข้อมูลของผู้ใช้จากระบบแบ็คเอนด์

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

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

• เรียนรู้เพิ่มเติมว่าคุณจะสามารถทำอะไรได้บ้างกับ Power Virtual Agents

ตัวแปรการรับรองความถูกต้อง

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

ตารางต่อไปนี้เปรียบเทียบความพร้อมใช้งานของตัวแปรการรับรองความถูกต้องโดยตัวเลือกการตั้งค่าคอนฟิกการรับรองความถูกต้อง:

ตัวแปร UserDisplayName

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

ค่าฟิลด์นี้ได้มาจากการอ้างสิทธิ์ของ Azure Active Directory (Azure AD) name สำหรับผู้ให้บริการ OAuth นี่คือค่าที่เก็บไว้ในการอ้างสิทธิ์ของ name Power Virtual Agents แยกฟิลด์นี้ลงในตัวแปรโดยอัตโนมัติ ดังนั้น ให้แน่ใจว่าคุณมี profile เป็นส่วนหนึ่งของการตั้งค่าขอบเขตการรับรองความถูกต้องของคุณ

ตัวแปร UserID

ตัวแปร UserID มี ID ของผู้ใช้ที่เก็บไว้ในผู้ให้บริการข้อมูลประจำตัว ค่านี้สามารถใช้ได้โดยโฟลว์ Power Automate เพื่อเรียก API ที่ใช้ UserID เป็นค่า ค่าฟิลด์นี้ได้มาจากการอ้างสิทธิ์ของ Azure AD sub สำหรับผู้ให้บริการ OAuth นี่คือค่าที่เก็บไว้ในการอ้างสิทธิ์ของ sub Power Virtual Agents แยกฟิลด์นี้ลงในตัวแปรโดยอัตโนมัติ

ตัวแปร IsLoggedIn

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

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

ตัวแปร AuthToken

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

อย่าใช้ AuthToken ภายในโหนด ข้อความ หรือโฟลว์ที่คุณไม่เชื่อถือ

การทดสอบตัวแปรการรับรองความถูกต้อง

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

ตัวอย่างเช่น คุณอาจต้องการทดสอบว่าใช้อักขระพิเศษอย่างไร หรือจะเกิดอะไรขึ้นหากตัวแปรว่างเปล่า

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

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

หากคุณรีเซ็ตบานหน้าต่าง ทดสอบบอท (หรือคุณทำการเปลี่ยนแปลงหัวข้อที่ทำให้เกิดการรีเซ็ต ทดสอบบอท โดยอัตโนมัติ) คุณจะต้องส่งคำสั่งอีกครั้ง

การรับรองความถูกต้องเมื่อใช้การตั้งค่าคอนฟิก "เฉพาะสำหรับ Teams"

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

เพิ่มการรับรองความถูกต้องของผู้ใช้ไปยังหัวข้อ

แทรกเทมเพลตโหนดการรับรองความถูกต้อง:

1. ไปที่ หน้าหัวข้อ สำหรับบอทที่คุณต้องการแก้ไข

2. เปิด พื้นที่ทำงานการสร้าง สำหรับหัวข้อที่คุณต้องการเพิ่มเทมเพลตการรับรองความถูกต้องให้

3. เลือกไอคอน (+) บวก เพื่อเพิ่มโหนดข้อความ ป้อนสิ่งที่บอทควรพูดเพื่อระบุว่าประสบการณ์การลงชื่อเข้าใช้กำลังจะเกิดขึ้น

   

4. ใต้โหนดข้อความ เลือกไอคอน (+) บวก เลือก เรียกการดำเนินการ แล้วจากนั้น เลือก รับรองความถูกต้อง

   

5. เมื่อเลือกแล้ว จะมีการเพิ่มโหนดใหม่จำนวนมากโดยอัตโนมัติ โหนดเหล่านี้รวมถึงโหนด รับรองความถูกต้อง หลัก ซึ่งตามด้วยโหนดสำหรับทั้งพาธความสำเร็จและความล้มเหลว

   

   หมายเหตุ

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

โหนดรับรองความถูกต้อง

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

เมื่อผู้ใช้ป้อนชื่อผู้ใช้และรหัสผ่านในพรอมต์ (ซึ่งโฮสต์โดยผู้ให้บริการข้อมูลประจำตัว) ผู้ใช้อาจได้รับแจ้งให้ป้อนรหัสการตรวจสอบความถูกต้อง โดยขึ้นอยู่กับ ช่องทาง บางช่องทาง เช่น Microsoft Teams ไม่ต้องการให้ผู้ใช้ป้อนรหัสการตรวจสอบความถูกต้อง

โปรดทราบว่า หากบอทของคุณได้ตั้งค่าคอนฟิก SSO แล้ว ผู้ใช้จะไม่ได้รับแจ้งให้ลงชื่อเข้าใช้

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

การใช้งาน AuthToken โดยไม่มีโหนดรับรองความถูกต้อง

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

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

พาธความสำเร็จ

พาธความสำเร็จเท่ากับที่ซึ่ง IsLoggedIn = True และบัญชีสำหรับเมื่อผู้ใช้ลงชื่อเข้าใช้สำเร็จ (หรือลงชื่อเข้าใช้อยู่แล้ว)

หากคุณมีตรรกะที่ใช้ตัวแปร AuthToken (ตัวอย่างเช่น ในการเชื่อมต่อกับระบบแบ็คเอนต์โดยใช้โฟลว์เพื่อดึงข้อมูลของผู้ใช้) ควรอยู่ภายใต้พาธนี้

พาธความล้มเหลว

พาธความล้มเหลวเท่ากับเงื่อนไขใดๆ ที่ไม่ใช่ IsLoggedIn = True ในกรณีส่วนใหญ่ พาธความล้มเหลวเกิดขึ้นเนื่องจากผู้ใช้ไม่สามารถลงชื่อเข้าใช้ ใช้รหัสผ่านไม่ถูกต้อง หรือยกเลิกประสบการณ์การลงชื่อเข้าใช้

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

การทดสอบหัวข้อของคุณ

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