แชร์ผ่าน

ตัวแทนทดสอบที่ใช้ Microsoft Agent 365 SDK

สำคัญ

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

ทดสอบเอเจนต์ภายในเครื่องของคุณใน Agents Playground คู่มือนี้ครอบคลุมถึงการตั้งค่าสภาพแวดล้อมการพัฒนาของคุณ การกําหนดค่าการรับรองความถูกต้อง และการตรวจสอบฟังก์ชันการทํางานของตัวแทนของคุณด้วยเครื่องมือทดสอบ Agents Playground

เมื่อตัวแทนของคุณทํางานภายในเครื่องคุณสามารถ ปรับใช้และเผยแพร่ เพื่อทดสอบในแอปพลิเคชัน Microsoft 365 เช่น Teams

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

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

ข้อกําหนดเบื้องต้นทั่วไป

ข้อกําหนดเบื้องต้นเฉพาะภาษา

กําหนดค่าสภาพแวดล้อมการทดสอบตัวแทน

ส่วนนี้ครอบคลุมถึงการตั้งค่าตัวแปรสภาพแวดล้อม การรับรองความถูกต้องสภาพแวดล้อมการพัฒนาของคุณ และการเตรียมตัวแทนที่ขับเคลื่อนโดย Agent 365 ของคุณสําหรับการทดสอบ

การตั้งค่าสภาพแวดล้อมการทดสอบตัวแทนของคุณจะเป็นไปตามเวิร์กโฟลว์ตามลําดับ:

  1. กําหนดค่าสภาพแวดล้อม ของคุณ - สร้างหรืออัปเดตไฟล์การกําหนดค่าสภาพแวดล้อมของคุณ

  2. การกําหนดค่า LLM - รับคีย์ API และกําหนดค่าการตั้งค่า OpenAI หรือ Azure OpenAI

  3. กําหนดค่าการรับรองความถูกต้อง - ตั้งค่าการรับรองความถูกต้องแบบตัวแทน

  4. การอ้างอิง ตัวแปรสภาพแวดล้อม - กําหนดค่าตัวแปรสภาพแวดล้อมที่จําเป็น:

    1. ตัวแปรการรับรองความถูกต้อง
    2. การกําหนดค่าจุดสิ้นสุด MCP
    3. ตัวแปรการสังเกตได้
    4. การกําหนดค่าของเซิร์ฟเวอร์แอปพลิเคชันตัวแทน

หลังจากทําขั้นตอนเหล่านี้เสร็จแล้ว คุณก็พร้อมที่จะเริ่มทดสอบตัวแทนของคุณใน Agents Playground

ขั้นตอนที่ 5: กำหนดค่าสภาพแวดล้อม ของคุณ

ตั้งค่าไฟล์การกําหนดค่าของคุณ:

cp .env.template .env

หมายเหตุ

โปรดดูตัวอย่าง Microsoft Agent 365 SDK เพื่อค้นหาเทมเพลตการกําหนดค่าที่แสดงเขตข้อมูลที่จําเป็น

ขั้นตอนที่ 2: การกําหนดค่า LLM

กําหนดค่าการตั้งค่า OpenAI หรือ Azure OpenAI สําหรับการทดสอบภายในเครื่อง เพิ่มคีย์ API และจุดสิ้นสุดบริการที่ได้รับจากข้อกําหนดเบื้องต้นไปยังไฟล์การกําหนดค่าของคุณพร้อมกับพารามิเตอร์แบบจําลองใด ๆ

เพิ่มลงในไฟล์ของคุณ .env :

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

ตัวแปรสภาพแวดล้อม Python LLM

ตัวแปร Description ต้องมี ตัวอย่างเช่น
OPENAI_API_KEY API key สําหรับบริการ OpenAI สําหรับ OpenAI sk-proj-...
AZURE_OPENAI_API_KEY API Key สําหรับบริการ Azure OpenAI สําหรับ Azure OpenAI a1b2c3d4e5f6...
AZURE_OPENAI_ENDPOINT URL จุดสิ้นสุดบริการ Azure OpenAI สําหรับ Azure OpenAI https://your-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT ชื่อการปรับใช้ใน Azure OpenAI สําหรับ Azure OpenAI gpt-4
AZURE_OPENAI_API_VERSION เวอร์ชัน API สําหรับ Azure OpenAI สําหรับ Azure OpenAI 2024-02-15-preview

