通过

在 Microsoft 365 代理工作区中本地测试你的代理

如何在本地测试代理的详细信息取决于如何创建代理。

可以通过三种方式使用 Microsoft 365 代理 SDK 创建代理：

  • 从示例克隆并在 IDE 中打开
  • 从 C#、JS 或 Python 中的 Microsoft 365 代理工具包开始，使用 Visual Studio 或 Visual Studio Code
  • 使用 CLI，如快速入门中所示

使用 Microsoft 365 代理演练平台

你已使用工具包启动项目

如果您从工具包开始，所有设置都已完成，您可以直接使用智能体操场进行测试。 可以在本地或 Microsoft 365 Copilot 或 Microsoft Teams 中测试 Agents Playground。 Visual Studio Code 指南和 Visual Studio 指南分别介绍了这个场景。

通过克隆或命令行界面开始您的项目

如果使用 CLI 或克隆示例并在 IDE 中打开示例来启动项目，则可以使用本地 Agents Playground 进行测试。 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. 创建快速入门智能体或从存储库克隆示例后，您可以将其与智能体操场一起使用。

  2. Agents Playground 支持匿名模式和经过身份验证的模式。 对于匿名测试，无需其他配置。 如果要使用身份验证进行测试，则需要为 Agents Playground（下面提供了选项）和应用程序配置Microsoft Entra ID 应用注册。 有关信息，请参阅预配要与智能体 SDK 结合使用的 Azure 机器人。

  3. 在应用中正确配置端口。 选择代理的可用端口（默认值为 3978，但可以是任何可用端口）。

  4. 运行代码。

  5. 打开智能体操场，从智能体的终结点开始：

    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：通道类型（例如，、emulatorwebchat、msteams）。 每个通道提供不同的用户体验和活动属性。
    • --client-id：用于身份验证的客户端 ID
    • --client-secret：用于身份验证的客户端密码
    • --tenant-id：用于身份验证的租户 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 代理工具包开始。 该工具包使入门、在本地测试以及部署 更简单、更快。 它简化了 Azure Bot 服务和 Azure 应用程序注册的许多手动配置工作，因此您不必亲自执行这些操作。 通过手动启动，必须自行执行这些手动步骤。

Summary

从 GitHub 存储库或 CLI 中的克隆示例开始时，您已使用 Microsoft 365 智能体操场在本地成功测试了 Microsoft 365 智能体 SDK。

  • Last updated on