MS Teams中虚拟助手无法转接至技能的问题求助

看起来你遇到的是自定义Teams应用包中Bot技能转接失效，但通过Azure Portal直接添加Bot到Teams却正常的问题，这种差异通常和Teams应用配置、Bot权限或者技能关联逻辑有关，下面是几个针对性的排查方向：

1. 确认技能与主Bot的权限关联 #

技能转接需要主Bot和技能Bot之间建立信任关系，你需要检查：

• 技能Bot的Microsoft App ID已在Azure AD完成注册，并且主Bot的应用注册中，已将技能Bot的App ID添加到**"公开API" -> "已授权的客户端应用"**列表中，授予必要的BotFramework调用权限
• 主Bot的Bot资源配置里，是否正确添加了技能的信息（包括技能ID、App ID、端点地址），可以在Azure Bot资源的"技能"选项卡中确认

2. 检查Teams Manifest的隐含配置 #

你的manifest.json基础配置没问题，但有几个细节可以核对：

• 确保botId对应的Azure Bot资源确实关联了目标技能（有时候可能在Bot资源里配置了技能，但忘记保存或者同步）
• 如果技能需要调用外部域名的服务，除了token.botframework.com，需要把技能的端点域名也添加到validDomains数组中，否则Teams会拦截跨域请求
• 对比微软默认生成的Teams应用manifest（通过Web App Bot导出的包），看看是否缺少了某些extensions或者webApplicationInfo之类的配置项（虽然技能转接不一定依赖，但部分场景下会影响Bot的上下文获取）

3. 排查两种安装方式的上下文差异 #

通过Web App Bot直接添加到Teams的应用是微软托管的默认包，它会自动同步Bot的最新配置和权限，而自定义上传的应用包是静态的，可能存在以下差异：

• 自定义应用安装时，是否正确授予了identity和messageTeamMembers权限？可以尝试卸载后重新安装，确认权限弹窗的内容
• 检查Bot的消息端点是否正确配置：在Azure Bot资源的"配置"选项卡中，确保消息端点是公开可访问的，并且能处理Teams通道的请求（可以用Bot Framework Emulator测试端点连通性）

4. 查看Bot的日志报错 #

最直接的方式是查看Bot的运行日志：

• 打开Azure Bot资源的"日志分析"，搜索技能转接相关的错误日志，比如SkillConversationIdFactory相关的报错，或者权限不足的提示
• 如果配置了Application Insights，可以查看Bot的跟踪日志，确认在触发技能转接时，是否有请求发送到技能端点，以及是否收到了响应

快速测试建议 #

先在Azure Bot资源的"测试在Web Chat"中测试技能转接功能，如果Web Chat中能正常转接，说明Bot后端的技能逻辑没问题，问题大概率出在Teams自定义应用的配置上；如果Web Chat也失败，那需要先排查Bot的技能关联和权限配置。

内容的提问来源于stack exchange，提问作者tabrza