ขั้นตอนที่ 3: กําหนดค่าการรับรองความถูกต้องสําหรับการรับรองความถูกต้องข้อมูลประจําตัวของตัวแทน

ใช้คําสั่ง A365 CLI a365 config display เพื่อดึงข้อมูลข้อมูลประจําตัวของพิมพ์เขียวตัวแทนของคุณ

a365 config display -g

คําสั่งนี้แสดงการกําหนดค่าพิมพ์เขียวตัวแทนของคุณ ตั้งค่าดังต่อไปนี้:

ค่า รายละเอียด
agentBlueprintId ID ไคลเอ็นต์ของเจ้าหน้าที่ของคุณ
agentBlueprintClientSecret ข้อมูลลับไคลเอ็นต์ของเจ้าหน้าที่คุณ
tenantId รหัสผู้เช่ารหัส Microsoft Entra ของคุณ

ใช้ค่าเหล่านี้เพื่อกําหนดค่าการรับรองความถูกต้องตัวแทนในตัวแทนของคุณ:

เพิ่มการตั้งค่าต่อไปนี้ลงในไฟล์ของคุณ .env โดยแทนที่ค่าตัวแทนข้อความด้วยข้อมูลประจําตัวจริงของคุณ:

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>
ตัวแปร Description ต้องมี ตัวอย่างเช่น
USE_AGENTIC_AUTH เปิดใช้งานโหมดการรับรองความถูกต้องแบบตัวแทน ใข่ true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID ID ไคลเอ็นต์พิมพ์เขียวของตัวแทนจาก a365 config display -g ใข่ 12345678-1234-1234-1234-123456789abc
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET ความลับของไคลเอ็นต์พิมพ์เขียวของตัวแทนจาก a365 config display -g ใข่ abc~123...
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID ID ผู้เช่า Microsoft Entra จาก a365 config display -g ใข่ adfa4542-3e1e-46f5-9c70-3df0b15b3f6c

หมายเหตุ

สําหรับ .NET ตรวจสอบให้แน่ใจว่ามี USE_AGENTIC_AUTH=true การตั้งค่าใน launchSettings.json (ดู ขั้นตอนที่ 4: การอ้างอิงตัวแปรสภาพแวดล้อม)

ขั้นตอนที่ 2: ตัวแปรของสภาพแวดล้อม

ทําการตั้งค่าสภาพแวดล้อมของคุณให้เสร็จสมบูรณ์โดยการกําหนดค่าตัวแปรสภาพแวดล้อมที่จําเป็นต่อไปนี้:

  • ตัวแปร การรับรองความถูกต้อง - การตั้งค่าที่จําเป็นสําหรับการรับรองความถูกต้องของบริษัท
  • การกําหนดค่า จุดสิ้นสุด MCP - ระบุจุดสิ้นสุดแพลตฟอร์ม Agent 365
  • ตัวแปร การสังเกต - เปิดใช้งานการบันทึกและการติดตามแบบกระจาย
  • การกําหนดค่า ของเซิร์ฟเวอร์แอปพลิเคชันตัวแทน - กําหนดค่าพอร์ตที่เซิร์ฟเวอร์ตัวแทนของคุณรัน

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

กําหนดค่าการตั้งค่าตัวจัดการการรับรองความถูกต้องที่จําเป็นสําหรับการรับรองความถูกต้องแบบตัวแทนเพื่อให้ทํางานได้อย่างถูกต้อง

