ใช้แชทบอทแบบคลาสสิกเป็นทักษะ Azure Bot Service ในบอท Azure Bot Service

Note

บทความนี้ใช้กับ แชทบอทแบบคลาสสิก เท่านั้น คุณลักษณะนี้ไม่พร้อมใช้งานสำหรับเอเจนต์ Copilot Studio ที่ทำงานบนชุดเครื่องมือมาตรฐานหรือ GitHub Copilot

Important

บทความนี้มีข้อมูลเกี่ยวกับ ทักษะ Azure Bot Service ซึ่งเป็นวิธีที่ใช้โค้ดในการขยายขีดความสามารถของเอเจนต์ในชุดเครื่องมือมาตรฐาน ทักษะเหล่านี้ไม่ควรถูกสับสนกับทักษะแบบ agenticใน GitHub Copilot harness เรียนรู้เพิ่มเติมเกี่ยวกับวิธีใช้ทักษะตัวแทนในภาพรวมทักษะสําหรับตัวแทน

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

Important

หากต้องการใช้แชทบอทคลาสสิกเป็นทักษะ Azure Bot Service คุณต้องมีใบอนุญาตทดลองใช้งานหรือใบอนุญาต Copilot Studio เต็มรูปแบบ ความสามารถนี้ไม่พร้อมใช้งานกับแผน Copilot Studio สําหรับ Teams

วิธีตั้งค่าแชทบอทคลาสสิกของคุณเป็นทักษะ Azure Bot Service:

  1. เพิ่ม Bot Service ไปยังรายชื่อที่อนุญาตสำหรับ chatbot แบบคลาสสิก

  2. ดาวน์โหลดไฟล์รายการทักษะ Azure Bot Service สำหรับแชทบอทคลาสสิก

  3. เชื่อมต่อแชทบอทแบบคลาสสิกเป็นทักษะ Azure Bot Service จากบอท Bot Service ของคุณ

  4. ตรวจสอบว่าแชทบอทคลาสสิกทำงานเป็นทักษะ Azure Bot Service

Prerequisites

เพิ่มบอท Bot Service ของคุณลงในรายการอนุญาตสําหรับแชทบอทแบบคลาสสิกของคุณ

เพิ่ม ID แอปของบอท Bot Service ลงในรายการอนุญาตสําหรับแชทบอทแบบคลาสสิกที่คุณต้องการใช้เป็นทักษะ บอทต้องอยู่ในผู้เช่าเดียวกัน

  1. รับ ID แอป Microsoft สําหรับบอทใน Bot Services ของคุณ คุณสามารถค้นหาข้อมูลนี้ในพอร์ทัล Azure หรือในการกําหนดค่าบอท

  2. ใน Copilot Studio ให้เปิดแชทบอทคลาสสิกที่คุณต้องการใช้เป็นทักษะ Azure Bot Service

  3. ไปที่ การตั้งค่า เลือก ความปลอดภัย แล้วเลือก รายการที่อนุญาต

  4. เลือก เพิ่มผู้โทรที่อนุญาต

  5. วาง ID app ของ Bot Service และเลือก Next

    ข้อควรระวัง

    แชทบอทคลาสสิกไม่สามารถทําหน้าที่เป็นทักษะ Azure Bot Service สําหรับแชทบอทคลาสสิกอื่น ๆ ได้ หากคุณพยายามเพิ่มรหัสแอปที่เป็นของแชทบอทแบบคลาสสิกลงในรายการที่อนุญาต คุณจะได้รับข้อผิดพลาด คุณสามารถเพิ่ม ID แอปสําหรับบอท Bot Service เท่านั้น

    Copilot Studio จะตรวจสอบ ID แอปของบอทของ Bot Service และยืนยันว่าแอปเป็นของบอทในผู้เช่าเดียวกัน

  6. (ไม่บังคับ) เพิ่ม ชื่อที่แสดง สําหรับบอทที่คุณเพิ่มลงในรายการที่อนุญาต

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

บอท Bot Service จะปรากฏขึ้นตามชื่อที่แสดงถ้าคุณป้อนเข้าไป หรือด้วย ID แอปหากคุณไม่ได้ป้อนชื่อที่แสดง หากต้องการลบหรือแก้ไข ให้เลือกไอคอนทางด้านขวาของชื่อที่แสดงหรือรหัสแอปของบอท

Note

บอทของ Bot Service ที่เพิ่มลงในรายการอนุญาตจะไม่ถูกส่งออกในฐานะส่วนหนึ่งของเนื้อหาบอท

ดาวน์โหลดไฟล์ Manifest ของทักษะ Azure Bot Service สําหรับแชทบอทคลาสสิกของคุณ

แชทบอทคลาสสิกทุกตัวมีรายการทักษะ Azure Bot Service ไฟล์กำกับทักษะเป็นไฟล์ JSON ที่มีชื่อของทักษะ ส่วนติดต่อ และข้อความทริกเกอร์ บอท Bot Service สามารถใช้ Azure Bot Service skill manifest จากแชทบอทคลาสสิก Copilot Studio เพื่อกําหนดค่าการเชื่อมต่อกับแชทบอทคลาสสิกที่สร้าง manifest

บอท Bot Service สามารถใช้ไฟล์กำกับทักษะ Azure Bot service เพื่อให้รู้ว่าเมื่อใดที่จะทริกเกอร์แชทบอทแบบคลาสสิก (เช่น เพื่อตอบสนองต่อบางสิ่งที่ผู้ใช้พูดกับบอท)

ไฟล์กำกับทักษะใน Azure Bot service สำหรับแชทบอทคลาสสิกใช้ เวอร์ชัน 2.2 ของสคีมาไฟล์กำกับทักษะของ Bot Service และประกอบด้วยไฟล์ intents.lu และ manifest.json

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

