用途:面向 Teams 会议摘要流水线的运维与排障,包括摘要会议、提取行动项、拉取会议记录、查看流水线状态与最近会议、重放失败任务、校验 Graph 配置、排查“摘要未送达/无新会议入站”问题,以及管理 Graph Webhook 订阅。适用于用户询问 Teams 会议摘要、转录、录制、行动项、Graph 订阅或流水线运维问题时,支持多语言触发。
主要能力:全部操作通过终端运行 hermes teams-pipeline 子命令,没有新增模型工具。常用命令包括:hermes teams-pipeline validate(配置快照,改动后先跑)、token-health(可加 --force-refresh)、list(可加 --status failed)、show <job-id>、subscriptions;重放与调试用 run <job-id>、fetch --meeting-id <id>、fetch --join-web-url "<url>";订阅管理用 subscribe --resource communications/onlineMeetings/getAllTranscripts --notification-url https://<your-public-host>/msgraph/webhook --client-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"、renew-subscription <sub-id> --expiration <iso-8601>、delete-subscription <sub-id>、maintain-subscriptions(可加 --dry-run)。
必要前提:需在 ${HERMES_HOME:-~/.hermes}/.env 中设置 MSGRAPH_TENANT_ID、MSGRAPH_CLIENT_ID、MSGRAPH_CLIENT_SECRET;缺失时需先完成 Azure AD 应用注册并授予管理员同意的 Graph 应用权限,参考 /docs/guides/microsoft-graph-app-registration。
常见排障路径:未收到摘要时先 list --status failed,再 show <job-id>;任务不存在则检查 subscriptions 是否过期。校验环境用 validate、token-health、subscriptions。重跑先 list 找 job ID,再 run <job-id>,失败则 show 查看错误并用 fetch 干跑。
限制与注意:Graph 订阅最长 72 小时且不会自动续期,若未调度 maintain-subscriptions,通知会静默停止,建议通过 hermes cron add、systemd timer 或 crontab 以 12 小时间隔自动续期。会议结束后转录生成有延迟,刚结束的会议 fetch 可能为空,可等 2-5 分钟重试。若摘要已生成但未送达 Teams,检查 platforms.teams.extra.delivery_mode 及对应目标配置。token-health 通过但 Graph 调用报 401/403,通常是权限已加但未重新授予管理员同意。相关文档:/docs/user-guide/messaging/teams-meetings、/docs/guides/operate-teams-meeting-pipeline、/docs/user-guide/messaging/msgraph-webhook。其余细节暂未提供。