เพิ่มลงในไฟล์ของคุณ .env :

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION
ตัวแปร Description ต้องมี
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE ชนิดตัวจัดการการรับรองความถูกต้อง ใข่
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES ขอบเขตการรับรองความถูกต้องสําหรับ Microsoft Graph ใข่
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME ชื่อการเชื่อมต่อพิมพ์เขียวสํารอง ใข่
CONNECTIONSMAP_0_SERVICEURL รูปแบบ URL บริการสําหรับการแมปการเชื่อมต่อ ใข่
CONNECTIONSMAP_0_CONNECTION ชื่อการเชื่อมต่อสําหรับการแมป ใข่

การกําหนดค่าจุดสิ้นสุด MCP

การกําหนดค่าปลายทาง MCP (Model Context Protocol) จําเป็นต้องระบุจุดสิ้นสุดของแพลตฟอร์ม Agent 365 ที่ตัวแทนของคุณควรเชื่อมต่อ เมื่อคุณสร้างรายการเครื่องมือที่กําหนด เซิร์ฟเวอร์ เครื่องมือสําหรับตัวแทนของคุณ คุณต้องระบุจุดสิ้นสุดของแพลตฟอร์ม MCP จุดสิ้นสุดนี้จะกําหนดว่าเซิร์ฟเวอร์เครื่องมือ MCP เชื่อมต่อกับ สภาพแวดล้อม (เตรียมการผลิต การทดสอบ หรือการผลิต) เซิร์ฟเวอร์เครื่องมือ MCP ที่เชื่อมต่อกับ สําหรับความสามารถในการรวม Microsoft 365

เพิ่มลงในไฟล์ของคุณ .env :

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>
ตัวแปร Description ต้องมี ค่าเริ่มต้น ตัวอย่างเช่น
MCP_PLATFORM_ENDPOINT URL จุดสิ้นสุดของแพลตฟอร์ม MCP (เตรียมไว้ ทดสอบ หรือ prod) ไม่ ปลายทางการผลิต

สิ่งสําคัญ: ถ้า MCP_PLATFORM_ENDPOINT ไม่ได้ระบุ จะใช้ค่าเริ่มต้นเป็นจุดสิ้นสุดการผลิต

ตัวแปรการสังเกตได้

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

หมายเหตุ

การกําหนดค่าความสามารถในการสังเกตได้เหมือนกันในทุกภาษา

ตัวแปร รายละเอียด ค่าเริ่มต้น ตัวอย่างเช่น
ENABLE_A365_OBSERVABILITY ความสามารถในการสังเกตการณ์เปิด/ปิดใช้งาน false true
ENABLE_A365_OBSERVABILITY_EXPORTER ส่งออกการติดตามไปยังบริการที่สังเกตได้ false true
OBSERVABILITY_SERVICE_NAME ชื่อบริการสําหรับการติดตาม ชื่อเจ้าหน้าที่ my-agent-service
OBSERVABILITY_SERVICE_NAMESPACE Namespace ของ Azure Service Bus agent365-samples my-company-agents

การกําหนดค่าของเซิร์ฟเวอร์แอปพลิเคชันตัวแทน

กําหนดค่าพอร์ตที่เซิร์ฟเวอร์แอปพลิเคชันตัวแทนของคุณทํางาน ซึ่งเป็นตัวเลือกและนําไปใช้กับตัวแทน Python และ JavaScript

เพิ่มลงในไฟล์ของคุณ .env :

# Server Configuration
PORT=3978
ตัวแปร Description ต้องมี ค่าเริ่มต้น ตัวอย่างเช่น
PORT หมายเลขพอร์ตที่เซิร์ฟเวอร์ของบริษัทตัวแทนทํางาน ไม่ 3978 3978

ติดตั้งการขึ้นต่อกันและเริ่มเซิร์ฟเวอร์แอปพลิเคชันของบริษัทตัวแทน

เมื่อกําหนดค่าสภาพแวดล้อมของคุณแล้ว คุณจําเป็นต้องติดตั้งการขึ้นต่อกันที่จําเป็นและเริ่มต้นเซิร์ฟเวอร์แอปพลิเคชันของบริษัทตัวแทนสําหรับการทดสอบภายในเครื่องของคุณ

