teams-dev

Teams Bot 开发与基础设施

此技能可帮助你使用 Teams Developer CLI 创建和管理 Microsoft Teams Bot。涵盖 Bot 应用开发（创建 Bot 代码）和基础设施管理（Bot 注册、SSO、凭据）。

重要： 请使用此技能及其参考指南中提供的信息和指导。只有在此技能或这些指南中明确链接的情况下，你才可以使用外部公开文档。请勿随意进行网络搜索，也不要依赖未列出的外部来源。

工作流路由

根据用户的请求，转到相应的指南或直接处理：

复杂工作流（使用参考指南）

创建 Bot 应用代码：

• 阅读并遵循 Bot 应用开发指南
• 涵盖内容：使用 teams project new 搭建新的 Bot 项目（TypeScript/C#/Python、模板、连接到基础设施）

将 Teams 集成到现有服务器：

• 阅读并遵循 集成现有服务器指南
• 涵盖内容：使用内置适配器（TypeScript 的 ExpressAdapter、Python 的 FastAPIAdapter）或适用于任何框架的自定义适配器，为现有服务器添加 Teams Bot 功能

设置 Bot 基础设施（Teams 管理的 Bot 和凭据）：

• 阅读并遵循 Bot 基础设施设置指南
• 涵盖内容：先决条件 → 创建 Teams 管理的 Bot → 保存凭据 → 验证

设置 SSO 身份验证：

• 阅读并遵循 SSO 设置指南
• 涵盖内容：Bot 迁移 → AAD 应用配置 → OAuth 连接 → 清单更新 → 验证
• 先决条件：现有 Bot（teamsAppId、botId），az CLI 已完成身份验证

排查错误：

• 阅读 故障排除指南
• 涵盖内容：旁加载问题、身份验证错误、SSO 问题、迁移问题

将 Slack Bolt Bot 移植到 Teams SDK：

• 阅读并遵循 Slack Bolt 迁移指南
• 涵盖内容：应用构建、消息/命令处理程序、Block Kit → Adaptive Cards、用户身份验证（Graph/外部服务），以及哪些内容需要人工判断，哪些可以机械式移植
• 这是一项需要你自行执行的直接代码编辑任务（读取源代码、应用映射、提供差异），而非 CLI 命令

简单操作（直接处理）

对于简单查询和更新，请使用以下命令直接处理：

列出所有应用：

teams app list

查看应用详情：

teams app get <teamsAppId> --json

检查身份验证状态：

teams status

将 CLI 更新到最新版本：

teams self-update

---

常见操作

更新 Bot 终结点

使用场景： 终结点 URL 已更改（新的 ngrok/devtunnels 会话）

命令：

teams app update <teamsAppId> --endpoint "https://new-endpoint-url/api/messages"

使用时机：

• Ngrok URL 已更改（新会话）
• Devtunnels URL 已更改
• 在不同的本地开发隧道之间切换

注意： 如果终结点域名发生变化（而不仅仅是路径），CLI 会自动更新清单中的 validDomains。要使更改生效，用户需要在 Teams 中重新安装应用。

更新 Teams Developer CLI

使用场景： 将 Teams Developer CLI 更新到最新版本（建议及时更新，以获取新功能和错误修复）

命令：

teams self-update

使用时机：

• 定期更新以获取最新功能
• 报告错误或发现已知问题后
• 发布新的 CLI 功能时

预期结果： CLI 会下载并安装最新版本

查看应用详情

命令：

teams app get <teamsAppId> --json

使用场景： 检查当前 Bot 配置，验证设置

列出所有应用

命令：

teams app list

使用场景： 查看你创建的所有 Teams 应用

资源

Teams SDK 文档（llms.txt — 针对大模型使用进行优化）：

• TypeScript：https://microsoft.github.io/teams-sdk/llms_docs/llms_typescript.txt
• Python：https://microsoft.github.io/teams-sdk/llms_docs/llms_python.txt
• C#：https://microsoft.github.io/teams-sdk/llms_docs/llms_csharp.txt
• 完整的 TypeScript 文档：https://microsoft.github.io/teams-sdk/llms_docs/llms_typescript_full.txt
• 完整的 Python 文档：https://microsoft.github.io/teams-sdk/llms_docs/llms_python_full.txt
• 完整的 C# 文档：https://microsoft.github.io/teams-sdk/llms_docs/llms_csharp_full.txt

**开发隧道：**有关 devtunnel 设置说明，请参阅 Bot 基础设施设置指南。