通过

使用 Microsoft 365 代理工具包在 Visual Studio 中创建 .NET 代理

本文介绍如何使用 Microsoft 365 Agents Toolkit 在 Visual Studio 中创建新的代理 SDK .NET 项目。

注释

在开始之前，需要安装适用于 Visual Studio 的 Agents Toolkit 扩展 。

创建新项目

Agents Toolkit 提供了一个项目模板，可帮助你开始构建代理。 可以从工具包中的模板或代理 SDK 中的示例开始。 本文档重点介绍代理工具包中提供的模板。

注释

下面的过程目前仅适用于 .NET。

  1. 若要生成新的代理项目，请打开 Visual Studio 并选择“ 创建新项目”。 搜索“代理”以使用 Microsoft 365 代理工具包和代理 SDK 查找新模板，接下来选择>。

    创建新项目

    此时会显示一个对话框，以便可以命名代理。 如果需要，还可以更改位置和解决方案名称。

  2. 完成后，选择“下一步”

    配置新项目

  3. 下一个对话框会提示你选择代理类型。 你可以选择工具包提供的几个不同选项来创建代理。 若要使用 Microsoft 365 代理 SDK，应选择 天气代理 示例。 此预生成示例实现语义内核，以便通过 Azure AI Foundry 或 Azure OpenAI 模型进行业务流程。 如果想要在未设置模型或业务流程协调程序的情况下开始使用空代理示例，也可以使用空代理示例。

    选择要创建的应用类型

    选择要用于模型的 llm 类型

  4. 对于本演练，请选择 Azure AI Foundry 并完成所需的输入。 包括密钥、终结点和部署名称。 可以在 模型和终结点下的 Azure AI Foundry 中找到此信息。

    配置设置以连接到所选 LLM 服务

  5. 选择 创建。 该工具包从模板创建项目，可供你开始使用。

  6. 在短时间内，应创建一个利用代理 SDK 的新项目。

    编辑器中的应用代码

在 Microsoft 365 代理场中测试代理

若要开始，可以在工具包中使用 Microsoft 365 代理场在本地进行测试。

若要开始测试，请选择项目中的调试目标 以Microsoft 365 Agents Playground。

此时会打开场，以便使用本地主机在新浏览器窗口中进行测试，并显示已准备好测试的场。 开始向代理发送消息以测试其行为。

在 Microsoft Teams 或 Microsoft 365 Copilot 中调试和测试代理

还可以将调试目标设置为直接在 Microsoft Teams 或 Microsoft 365 Copilot 中。

  1. 从目标列表中选择一个调试选项作为调试目标。

    选择 Microsoft Teams （浏览器）

    Microsoft Teams 需要一些时间。 系统会提示在打开的 Teams 客户端中添加代理。

    Teams 提示添加代理

  2. 选择 “添加”。 将显示一个通知窗格，指示已成功添加代理。

    代理已成功添加到 Teams，提示打开

  3. 在新的代理上 选择“打开 ”以在 Teams 中打开。 可以直接在 Teams 中询问代理的问题。 可以设置断点，以便在需要时完成调试体验。

    在 M365 Copilot 中运行的代理

概要

现已成功：

  • 使用 Agents Toolkit 启动新的 Microsoft 365 代理项目和代理
  • 使用 Microsoft 365 代理场在本地测试代理
  • 在 Teams 或 Microsoft 365 频道中直接部署了用于调试的代理