ติดตั้งการขึ้นต่อกัน

uv pip install -e .

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

เริ่มเซิร์ฟเวอร์แอปพลิเคชันของบริษัทตัวแทน

python <main.py>

แทนที่ <main.py> ด้วยชื่อของไฟล์ Python หลักของคุณที่ประกอบด้วยจุดเข้าใช้งานสําหรับแอปพลิเคชันตัวแทนของคุณ (ตัวอย่างเช่น start_with_generic_host.py, app.pyหรือ main.py)

หรือใช้ uv:

uv run python <main.py>

ตอนนี้เซิร์ฟเวอร์ตัวแทนของคุณควรทํางานและพร้อมที่จะรับคําขอจากแอปพลิเคชัน Agents Playground หรือ Microsoft 365

ตัวแทนทดสอบใน Agents Playground

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

เปิดเทอร์มินัลใหม่ (PowerShell บน Windows) และเริ่ม Agents Playground:

agentsplayground

การดําเนินการนี้จะเปิดเว็บเบราว์เซอร์ด้วยอินเทอร์เฟซ Agents Playground เครื่องมือจะแสดงอินเทอร์เฟซการสนทนาที่คุณสามารถส่งข้อความไปยังตัวแทนของคุณได้

การทดสอบพื้นฐาน

เริ่มต้นด้วยการตรวจสอบว่ามีการกําหนดค่าตัวแทนของคุณอย่างถูกต้อง ส่งข้อความถึงตัวแทน:

What can you do?

เจ้าหน้าที่ควรตอบกลับตามคําแนะนําที่กําหนดค่าไว้ โดยขึ้นอยู่กับพร้อมท์และความสามารถของระบบของบริษัทตัวแทนของคุณ การดําเนินการนี้จะยืนยันว่า:

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

การเรียกใช้เครื่องมือทดสอบ

หลังจากกําหนดค่าเซิร์ฟเวอร์เครื่องมือ MCP ของคุณใน toolingManifest.json (ดู เครื่องมือ สําหรับคําแนะนําในการตั้งค่า) ให้เรียกใช้เครื่องมือทดสอบด้วยตัวอย่างดังนี้:

ก่อนอื่น ตรวจสอบว่าเครื่องมือใดพร้อมใช้งาน:

List all tools I have access to

จากนั้นทดสอบการเรียกใช้เครื่องมือเฉพาะ:

เครื่องมือจดหมาย

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

คําตอบที่คาดหวัง: ตัวแทนส่งอีเมลโดยใช้เซิร์ฟเวอร์ MCP จดหมาย และยืนยันการส่งข้อความที่ถูกส่ง

เครื่องมือปฏิทิน

List my calendar events for today

คําตอบที่คาดหวัง: ตัวแทนจะเรียกใช้และแสดงเหตุการณ์ในปฏิทินของคุณสําหรับวันปัจจุบัน

เครื่องมือ SharePoint

List all SharePoint sites I have access to

การตอบสนองที่คาดไว้: ตัวแทนคิวรี SharePoint และส่งกลับรายการของไซต์ที่คุณมีสิทธิ์เข้าถึง

คุณสามารถดูการเรียกเครื่องมือใน:

  • หน้าต่าง แชท - ดูการตอบสนองของเจ้าหน้าที่และเรียกใช้เครื่องมือใด ๆ
  • แผง รายการบันทึก - ดูข้อมูลกิจกรรมโดยละเอียด รวมถึงพารามิเตอร์เครื่องมือและการตอบกลับ

ทดสอบด้วยกิจกรรมการแจ้งเตือน

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

ก่อนที่จะทดสอบกิจกรรมการแจ้งเตือน ตรวจสอบให้แน่ใจว่าคุณมี:

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

