SuperAPI AI 工具集

teams-app-manifest

智能体与模型

查看项目

更新于 10-16 09:32

技能介绍

用途:为已有的 Microsoft 365 Agents SDK 应用创建或审计 Teams 应用清单(manifest),以已发布的 Microsoft 365 应用清单 schema 为结构约束,按需声明该应用已实现并打算开放的能力,避免加入没有证据的字段。

主要能力:支持三种模式——Generate(清单不存在时新建)、Complete(在保留有效元数据与无关能力的前提下补充所需声明)、Audit(只报告不一致,不修改文件,也可针对缺失清单给出能力计划与未决值报告)。工作从 Microsoft Teams 能力到功能的映射开始发现,JSON 结构与版本约束来自已发布 schema;能力决策依据来源顺序为:明确的用户或仓库要求、源码/配置/README 证据、已发布的 Microsoft 功能文档、已发布清单 schema、现有清单。检测结果记录在内部能力台账(能力、证据、清单影响、所需值、置信度、来源),最终逐项与清单核对。

使用方式:调用时给出应用或源码路径即视为处理该应用,默认执行 Generate 或 Complete 并在同一轮完成写入与校验,不停留在检查报告;仅在用户明确要求 review/audit/不改文件时用 Audit。新建清单以 base-manifest.template.json 起步,必要时用 capability-ledger.md 记录候选能力;按能力分流读取 bots.md、cards-and-dialogs.md、message-extensions.md、meetings.md、authentication-and-permissions.md、schema-validation.md 等参考。新样本清单与图标放在 manifest/ 目录;若由 CLI 打包,先对照当前 CLI 文档核实命令,手工打包需把 manifest.json 及其引用的图标放在 ZIP 根目录。完成后执行 JSON、schema、引用资源、包结构和源到清单检查,修复范围内错误并复跑。

适用场景:面向 Agents SDK 源码的本地或示例清单、组织内分发或商店提交前的清单准备;可在具备 schema 检查与校验工具时改用工具诊断而不依赖 shell 执行。

限制:不得从预览分支、预览文档或同名 API 推导行为,也不因存在新 schema 就升级;安装范围(personal、team、groupChat、copilot)、Entra 应用 ID、应用 ID URI、租户模型、OAuth、RSC/Graph/委派或应用权限、公开域名、隐私与条款 URL、生产端点、商店分发要求、isNotificationOnly、Copilot 暴露、通话/视频/跨宿主支持等,无明确要求或确凿证据不得臆断,缺失则按 needs-input 报告;路由属性只能证明代码可处理活动,不证明产品意图开放该能力;文档与 schema 冲突时停止并同时引用;需要 Developer Portal、Entra、Azure、Graph 或订阅配置的能力只生成已验证的清单部分,外部配置单列;Complete 模式下保留代码中未发现的能力并标记复核,不自动删除;校验通过但源到清单证据不成立时,清单不算完成。除用户明确要求或调用方策略规定外,默认不持久化 manifest-evidence.md。