在 Microsoft 365 Agents Playground 中本機測試您的代理程式

如何在本機測試代理程式的詳細數據取決於您建立代理程式的方式。

您可以使用 Microsoft 365 Agents SDK，以三種方式建立代理程式：

• 從使用 Visual Studio 或 Visual Studio Code 開始，使用 C#、JavaScript 或 Python 的 Microsoft 365 代理工具包
• 從範例複製並在IDE 中開啟
• 使用命令列介面（CLI）

從工具包開始你的專案

如果你從 Agents Toolkit 開始，就能立刻使用 Agents Playground 測試所有東西。 你可以在本地的代理遊玩場測試，或是在 Microsoft 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（如果尚未安裝）：從 nodejs.org 下載並安裝最新的 Node.js。

• 安裝 Agents Playground 套件：

  用於全域安裝 (建議)：

  npm install -g @microsoft/m365agentsplayground
  

  針對專案特定的安裝：

  npm install -D @microsoft/m365agentsplayground
  

測試您的代理程式

1. 當你建立快速啟動代理或從倉庫複製樣本後，再用 Agents Playground 使用。

2. Agents 遊樂場同時支援匿名和已驗證模式。 匿名測試則不需要其他設定。 如果你想測試認證，你需要為 Agents Playground（以下文字中有提供選項）和你的應用程式設定 Microsoft Entra ID 應用程式註冊。 如需詳細資訊，請參閱佈建要與 Agents SDK 搭配使用的 Azure 機器人。

3. 請在您的應用程式中正確配置埠。 為你的代理選擇一個可用的埠口（預設是 3978，但你可以使用任何可用的埠口）。

4. 執行您的程式碼。

5. 開啟 Agents 遊樂場，然後從代理程式的端點開始：

   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： 你的代理的端點網址（例如 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 應用程式註冊的許多手動設定加以簡化，因此你不必自行處理。 若要手動啟動，您必須自行執行這些手動步驟。

Summary

你是透過使用 Microsoft 365 Agents Playground 在本地測試你的 Microsoft 365 Agents SDK。 你是從 GitHub 倉庫或 CLI 裡的克隆樣本開始的。