Copilot Studio จะสร้างและอัปเดต Azure Bot Service Skill Manifests โดยอัตโนมัติ แชทบอทแบบคลาสสิกมี manifest สองรายการ:

  • Test manifest: อนุญาตให้บอท Bot Service เชื่อมต่อกับแชทบอทรุ่นทดสอบแบบคลาสสิกของคุณ ใช้รายการทดสอบเพื่อตรวจสอบการเปลี่ยนแปลงทักษะของคุณก่อนที่จะเผยแพร่

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

  • เผยแพร่แมนิเฟส: อนุญาตให้บอทจากบริการบอทเชื่อมต่อกับเวอร์ชันคลาสสิกที่เผยแพร่แล้วของแชทบอทของคุณ

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

รายการทักษะทั้ง 2 รายการจะปรากฏในแผงจัดการรายการที่อนุญาต

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

หากต้องการดาวน์โหลดไฟล์แมนิเฟส ให้เลือก รายการจะดาวน์โหลดเป็นไฟล์ .zip ที่มีป้ายกำกับ _<bot name>manifest สำหรับ ไฟล์กำกับที่เผยแพร่ หรือ <bot name>test__manifest สำหรับ ไฟล์กำกับทดสอบ

Note

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

เชื่อมต่อแชทบอทแบบคลาสสิกเป็นทักษะ Azure Bot Service จากบอทของคุณ

ใช้ข้อมูลจากสกิลแมนนิเฟสต์ Azure Bot Service ของคุณเพื่อสร้างการเชื่อมต่อทักษะในบอท Bot Service ของคุณ

เรียนรู้เพิ่มเติมเกี่ยวกับโครงสร้างของไฟล์กำกับทักษะ Azure Bot Service ใน ไฟล์กำกับทักษะของ Azure Bot Service

ส่วนกิจกรรมในไฟล์รายการทักษะของ Azure Bot Service มีหัวข้อที่พร้อมใช้งานในแชทบอทแบบคลาสสิกของคุณ

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

ทดสอบแชทบอทคลาสสิกของคุณในฐานะทักษะ Azure Bot Service ด้วยบอท Bot Service

ใช้ Bot Service Emulator เพื่อทดสอบว่าบอทของ Bot Service เรียกใช้แชทบอทแบบคลาสสิกเป็นทักษะ Azure Bot Service ได้อย่างถูกต้อง

Important

คุณต้องเพิ่มบอท Bot Service ของคุณไปยังรายการอนุญาตของ chatbot แบบคลาสสิกเพื่อให้การเชื่อมต่อทักษะทํางานได้

อัปเดตบอทของบริการบอทแบบหลายผู้เช่าเป็นบอทแบบผู้เช่ารายเดียว

ภาพประกอบต่อไปนี้แสดงสถานการณ์ที่บอท Bot Service เรียกแชทบอทคลาสสิกมาใช้เป็นทักษะ Azure Bot Service

ภาพแสดงการโต้ตอบระหว่างบอท Bot Service และแชทบอทแบบคลาสสิก

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

เนื่องจากการลงทะเบียนแอปพลิเคชันของ Copilot Studio chatbot ตอนนี้เป็นผู้เช่ารายเดียว แล้วการสื่อสารนี้จึงใช้ไม่ได้อีกต่อไป Microsoft Entra ID ปฏิเสธที่จะสร้างโทเค็นสําหรับการลงทะเบียนแอปพลิเคชันแบบผู้เช่าเดียวที่ไม่ได้อยู่ในผู้เช่าเดียวกัน

นอกจากนี้ Copilot Studio จะตรวจสอบโทเค็นขาเข้าและปฏิเสธคําขอจากผู้เช่าที่ไม่ได้คาดหวังเช่น ID ผู้เช่าที่มีการสร้างการลงทะเบียนแอปพลิเคชันของ chatbot แบบคลาสสิก

เมื่อต้องการแก้ไขปัญหานี้ ให้ทําตามคําแนะนําที่ตรงกับสถานการณ์ของคุณ:

  • แชทบอทคลาสสิกใน tenant เดียวกับบอท Azure Bot Service: ในกรณีที่แชทบอท Copilot Studio ถูกติดตั้งใน tenant เดียวกับบอท Bot Service และถูกใช้งานโดยบอทนี้เท่านั้น ให้อัปเดตบอท Azure Bot Service เป็นการตั้งค่า tenant เดียว แล้วนํากลับมาใช้งานใหม่ เรียนรู้เพิ่มเติมในส่วน จัดเตรียมและเผยแพร่บอท

  • แชทบอท Copilot Studio ที่ไม่สามารถอัปเดตเป็น single-tenant: ในกรณีที่แชทบอท Copilot Studio ถูกติดตั้งใน tenant เดียวกับบอท Bot Service แล้ว แต่ไม่สามารถอัปเดตเป็น single-tenant ได้ ให้อัปเดตโค้ดในบอท Bot Service เพื่อสร้างโทเค็นสําหรับสื่อสารกับแชทบอท Copilot Studio โทเค็นจําเป็นต้องถูกสร้างขึ้นสําหรับผู้เช่าที่มีการสร้าง chatbot ของ Copilot Studio ด้วย นอกจากนี้ ต้องยอมรับคำตอบซึ่งอาจต้องการให้คุณทำตามขั้นตอนใน แปลงทักษะ Azure Bot Service ที่มีอยู่จากผู้เช่าหลายรายเป็นผู้เช่ารายเดียว

  • อัปเดตล่าสุดเมื่อ