วิธีการส่งกิจกรรมแบบกําหนดเอง:

  1. เริ่มต้นเจ้าหน้าที่และเจ้าหน้าที่ Playground ของคุณ
  2. ใน Agents Playground นําทางไปยังจําลองกิจกรรมแบบกําหนดเองของกิจกรรม>
  3. conversationIdคัดลอกจากกิจกรรม (ID การสนทนาเปลี่ยนแต่ละครั้งที่มีการรีสตาร์ต Agents Playground)
  4. วางกิจกรรมแบบกําหนดเองของคุณ JSON และอัปเดต personal-chat-id เขตข้อมูลด้วย ID การสนทนาที่คุณคัดลอก อ้างอิงไปยังตัวอย่างการแจ้งเตือนทางอีเมล
  5. เลือก เพิ่มกิจกรรม
  6. ดูผลลัพธ์ในทั้งการสนทนาการสนทนาและแผงบันทึก

การแจ้งเตือนอีเมล์

ซึ่งจะจําลองอีเมลที่ส่งไปยังตัวแทน แทนที่ค่าตัวแทนข้อความด้วยรายละเอียดของบริษัทตัวแทนจริงของคุณ:

{
  "type": "message",
  "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "timestamp": "2025-09-24T17:40:19+00:00",
  "serviceUrl": "http://localhost:56150/_connector",
  "channelId": "agents",
  "name": "emailNotification",
  "from": {
    "id": "manager@contoso.com",
    "name": "Agent Manager",
    "role": "user"
  },
  "recipient": {
    "id": "agent@contoso.com",
    "name": "Agent",
    "agenticUserId": "<your-agentic-user-id>",
    "agenticAppId": "<your-agent-app-id>",
    "tenantId": "<your-tenant-id>"
  },
  "conversation": {
    "conversationType": "personal",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "personal-chat-id"
  },
  "membersAdded": [],
  "membersRemoved": [],
  "reactionsAdded": [],
  "reactionsRemoved": [],
  "locale": "en-US",
  "attachments": [],
  "entities": [
    {
      "id": "email",
      "type": "productInfo"
    },
    {
      "type": "clientInfo",
      "locale": "en-US",
      "timezone": null
    },
    {
      "type": "emailNotification",
      "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "conversationId": "personal-chat-id",
      "htmlBody": "<body dir=\"ltr\">\n<div class=\"elementToProof\" style=\"font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);\">\nYour email message content here</div>\n\n\n</body>"
    }
  ],
  "channelData": {
    "tenant": {
      "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
    }
  },
  "listenFor": [],
  "textHighlights": []
}

ดูบันทึกความสามารถในการสังเกตการณ์

หากต้องการดูบันทึกการสังเกตในระหว่างการพัฒนาในท้องถิ่น เครื่องมือตัวแทนของคุณที่มีรหัสการสังเกตได้ (ดู การสังเกต สําหรับตัวอย่างโค้ด) และกําหนดค่าตัวแปรสภาพแวดล้อมตามที่อธิบายไว้ใน ตัวแปรการสังเกตได้ เมื่อกําหนดค่าแล้ว การติดตามแบบเรียลไทม์จะปรากฏในคอนโซลที่แสดง:

  • การติดตามการเรียกใช้ตัวแทน
  • รายละเอียดการดำเนินการ
  • การเรียกการอนุมาน LLM
  • ข้อความอินพุตและเอาท์พุต
  • การใช้โทเค็น
  • เวลาในการตอบสนอง
  • ข้อมูลข้อผิดพลาด

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

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

ส่วนนี้มีโซลูชันสําหรับปัญหาทั่วไปที่คุณอาจพบเมื่อทดสอบตัวแทนภายในเครื่องของคุณ

ปัญหาการเชื่อมต่อและสภาพแวดล้อม

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

ปัญหาการเชื่อมต่อของ Playground ของตัวแทน

อาการ: เจ้าหน้าที่ Playground ไม่สามารถเชื่อมต่อกับเจ้าหน้าที่ของคุณได้

โซลูชัน

  • ตรวจสอบว่าเซิร์ฟเวอร์ของบริษัทตัวแทนกําลังทํางานอยู่
  • ตรวจสอบว่าหมายเลขพอร์ตตรงกับตัวแทนและ Agents Playground ของคุณหรือไม่
  • ตรวจสอบให้แน่ใจว่าไม่มีกฎไฟร์วอลล์ที่บล็อกการเชื่อมต่อภายในเครื่อง
  • ลองรีสตาร์ตทั้งตัวแทนและตัวแทน Playground

