ทดสอบเอเจนต์ภายในเครื่องของคุณใน Microsoft 365 Agents Playground

รายละเอียดของวิธีการทดสอบเอเจนต์ภายในเครื่องของคุณจะขึ้นอยู่กับวิธีที่คุณสร้างเอเจนต์ของคุณ

คุณสามารถสร้างเอเจนต์โดยใช้ SDK เอเจนต์สำหรับ Microsoft 365 ได้สามวิธี:

• เริ่มต้นด้วย Microsoft 365 Agents Toolkit ใน C#, JavaScript หรือ Python โดยใช้ Visual Studio หรือ Visual Studio Code
• โคลนโครงการตัวอย่างและเปิดใน IDE ของคุณ
• ใช้ CLI

เริ่มโครงการของคุณด้วยชุดเครื่องมือ

หากคุณเริ่มต้นใช้งาน Agents Toolkit ทุกอย่างจะพร้อมสำหรับการทดสอบใน Agents Playground ทันที คุณสามารถทดสอบใน Agents Playground ได้ทั้งในเครื่อง หรือใน Microsoft 365 Copilot หรือ Microsoft Teams สถานการณ์นี้มีรายละเอียดใน:

• การแนะนำ Visual Studio Code
• การแนะนำ Visual Studio

เริ่มโครงการของคุณด้วยการโคลนหรือด้วย CLI

หากคุณเริ่มโครงการโดยใช้ CLI หรือโคลนตัวอย่างและเปิดใน IDE คุณสามารถใช้ Agents Playground ในเครื่องเพื่อทดสอบได้ Agents Playground เชื่อมต่อกับโค้ดในเครื่องของคุณ

คุณสามารถติดตั้ง Agents Playground ได้โดยใช้หนึ่งในวิธีการต่อไปนี้:

ตัวเลือกที่ 1: ติดตั้งไบนารีแบบสแตนด์อโลน:

winget install agentsplayground

curl -s https://raw.githubusercontent.com/OfficeDev/microsoft-365-agents-toolkit/dev/.github/scripts/install-agentsplayground-linux.sh | bash

ตัวเลือกที่ 2: ติดตั้งโดยใช้ npm

• ติดตั้ง Node.js (หากยังไม่ได้ติดตั้ง): ดาวน์โหลดและติดตั้งเวอร์ชันล่าสุดของ Node.js จาก nodejs.org

• ติดตั้งแพคเกจ Agents Playground:

  สําหรับการติดตั้งทั้งหมด (แนะนํา):

  npm install -g @microsoft/m365agentsplayground
  

  สําหรับการติดตั้งเฉพาะโครงการ:

  npm install -D @microsoft/m365agentsplayground
  

ทดสอบเอเจนต์ของคุณ

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

2. Agents Playground รองรับทั้งโหมดไม่ระบุตัวตนและโหมดยืนยันตัวตน สำหรับการทดสอบแบบไม่ระบุชื่อ ไม่ต้องกำหนดค่าเพิ่มเติม หากคุณต้องการทดสอบด้วยการรับรองความถูกต้อง คุณต้องกำหนดการลงทะเบียนแอป Microsoft Entra ID ทั้งสำหรับ Agents Playground (มีตัวเลือกในข้อความถัดไป) และแอปพลิเคชันของคุณ สําหรับข้อมูล โปรดดู การจัดเตรียมใช้งาน Azure Bot เพื่อใช้กับ SDK เอเจนต์

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

4. เรียกใช้โค้ดของคุณ

5. เปิด Agents Playground และเริ่มต้นด้วยจุดเชื่อมต่อของเอเจนต์ของคุณ:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"
   

   กำหนดค่าการรับรองความถูกต้องหากเอเจนต์ของคุณจำเป็นต้องใช้:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"
   

   ตัวเลือกที่สำคัญ:

   • -e, --app-endpoint: URL จุดเชื่อมต่อของเอเจนต์ของคุณ (เช่น http://localhost:3978/api/messages)
   • -c, --channel-id: ประเภทช่องทาง (เช่น emulator, webchat และ msteams) แต่ละช่องทางให้ประสบการณ์ผู้ใช้และคุณสมบัติกิจกรรมที่แตกต่างกัน
   • --client-id: รหัสไคลเอ็นต์สําหรับการรับรองความถูกต้อง
   • --client-secret: ข้อมูลลับไคลเอ็นต์สำหรับการรับรองความถูกต้อง
   • --tenant-id: รหัสผู้เช่าสําหรับการรับรองความถูกต้อง

   ใช้ agentsplayground --help เพื่อดูรายการตัวเลือกทั้งหมดที่มี

   อีกวิธีหนึ่งคือ คุณสามารถใช้ตัวแปรสภาพแวดล้อมแทนตัวเลือก CLI หากระบุทั้งสองอย่าง ตัวเลือก CLI จะมีลําดับความสําคัญสูงกว่า

   export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
   export DEFAULT_CHANNEL_ID="emulator"
   export AUTH_CLIENT_ID="your-client-id"
   export AUTH_CLIENT_SECRET="your-client-secret"
   export AUTH_TENANT_ID="your-tenant-id"
   

   เมื่อเอเจนต์ของคุณเริ่มต้นแล้ว จะเปิดขึ้นตามที่เห็นในภาพต่อไปนี้ คุณสามารถถามคำถามและทดสอบเอเจนต์ของคุณในส่วนติดต่อสนามทดลอง

   

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

สรุป

คุณได้ทดสอบ SDK เอเจนต์สำหรับ Microsoft 365 ในเครื่องของคุณโดยใช้สนามทดลองเอเจนต์ Microsoft 365 โดยเริ่มต้นจากตัวอย่างที่โคลนจากที่เก็บ GitHub หรือจากการใช้ CLI