了解如何使用 Visual Studio Code 和 Microsoft 365 Agents Toolkit 创建 Microsoft Teams 应用。 本指南将引导你完成构建基本 Teams 应用、浏览其目录结构以及利用可用模板的过程。 无论你是从简单的“Hello World”应用开始,构建应用以自动执行任务,还是跨 Microsoft 365 扩展 Teams 功能,本文都提供了帮助你入门的说明。
使用代理工具包创建 Teams 代理 可以创建以下类型的 Teams 应用:
| 应用类型 | 定义 |
|---|---|
| 基本 Teams 应用 | 基本 Teams 应用包括可根据需要创建和自定义的 Teams 选项卡、聊天机器人或消息扩展应用。 |
| Office 加载项 | 可以在 Outlook 和 Office.com 上安装和运行这组加载项。 |
使用 Visual Studio Code 创建新的 Teams 应用
对于所有类型的应用,创建新的 Teams 应用的过程相似。 若要创建基本 Teams 应用,请执行以下操作:
打开 Visual Studio Code。
选择 Microsoft 365 智能体工具包>创建新的智能体/应用> 选择 Teams 智能体和应用。
选择 其他 Teams 功能。
在此示例中,选择 Tab 作为应用功能。
选择 “默认文件夹 ”以将项目根文件夹存储在默认位置。
若要更改默认位置,请执行以下步骤:
选择“ 浏览”。
选择项目工作区的位置。
您选择的文件夹是项目工作区的位置。
输入合适的名称(如 helloworld)作为应用程序名称。 确保仅使用字母数字字符。 按 Enter 键。
Teams 选项卡应用工作区将在几秒钟内创建。
不同应用类型的目录结构
Agents Toolkit 提供用于构建应用的所有组件。 创建项目工作空间后,可以在资源 管理器 部分查看项目文件夹和文件。
基本 Teams 应用的目录结构
以下示例显示基本的 Teams 选项卡应用目录结构:
| 文件夹名 | 目录 |
|---|---|
.vscode |
用于生成和调试 Teams 应用的 VS Code 的设置。 |
appPackage |
应用清单 (以前称为 Teams 应用清单) Teams 用于识别 Teams 应用的文件和图标文件。 |
env |
存储不同的环境参数。 |
infra |
Azure bicep 模板文件。 用于将 Teams 应用部署到 Azure。 |
src |
选项卡功能的源代码,包括前端应用、UI 组件和隐私声明、使用条款、 |
src/app.js |
网站的应用程序入口点和 express 处理程序。 |
src/views/hello.html |
绑定到选项卡终结点的 HTML 模板。 |
src/static |
Web 服务器可以提供静态资产,如 CSS 和 JavaScript 文件。 |
m365agents.yml |
此配置文件定义用于预配、部署和发布生命周期的 Agents Toolkit 行为。 您可以自定义此文件以更改每个生命周期中 Agents Toolkit 的行为。 |
m365agents.local.yml |
这将使用启用本地执行和调试的操作替代m365agents.yml。 |
注意
如果有机器人程序或消息扩展应用,相关文件夹将添加到目录结构中。
若要详细了解不同类型的基本 Teams 应用的目录结构,请参阅下表:
| 应用类型 | 链接 |
|---|---|
| 对于标签页应用 | 使用 JavaScript 生成第一个选项卡应用 |
| 对于机器人应用 | 使用 JavaScript 生成第一个机器人应用 |
| 对于消息扩展应用 | 使用 JavaScript 生成第一个消息传递扩展应用 |
若要尝试有关构建应用的更多分步指南,请参阅 教程。