用途:排查无法正常运行的 M365 Copilot 声明式智能体,给出从现象到原因、再到工具的调试路径。作者提示 M365 Copilot 与 Teams 平台 API 演进快,Schema 版本、能力与工具经常变化,资料最后验证时间为 2026 年 2 月(Schema v1.6+,M365 Agents Toolkit 含 @m365agents 聊天参与者),需关注 schema 版本更新、Toolkit 更新、Copilot 新能力与开发者门户变化。
主要能力:通过 @m365agents 聊天参与者暴露 MCP 工具,包括 mcp_m365agentstoo_get_schema(获取 app manifest v1.19、declarative agent v1.0、API plugin v2.1 schema 以校验结构)、mcp_m365agentstoo_troubleshoot(诊断 schema 校验失败、旁加载错误、条件访问阻断)、mcp_m365agentstoo_get_knowledge(查阅 Copilot 开发知识、能力与限制、最佳实践)、mcp_m365agentstoo_get_code_snippets(查找 Teams AI、Teams JS、botbuilder 示例)。建议先调用 troubleshoot。
使用方式:按流程先 MCP、再 schema 校验,然后执行 teamsapp validate --package-file <zip> 验证包,并在 VS Code Copilot Chat 中向 @m365agents 交互式排错。手动检查时确认 Schema 路径存在(v1.3、v1.4 不存在,未识别版本会使整个文档失效),能力与版本需匹配(如 v1.2 不支持 TeamsMessages、Email、People、Meetings、Dataverse 等,否则静默失败)。打包检查包含 manifest.json、declarativeAgent.json、color.png(192×192 实心)、outline.png(32×32 白色、透明背景),可用示例中的 PowerShell 片段检查 Alpha 是否为 0。还给出 v1.6 清单限制:name 100 字符、description 1000 字符、instructions 8000 字符、conversation_starters 最多 6 个(v1.2 为 12)、actions 1–10 个、WebSearch.sites 4 个、TeamsMessages.urls 5 个、Meetings.items_by_id 5 个。部署流程为 npx teamsapp package --env local,再 teamsapp validate 并上传到开发者门户。
适用场景与限制:适用于调试声明式智能体在 M365 Copilot 中不响应、旁加载失败、能力不生效、图标校验报错等问题;资料未提供具体收费、平台支持范围、实际效果与完整安装步骤。