เวอร์ชันของ Outdated Agents Playground

อาการ: ข้อผิดพลาดที่ไม่คาดคิดหรือคุณลักษณะที่ขาดหายไปใน Agents Playground

วิธีแก้ไข: ถอนการติดตั้งและติดตั้ง Agents Playground ใหม่:

winget uninstall agentsplayground
winget install agentsplayground

ความขัดแย้งของพอร์ต

อาการ: ข้อผิดพลาดที่ระบุว่ามีการใช้งานพอร์ตอยู่แล้ว

โซลูชัน

  • หยุดอินสแตนซ์อื่น ๆ ของเจ้าหน้าที่ของคุณ
  • เปลี่ยนพอร์ตในการกําหนดค่าของคุณ
  • ฆ่ากระบวนการใดๆ โดยใช้พอร์ต:
# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

ไม่สามารถเพิ่ม DeveloperMCPServer

อาการ: ข้อผิดพลาดเมื่อพยายามเพิ่ม DeveloperMCPServer ใน VS Code

วิธีแก้ไข: ปิดและเปิด Visual Studio Code ใหม่ จากนั้นลองเพิ่มเซิร์ฟเวอร์อีกครั้ง

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

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

โทเค็นแบเรอร์หมดอายุแล้ว

อาการ: ข้อผิดพลาดในการรับรองความถูกต้องหรือการตอบสนองโดยไม่ได้รับอนุญาต 401

วิธีแก้ไข: โทเค็นแบเรอร์จะหมดอายุหลังจากประมาณ 1 ชั่วโมง รับโทเค็นใหม่และอัปเดตการกําหนดค่าของคุณ

ข้อผิดพลาดในการรับรองความถูกต้องของตัวแทนใน Python

อาการ: ข้อผิดพลาดที่รับโทเค็นอินสแตนซ์ของตัวแทน

วิธีแก้ไข: ตรวจสอบ ALT_BLUEPRINT_NAME การตั้งค่าใน .env:

# Change from:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection

# To:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION

ปัญหาเกี่ยวกับเครื่องมือและการแจ้งเตือน

ปัญหาเหล่านี้เกี่ยวข้องกับปัญหาจากการเรียกใช้เครื่องมือ การโต้ตอบกับเซิร์ฟเวอร์ MCP และการส่งมอบการแจ้งเตือน

ไม่ได้รับอีเมล

อาการ: ตัวแทนระบุว่ามีการส่งอีเมล แต่คุณไม่ได้รับอีเมล

โซลูชัน

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

การตอบกลับข้อคิดเห็นของ Word ไม่ทํางาน

ปัญหาที่ทราบแล้ว: บริการแจ้งเตือนไม่สามารถตอบกลับข้อคิดเห็นของ Word ได้โดยตรง กําลังพัฒนาฟังก์ชันการทํางานนี้

การรับความช่วยเหลือ

ถ้าคุณพบปัญหาไม่ได้ครอบคลุมในส่วนการแก้ไขปัญหานี้ ให้สํารวจแหล่งข้อมูลเหล่านี้:

ที่เก็บ Microsoft Agent 365 SDK

การสนับสนุนเพิ่มเติม

  • ตรวจทานโค้ดตัวอย่างและเอกสารใน ที่เก็บ Microsoft Agent 365 SDK
  • ส่งปัญหาผ่านปัญหา GitHub ในที่เก็บที่เกี่ยวข้อง

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

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

  • ปรับใช้และเผยแพร่ตัวแทน: เรียนรู้วิธีปรับใช้ตัวแทนของคุณกับ Azure Web App และเผยแพร่ไปยังศูนย์การจัดการ Microsoft ทําให้พร้อมใช้งานสําหรับองค์กรของคุณเพื่อค้นหาและจ้างใน Microsoft 365
  • Last updated on