共用方式為

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

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

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

  • 從範例複製並在IDE 中開啟
  • 從 C#、JS 或 Python 中的 Microsoft 365 Agents Toolkit 開始，使用 Visual Studio 或 Visual Studio Code
  • 使用 CLI，如快速入門指南所示

使用 Microsoft 365 代理程式遊樂場

您已使用工具組啟動專案

如果您從工具組開始，則所有環境都已設定，可以立即使用 Agents Playground 進行測試。 您可以在 Agents 遊樂場中進行本機測試，也可以在 Microsoft 365 Copilot 或 Microsoft Teams 中進行測試。 此案例分別在 Visual Studio Code 逐步解說和 Visual Studio 逐步解說中探討。

您藉由複製或 CLI 啟動專案

如果您使用 CLI 啟動專案，或藉由複製範例並在 IDE 中開啟範例，您可以使用本機 Agents 遊樂場進行測試。 Agents Playground 會連線到您的本地程式碼。

您可以使用下列其中一種方法來安裝 Agents Playground：

選項 1：安裝獨立二進位檔
winget install agentsplayground
選項 2：使用 npm 安裝

  • 安裝 Node.js（如果尚未安裝）：從 nodejs.org 下載並安裝最新的 Node.js。

  • 安裝 Agents Playground 套件：

    用於全域安裝 (建議)：

    npm install -g @microsoft/m365agentsplayground

    針對專案特定的安裝：

    npm install -D @microsoft/m365agentsplayground

  1. 建立快速入門代理程式或從存放庫複製範例之後，您就可以將它與 Agents 遊樂場搭配使用。

  2. Agents 遊樂場同時支援匿名和已驗證模式。 針對匿名測試，不需要額外的設定。 如果您要使用驗證進行測試，您必須為 Agents 遊樂場 (選項如下) 和您的應用程式設定 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：代理程式的端點 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 代理程式遊樂場

在可能的情況下，建議您從 Microsoft 365 Agents Toolkit 開始。 此工具組可讓您在本機開始、測試，以及 更輕鬆地部署。 它會抽象化 Azure Bot Service 和 Azure 應用程式註冊的手動設定，因此您不需要這麼做。 若要手動啟動，您必須自行執行這些手動步驟。

Summary

開始使用從 GitHub 存放庫或 CLI 複製的範例時，您已成功使用 Microsoft 365 Agents 遊樂場在本機測試 Microsoft 365 Agents SDK。

  • Last updated on