ทดสอบเอเจนต์โดยใช้ Dev Tunnels

โดยใช้ Dev Tunnels คุณสามารถทดสอบ Agent 365 เอเจนต์ของคุณกับแอปพลิเคชัน Microsoft 365 (เช่น Teams, Outlook หรือ Word) ในขณะที่เอเจนต์ของคุณรันอยู่บนเครื่องพัฒนาของคุณ วิธีการนี้เชื่อมโยงการพัฒนาภายในและการทดสอบในโลกแห่งความเป็นจริง เพื่อให้คุณสามารถตรวจสอบลักษณะการทำงานของเอเจนต์ในสภาพแวดล้อม Microsoft 365 จริงก่อนนำไปใช้งานบนคลาวด์

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

ก่อนใช้ Dev Tunnels ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้งเครื่องมือบรรทัดคำสั่ง Dev Tunnels

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: ดาวน์โหลดจาก aka.ms/devtunnels/download

ตั้งค่า Dev Tunnel

กำหนดค่า Dev Tunnel เพื่อเปิดเผยจุดเชื่อมต่อของเอเจนต์ในเครื่องของคุณให้กับบริการ Microsoft 365

สร้างและเริ่ม Tunnel

1. ลงชื่อเข้าใช้ Dev Tunnel:

   devtunnel user login
   

2. สร้าง Tunnel ถาวร:

   devtunnel create --allow-anonymous
   

   คำสั่งนี้ส่งคืนรหัส Tunnel บันทึกตัวระบุนี้เพื่อใช้ในอนาคต

