สร้างตัวแทน JavaScript ใน Visual Studio Code ด้วยชุดเครื่องมือตัวแทน Microsoft 365

ในบทความนี้ คุณจะได้เรียนรู้วิธีการสร้างโครงการ Agents SDK JavaScript ใหม่ใน Visual Studio โดยใช้ชุดเครื่องมือตัวแทน Microsoft 365

Prerequisites

สร้างโครงการใหม่

ชุดเครื่องมือตัวแทนมีเทมเพลตโครงการเพื่อช่วยให้คุณเริ่มต้นกับการสร้างตัวแทน คุณสามารถเริ่มต้นจากเทมเพลตในชุดเครื่องมือหรือจากตัวอย่างใน Agents SDK

Note

ขั้นตอนที่ตามมาในขณะนี้ใช้ได้กับ JavaScript และ TypeScript เท่านั้น การสนับสนุนมีการวางแผนไว้สําหรับ Python

  1. ใน Visual Studio Code ให้เปิดแผงส่วนขยาย Microsoft 365 Agents Toolkit โดยการเลือกไอคอน Microsoft 365 Agents บนแถบด้านข้าง

  2. สร้างโครงการตัวแทนใหม่ โดยเลือกสร้างตัวแทน/แอปใหม่ คุณสามารถเริ่มต้นจากเทมเพลตในชุดเครื่องมือหรือจากตัวอย่างใน Agents SDK คู่มือนี้ครอบคลุมการเริ่มต้นด้วย Agents Toolkit

หน้าเริ่มต้นของส่วนขยายชุดเครื่องมือตัวแทน

  1. เริ่มต้นด้วยการสร้างตัวแทนด้วย SDK ตัวแทน เลือก ตัวแทนโปรแกรมแบบกําหนดเอง:

เลือกชนิดตัวแทนที่จะสร้าง

สร้างตัวแทนใหม่

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

คุณมีสองเทมเพลตที่จะเลือกจาก:

  • ตัวแทนโปรแกรมแบบกําหนดเองพื้นฐาน
  • เจ้าหน้าที่สภาพอากาศ

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

เลือกเทมเพลต

  1. ในตัวอย่างนี้ เลือก Weather Agent เพื่อสร้างตัวแทนที่ใช้ LangChain และ Azure AI Foundry โดยขึ้นอยู่กับภาษาที่คุณเลือก

คุณได้รับการขอให้เลือกบริการ LLM

  1. เลือก Azure OpenAI สําหรับแบบจําลองของคุณ

    เลือก Azure OpenAI สําหรับ LLM

    คุณจะต้องป้อน Key, Target URI และ Name ของโมเดล Azure OpenAI ของคุณจากพอร์ทัล Microsoft Foundry คุณสามารถค้นหาข้อมูลเหล่านี้ได้ใน ทรัพย์สินของฉัน และ โมเดลและเอ็นด์พอยต์ ในพอร์ทัล Foundry

  2. ป้อนรายละเอียดแบบจําลอง โดยเริ่มต้นด้วย Azure คีย์บริการ OpenAI

    ป้อนคีย์ Azure OpenAI เพื่อรับรองความถูกต้อง

  3. เลือก JavaScript หรือ TypeScript เลือก โฟลเดอร์ค่าเริ่มต้น และป้อนชื่อ แอปพลิเคชัน เพื่อจัดเก็บโฟลเดอร์รากของโครงการของคุณในตําแหน่งที่ตั้งเริ่มต้น

    โครงการใหม่ของคุณเปิดขึ้น

    มุมมองของไฟล์สําหรับโครงการที่สร้างขึ้นใหม่

  4. ยืนยันว่าคุณลงชื่อเข้าใช้ด้วยส่วนขยายโดยการเลือกโลโก้ Microsoft 365 บนแถบเครื่องมือใน Visual Studio Code ตรวจสอบให้แน่ใจว่าคุณได้ลงชื่อเข้าใช้ผู้เช่าที่คุณต้องการเชื่อมต่อ

    ดูบัญชีและลงชื่อเข้าใช้

ดีบักและทดสอบเจ้าหน้าที่ของคุณใน Agents Playground

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

  1. เลือก ดีบักใน Microsoft 365 Agents Playground

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

    เลือกดีบักใน Microsoft 365 Agents Playground

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

    ดูที่รหัสเทมเพลตที่สร้างขึ้น

  3. เมื่อ Plaground สำหรับการดีบักและการทดสอบโหลดเสร็จแล้ว เบราว์เซอร์จะเปิดขึ้นและคุณก็พร้อมที่จะโต้ตอบกับเอเจนต์ของคุณโดยใช้ Playground หากคุณทําตามคําแนะนําและใช้เทมเพลตจัดทําสําเร็จด้วย LangChain และ Azure AI Foundry คุณสามารถถามว่า "สภาพอากาศใน {location} ในวันพรุ่งนี้คืออะไร" ตัวแทนตอบสนองด้วยอะแดปทีฟการ์ดด้วยสภาพอากาศโดยใช้บริการ AI ที่คุณเลือก

    ดีบักแอปในเครื่องมือทดสอบแอปของ Teams

    เครื่องมือทดสอบแอปของ Teams พร้อมอะแดปทีฟการ์ดในการแชท

ดีบักและทดสอบเอเจนต์ของคุณใน Microsoft Copilot

เมื่อคุณทดสอบเสร็จใน Agents Playground คุณสามารถติดตั้งไปยัง Azure Bot Service และกําหนดค่าสําหรับช่อง Microsoft Copilot ได้ ตรวจสอบให้แน่ใจว่าคุณเข้าสู่ระบบ tenant ที่มีสิทธิ์เข้าถึง Microsoft Copilot

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

    เลือกเพื่อทำการดีบักใน Copilot (Edge)

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

    ทดสอบและดีบักใน Microsoft Copilot

Summary

ตอนนี้คุณทําสําเร็จแล้ว:

  • เริ่มต้นโครงการและตัวแทนของ Microsoft 365 ใหม่โดยใช้ชุดเครื่องมือตัวแทน
  • ทดสอบตัวแทนภายในเครื่องโดยใช้ Microsoft 365 Agents Playground
  • ปรับใช้เอเจนต์สำหรับการดีบักโดยตรงในช่องทาง Microsoft 365