本文介绍如何使用 Microsoft 365 Agents Toolkit 在 Visual Studio 中创建新的代理 SDK .NET 项目。
先决条件
Azure AI Foundry门户中的 Azure OpenAI 模型。 需要有关模型的以下数据：
- 名称
- 目标 URI
- 密钥
创建新项目
Agents Toolkit 提供了一个项目模板，可帮助你开始构建代理。 可以从工具包中的模板或代理 SDK 中的示例开始。 本文档重点介绍代理工具包中提供的模板。 可以使用不同的模板和选项通过工具包创建代理 SDK 项目。 本演练重点介绍如何使用语义内核和Azure AI Foundry创建天气代理。
注释
下面的过程目前仅适用于 .NET。
打开 Visual Studio，然后选择创建新项目。 搜索“代理”以查找使用 Microsoft 365 代理工具包和代理 SDK 的新模板，然后选择 Microsoft 365 代理>下一步。
此时会显示一个对话框，以便可以命名代理。 如果需要，还可以更改位置和解决方案名称。
完成后，选择“创建”
你可以选择工具包提供的几个不同选项来创建代理。
对于本演练，请选择 Weather Agent>Next 示例以使用Microsoft 365 智能体 SDK。 此预生成示例实现语义内核，用于协调 Azure AI Foundry 或 Azure OpenAI 模型的操作。 如果您希望在不使用模型或编排器的情况下开始操作，也可以使用“空智能体”示例。
对话框会提示你选择 LLM 服务。
对于本演练，请选择 Azure OpenAI。
可以在 模型和终结点下的 Azure AI Foundry 中找到此信息。
填写所需的输入：Azure OpenAI 服务密钥、Azure OpenAI 终结点和 Azure OpenAI 部署名称。
选择“创建”。 工具包为你从模板上创建项目。
在短时间内，应使用代理 SDK 创建新项目。
在 Microsoft 365 智能体测试平台中测试您的智能体
若要开始，可以在工具包中使用 Microsoft 365 Agents Playground 本地测试。
若要开始测试，请将项目中的调试目标设置为 Microsoft 365 Agents Playground。
测试平台将在新浏览器窗口中打开，供您使用本地主机进行测试，并显示已准备就绪的测试平台。 开始向代理发送消息以测试其行为。
在 Microsoft Teams 或 智能 Microsoft 365 Copilot 副驾驶® 中调试和测试代理
还可以将调试目标设置为直接在 Microsoft Teams 或 智能 Microsoft 365 Copilot 副驾驶® 中。
从目标列表中选择一个调试选项作为调试目标。
切换到Microsoft Teams需要一些时间。 系统会提示在打开的 Teams 客户端中添加代理。
选择 “添加”。 将显示一个通知窗格，指示已成功添加代理。
在新的代理程序上选择打开以在 Teams 中打开。 可以直接在 Teams 中询问代理问题。 您可以设置断点，以便在需要时逐步调试您的体验。
总结
您现在已经成功完成以下任务：
- 使用 Agents Toolkit 启动新的 Microsoft 365 代理项目和代理
- 使用 Microsoft 365 Agents Playground 在本地测试代理
- 在 Teams 或 Microsoft 365 频道中直接部署了用于调试的代理