3. กำหนดค่าพอร์ต Tunnel:

   กำหนดพอร์ตที่เซิร์ฟเวอร์เอเจนต์ใช้ (โดยทั่วไปคือ 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. เริ่ม Tunnel:

   devtunnel host <tunnel-id>
   

   คำสั่งจะแสดง URL ของ Tunnel ของคุณ (เช่น https://abc123xyz.devtunnels.ms:3978) คัดลอก URL นี้สำหรับขั้นตอนต่อไป

เคล็ดลับ

ใช้ devtunnel list เพื่อดู Tunnel ทั้งหมดของคุณ และใช้ devtunnel delete <tunnel-id> เพื่อลบ Tunnel ที่คุณไม่ต้องการอีกต่อไป

กำหนดค่าปลายทางการส่งข้อความของเอเจนต์

ลงทะเบียน URL Tunnel สำหรับนักพัฒนา (เช่น https://abc123xyz.devtunnels.ms:3978/api/messages) เป็นจุดปลายทางสำหรับการส่งข้อความของเอเจนต์ เพื่อให้ Microsoft 365 สามารถกำหนดเส้นทางข้อความได้ถูกต้อง อย่าลืมเพิ่ม /api/messages ต่อท้ายที่ URL ของปลายทาง

โปรดดู ตั้งค่าปลายทางการส่งข้อความของเอเจนต์

ทดสอบกับ Microsoft 365

เมื่อ Dev Tunnel ของคุณใช้งานอยู่และลงทะเบียนปลายทางแล้ว ให้ทดสอบเอเจนต์ของคุณในแอปพลิเคชัน Microsoft 365

ทดสอบใน Microsoft Teams

1. เริ่มต้นเอเจนต์ในระบบของคุณโดยใช้คำสั่งใน ติดตั้งการขึ้นต่อกันและเริ่มเซิร์ฟเวอร์แอปพลิเคชันเอเจนต์

2. ตรวจสอบการเชื่อมต่อของ Tunnel:

   devtunnel list
   

   ตรวจสอบว่า Tunnel ของคุณแสดงการเชื่อมต่อโฮสต์ที่ใช้งานอยู่ คอลัมน์ "การเชื่อมต่อโฮสต์" ควรแสดงตัวเลขที่มากกว่า 0

3. โต้ตอบกับเอเจนต์ของคุณใน Teams:

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

ทดสอบการแจ้งเตือนทางอีเมล

หากเอเจนต์ของคุณได้รับการกำหนดค่าสำหรับการแจ้งเตือนทางอีเมล:

1. ส่งอีเมลไปยังที่อยู่อีเมลของเอเจนต์ของคุณ
2. CC เอเจนต์ของคุณในเธรดอีเมล
3. ตรวจสอบคอนโซลภายในเครื่องของคุณสำหรับเว็บฮุคการแจ้งเตือน
4. ตรวจสอบว่าเอเจนต์ได้ประมวลผลและตอบกลับอีเมล

ทดสอบการใช้งานร่วมกับ Word

สำหรับเอเจนต์ที่ตอบกลับความคิดเห็นของ Word:

1. เปิดเอกสาร Word ที่เอเจนต์ของคุณมีสิทธิ์เข้าถึง
2. เพิ่มความคิดเห็นที่กล่าวถึงเอเจนต์ของคุณ
3. ตรวจสอบคอนโซลในเครื่องของคุณเพื่อดูการแจ้งเตือน
4. ตรวจสอบว่าการตอบกลับของเอเจนต์ของคุณปรากฏใน Word

ติดตามกิจกรรมของ Tunnel

Dev Tunnels ให้การตรวจสอบการรับส่งข้อมูลเพื่อช่วยดีบักปัญหาการเชื่อมต่อและทำความเข้าใจโฟลว์คำขอ:

devtunnel show <tunnel-id>

คำสั่งนี้จะแสดง:

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

คุณยังสามารถตรวจสอบกิจกรรมของ Tunnel แบบเรียลไทม์โดยดูผลลัพธ์จากคำสั่ง devtunnel host

รักษาการเชื่อมต่อ Tunnel

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

ตรวจสอบสถานะ Tunnel

ตรวจสอบว่า Tunnel ของคุณทำงานอยู่หรือไม่:

devtunnel list

ผลลัพธ์จะแสดง:

• รหัส Tunnel: ตัวระบุ Tunnel ของคุณ
• การเชื่อมต่อของโฮสต์: จำนวนการเชื่อมต่อที่ใช้งานอยู่ (ควรมีหนึ่งหรือมากกว่านั้นเมื่อ devtunnel host กำลังทำงาน)
• พอร์ต: พอร์ตที่กำหนดค่าไว้
• วันหมดอายุ: เวลาหมดอายุของ Tunnel

หาก การเชื่อมต่อของโฮสต์แสดงเป็น 0 แสดงว่า Tunnel มีอยู่ แต่ไม่ได้โฮสต์อยู่ในขณะนี้

รีสตาร์ท Tunnel ที่ถูกตัดการเชื่อมต่อ

หากการเชื่อมต่อ Tunnel ของคุณหลุด ให้รีสตาร์ทโดยใช้รหัส Tunnel เดิม:

devtunnel host <tunnel-id>

Tunnel URL ยังคงเดิม คุณจึงไม่จำเป็นต้องอัปเดตการตั้งค่าปลายทางการส่งข้อความของเอเจนต์

รักษา Tunnel ให้ทำงานระหว่างการพัฒนา

เพื่อรักษาการเชื่อมต่อที่เสถียร:

• เปิดหน้าต่างเทอร์มินัลไว้ - อย่าปิดเทอร์มินัลที่กำลังทำงานอยู่devtunnel host
• ป้องกันคอมพิวเตอร์เข้าสู่โหมดสลีป - กำหนดค่าระบบของคุณให้ไม่เข้าสู่โหมดสลีประหว่างการทดสอบ
• ระวังข้อผิดพลาดในการเชื่อมต่อ - ตรวจสอบ devtunnel host เอาต์พุตของเทอร์มินัลเพื่อหาข้อความตัดการเชื่อมต่อ
• รีสตาร์ทหลังจากเปลี่ยนเครือข่าย - หากคุณสลับเครือข่ายหรือเชื่อมต่อกับ VPN อีกครั้ง ให้รีสตาร์ท Tunnel

เคล็ดลับ

หาก Tunnel ของคุณตัดการเชื่อมต่อบ่อยครั้ง ให้ตรวจสอบการตั้งค่าเครือข่ายและกฎไฟร์วอลล์เพื่อให้แน่ใจว่าไม่ได้ปิดกั้นการเชื่อมต่อ

ล้างข้อมูล

เมื่อคุณเสร็จสิ้นการทดสอบด้วย Dev Tunnels:

หยุด Tunnel

กด Ctrl+C ในเทอร์มินัลที่กำลังรัน devtunnel host เพื่อหยุด Tunnel

คำสั่งนี้จะลบ URL Dev Tunnel ออกจากปลายทางรับส่งข้อความของเอเจนต์ของคุณ เมื่อคุณนำไปใช้งานจริง ให้ตั้งค่า URL ปลายทางที่โฮสต์บนคลาวด์

ธนบัตร

Tunnel จะยังคงพร้อมใช้งานสำหรับการใช้งานในอนาคตจนกว่าคุณจะลบออกอย่างเจาะจงโดยใช้ devtunnel delete <tunnel-id>

ข้อจำกัด

โปรดพิจารณาข้อจำกัดเหล่านี้เมื่อทดสอบกับ Dev Tunnels:

• การพัฒนาเท่านั้น: ใช้ Dev Tunnels สำหรับการพัฒนาและทดสอบ ไม่ใช่สำหรับการใช้งานจริง
• ประสิทธิภาพ: คาดว่าจะมีเวลาแฝงที่สูงขึ้นเมื่อเทียบกับเอเจนต์ที่โฮสต์บนคลาวด์เนื่องจากการกำหนดเส้นทางเครือข่าย
• ความเสถียรของการเชื่อมต่อ: การเชื่อมต่อ Tunnel อาจหลุดเป็นครั้งคราวและต้องรีสตาร์ทด้วยตนเอง
• ข้อควรพิจารณาด้านความปลอดภัย: แฟลก --allow-anonymous นี้สะดวกสำหรับการทดสอบ แต่ไม่ควรใช้กับข้อมูลที่ละเอียดอ่อน
• การจัดการเซสชัน: คุณอาจต้องตรวจสอบสิทธิ์อีกครั้งเป็นระยะ ๆ โดยขึ้นอยู่กับระยะเวลาของเซสชันของคุณ

ขั้นตอนถัดไป

หลังจากทดสอบ Dev Tunnel สำเร็จ:

• ปรับใช้เอเจนต์ของคุณไปยังระบบคลาวด์: ปรับใช้กับ Azure, ตั้งค่าจุดสิ้นสุดการส่งข้อความของเอเจนต์ใน AWS หรือ ตั้งค่าจุดสิ้นสุดการส่งข้อความของเอเจนต์ใน GCP
• กำหนดค่าปลายทางการส่งข้อความของเอเจนต์: ปลายทางการส่งข้อความของเอเจนต์
• ทำตามวงจรการพัฒนา: Agent 365 Development Lifecycle

กำลังแก้ไขปัญหา

หากคุณพบปัญหาในการทดสอบด้วย Dev Tunnels ให้เริ่มที่นี่: เพื่อดูวิธีแก้ไขปัญหา Tunnel การเชื่อมต่อ และปลายทางที่พบบ่อย สำหรับการแก้ไขปัญหา Agent 365 ที่เกี่ยวข้องกับการตั้งค่า การยืนยันตัวตน และการรับส่งข้อความ โปรดดู การแก้ไขปัญหา

การเชื่อมต่อ Tunnel ล้มเหลว

อาการ: Dev Tunnel ไม่เริ่มทำงานหรือตัดการเชื่อมต่อทันที

การแก้ไขปัญหา:

• ตรวจสอบว่าคุณเข้าสู่ระบบแล้ว: devtunnel user login
• ตรวจสอบว่ากระบวนการอื่นใช้พอร์ตเดียวกันหรือไม่
• ตรวจสอบว่าไฟร์วอลล์ของคุณอนุญาตให้เชื่อมต่อกับ Dev Tunnel
• ลบ Tunnel เดิมแล้วสร้างใหม่: devtunnel delete <tunnel-id> จากนั้นสร้าง Tunnel ใหม่

ข้อความไม่ถึงเอเจนต์ภายในเครื่อง

อาการ: Microsoft 365 ระบุว่าข้อความถูกส่ง แต่เอเจนต์ภายในเครื่องของคุณไม่ได้รับข้อความ

การแก้ไขปัญหา:

• ยืนยันว่าเอเจนต์ของคุณกำลังทำงานในเครื่อง
• ตรวจสอบว่า Tunnel เปิดใช้งานอยู่: devtunnel list ควรแสดง "เชื่อมต่อแล้ว"
• ตรวจสอบการกำหนดค่าปลายทางใน a365.config.json และยืนยันว่า Dev Tunnel URL ของคุณถูกตั้งค่าเป็นปลายทางการส่งข้อความ:
• ตรวจสอบบันทึก Dev Tunnel ในเทอร์มินัลที่กำลังรัน devtunnel host เพื่อหาข้อผิดพลาดในการเชื่อมต่อ
• ตรวจสอบให้แน่ใจว่าพอร์ตบนเครื่องของคุณตรงกับพอร์ตของ Tunnel (ทั้งสองควรเป็น 3978 ตามค่าเริ่มต้น)

ข้อผิดพลาดในการรับรองความถูกต้องผ่าน Dev Tunnel

อาการ: ข้อผิดพลาด 401 หรือ 403 เมื่อทดสอบผ่าน Dev Tunnel

การแก้ไขปัญหา:

• ตรวจสอบว่ามีการกำหนดค่าการรับรองความถูกต้องแบบเอเจนต์ (การรับรองความถูกต้องด้วย bearer token ไม่รองรับการใช้งานกับ Dev Tunnels สำหรับการเชื่อมต่อกับ Microsoft 365)
• ตรวจสอบข้อมูลประจำตัว Blueprint ของเอเจนต์ใน a365.generated.config.json
• ตรวจสอบว่าเอเจนต์ของคุณมีสิทธิ์ที่จำเป็นสำหรับการดำเนินการที่คุณกำลังทดสอบ
• ตรวจสอบว่าโทเค็นการรับรองความถูกต้องของคุณยังไม่หมดอายุ

Tunnel URL มีการเปลี่ยนแปลงหรือหมดอายุ

อาการ: URL Tunnel ที่เคยใช้งานได้ก่อนหน้านี้ไม่เชื่อมต่อกับเอเจนต์ของคุณอีกต่อไป

การแก้ไขปัญหา:

• ตรวจสอบสถานะ Tunnel โดยใช้ devtunnel list
• รีสตาร์ท Tunnel โดยใช้ devtunnel host <tunnel-id>
• อัปเดตปลายทางการส่งข้อความหาก URL เปลี่ยนแปลง โดยใช้ a365 setup blueprint --endpoint-only