本文介绍如何使用 Microsoft 365 Agents Toolkit 在 Visual Studio 中创建新的代理 SDK JavaScript 项目。
先决条件
安装适用于 Visual Studio Code 的 Agents Toolkit 扩展。
需要 Azure AI Foundry 门户中的 Azure 模型。 需要有关模型的此数据：
- 名称
- 目标 URI
- 密钥
创建新项目
Agents Toolkit 提供了一个项目模板，可帮助你开始构建代理。 可以从工具包中的模板或代理 SDK 中的示例开始。
注释
下面的过程目前仅适用于 JavaScript 和 TypeScript。 计划对 Python 提供支持。
可以通过在 Microsoft 365 代理工具包中选择“ 创建新代理/应用 ”来生成新的代理项目。 可以从工具包中的模板或代理 SDK 中的示例开始。 本指南介绍从代理工具包开始。
若要从使用代理 SDK 生成代理开始，请从第一个菜单中选择 自定义引擎代理 ：
创建新代理
选择自定义引擎代理作为选项后，系统会引导你完成一系列提示，以添加你自己的 AI 服务。
有两个模板可供选择： 基本自定义引擎代理 或 天气代理。 基本自定义引擎代理是一个不包含任何预建内容的代理。 需要添加 AI 协调器，例如语义内核或 LangChain，以及你的专业知识。
在此示例中，选择 “天气代理 ”以创建使用 LangChain 和 Azure AI Foundry 的代理，具体取决于所选语言。
为模型选择 Azure OpenAI 。
系统会从 Azure AI Foundry 门户提示输入 密钥、 目标 URI 和 Azure 模型 的名称 。 可以在 Foundry 门户中 的“我的资产 ”和 “模型”和“终结点 ”下找到这些信息。
输入详细信息，从 密钥开始：
选择 JavaScript 或 TypeScript，选择 “默认”文件夹，然后输入 应用程序名称 以将项目根文件夹存储在默认位置。
您的新项目将打开。
通过在 Visual Studio Code 中的工具栏上选择Microsoft 365 徽标，确认你已使用扩展登录。 确保您已登录到想要连接的租户。
在 Agents Playground 中调试和测试代理
可以使用工具包中提供的新 Microsoft 365 Agent Playground 调试和测试代码。 演练场可以帮助您轻松调试代码，而无需经历完整的部署周期。
- 在 Microsoft 365 代理场中选择“调试”。
选择测试环境时，请稍等片刻，系统将为您的本地计算机安装所需组件。 准备需要几分钟时间。
等待部署时，请检查文件夹中的代码，并查看以便熟悉它。
调试和测试的沙盒环境加载完成后，将打开一个浏览器，您已准备好在沙盒环境中与代理进行交互。 如果您遵循指南并使用预生成模板与 LangChain 和 Azure AI Foundry 配合，可以询问“明天 {your location} 的天气是什么？”代理将使用您选择的 AI 服务，通过包含天气信息的自适应卡片进行响应。
在 Microsoft 365 Copilot 中调试和测试代理
在 Agents Playground 本地完成测试后，可以部署到 Azure 机器人服务并针对 Microsoft 365 Copilot 通道进行配置。 确保您已登录到能够访问 Microsoft 365 Copilot 的租户帐户。
将调试目标更改为 Copilot，以便可以使用 Microsoft 365 Copilot 进行调试。 选择F5或调试进行测试。 需要几分钟的准备才能使代理可供 Microsoft 365 使用。 在后台，该工具包在 Azure 机器人服务中创建应用注册和机器人服务记录，并将项目连同清单一起部署到租户。
选择在 Edge 浏览器上的 Copilot 中进行调试
完成此操作后，您应该会看到 Microsoft 365 Copilot 加载，并能够根据需要直接在 Microsoft 365 Copiot 中提问、添加断点、进行调试：
概要
您现在已经成功完成以下任务：
- 使用 Agents Toolkit 启动新的 Microsoft 365 代理项目和代理
- 在本地使用 Microsoft 365 代理操控台测试代理
- 部署代理以直接在 Microsoft 365 通道中进行调试