title: “Teams Meeting Pipeline” sidebar_label: “Teams Meeting Pipeline” description: “Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions”

{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能的 SKILL.md 文件自动生成。请修改源文件 SKILL.md，而非此页面。 */}

Teams 会议处理流程

通过 Hermes CLI 操作 Teams 会议摘要处理流程——可执行会议总结、查看流程状态、重新运行任务，以及管理 Microsoft Graph 订阅。

技能元数据


来源	内置（默认已安装）
路径	`skills/productivity/teams-meeting-pipeline`
版本	`1.1.0`
开发者	Hermes Agent + Teknium
许可证	MIT
标签	`Teams`、`Microsoft Graph`、`Meetings`、`Productivity`、`Operations`

参考：完整 SKILL.md 文件

:::info 以下是当触发该技能时 Hermes 加载的完整技能定义。技能处于激活状态时，Agent 会将此内容视为操作指令。: ::

Teams 会议处理流程

每当用户询问有关 Microsoft Teams 会议摘要、文字记录、录像、待办事项、Graph 订阅，或与 Teams 会议处理流程相关的任何运营问题时，均可使用此技能。它支持多种语言——以下触发语句仅为示例，并非完整列表。

所有面向操作人员的功能均通过终端工具的 hermes teams-pipeline 子命令来实现。该流程没有新的模型工具，CLI 即为其操作界面。

何时使用此技能

当用户需要执行以下操作时，可使用此技能：

对 Teams 会议进行总结/提取待办事项/获取会议笔记
查看流程状态、查看已存储的会议任务或浏览近期会议记录
重新运行失败或需要重新生成摘要的已存储任务
在更改环境或配置后验证 Microsoft Graph 的设置
排查“会议摘要未送达”或“无新会议被处理”的问题
管理 Graph webhook 订阅（创建、续订、删除、查看状态）
设置自动订阅续订功能（详见下方注意事项）

多语言触发语句示例（非完整列表）：

英语： “summarize the Teams meeting”、“pipeline status”、“replay job X”
土耳其语： “Teams meeting özetle”、“action item çıkar”、“toplantı notu”、“pipeline durumu”、“replay job”

先决条件

在使用该流程之前，请先确认 ${HERMES_HOME:-~/.hermes}/.env 文件中已设置以下内容：

MSGRAPH_TENANT_ID=...
MSGRAPH_CLIENT_ID=...
MSGRAPH_CLIENT_SECRET=...

如果缺少任何必要项，请引导用户前往 /docs/guides/microsoft-graph-app-registration 中的 Azure 应用注册指南——在流水线能够正常运行之前，必须先完成 Azure AD 应用注册，并授予具有管理员同意权限的 Graph 应用权限。

命令参考

状态查询与检查（从这里开始）

hermes teams-pipeline validate              # config snapshot — run first after any change
hermes teams-pipeline token-health          # Graph token status
hermes teams-pipeline token-health --force-refresh   # force a fresh token acquisition
hermes teams-pipeline list                  # recent meeting jobs
hermes teams-pipeline list --status failed  # only failed jobs
hermes teams-pipeline show <job-id>         # full detail of one job
hermes teams-pipeline subscriptions         # current Graph webhook subscriptions

重新运行 / 调试

hermes teams-pipeline run <job-id>          # replay a stored job (re-summarize, re-deliver)
hermes teams-pipeline fetch --meeting-id <id>   # dry-run: resolve meeting + transcript without persisting
hermes teams-pipeline fetch --join-web-url "<url>"   # dry-run by join URL

订阅管理

hermes teams-pipeline subscribe \
  --resource communications/onlineMeetings/getAllTranscripts \
  --notification-url https://<your-public-host>/msgraph/webhook \
  --client-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"

hermes teams-pipeline renew-subscription <sub-id> --expiration <iso-8601>
hermes teams-pipeline delete-subscription <sub-id>
hermes teams-pipeline maintain-subscriptions            # renew near-expiry ones
hermes teams-pipeline maintain-subscriptions --dry-run  # show what would be renewed

常见问题的决策树

用户询问“为何没有收到今日会议的摘要？”→ 首先执行 list --status failed，然后查看对应行并执行 show <job-id>。如果该任务根本不存在，请检查 subscriptions —— 可能是 webhook 已过期（详见下文注意事项）。
用户询问“设置是否正常工作？”→ 先执行 validate，接着是 token-health，最后是 subscriptions。若这三项均通过，则安排一次测试会议，并通过 list 查看是否有新生成的记录。
用户询问“重新生成会议 X 的摘要”→ 先通过 list 找到任务 ID，再执行 run <job-id> 重新处理。如果仍失败，则执行 show <job-id> 查看错误信息，并使用 fetch --meeting-id 进行模拟处理以验证结果。
用户询问“将会议 X 添加到流程中”→ 通常无需如此操作——该流程是基于订阅驱动的，而非针对单次会议。如果用户希望对某个历史会议生成摘要，可在创建任务后使用 fetch 获取会议记录，再执行 run 处理。

重要注意事项：Microsoft Graph 订阅有效期为 72 小时

Microsoft Graph 将 webhook 订阅的有效期限制在 72 小时内，并且不会自动续期。如果未安排 maintain-subscriptions 任务，任何手动创建的订阅在 3 天后就会停止发送通知。

当用户反馈“昨天流程还能正常工作，今天却没有任何通知了”时：

运行 hermes teams-pipeline subscriptions —— 如果结果为空，或所有条目的 expirationDateTime 都已过去，那就是原因所在。
按上述方法使用 subscribe 重新创建订阅。
立即通过 hermes cron add、systemd 定时器或普通 crontab 设置自动续期功能。文档 /docs/guides/operate-teams-meeting-pipeline#automating-subscription-renewal-required-for-production 中提供了这三种方案。12 小时的间隔较为安全（相比 72 小时的限制还有 6 倍的缓冲时间）。

其他常见问题

会议记录尚未生成。 Teams 需要在会议结束后一段时间才能生成会议记录。对刚结束的会议执行 fetch --meeting-id 可能会返回空结果。建议等待 2-5 分钟后再试，或让 Graph webhook 自动完成数据同步。
传输模式不匹配。 即使摘要已生成（list 显示处理成功），但内容仍未出现在 Teams 中，需检查 platforms.teams.extra.delivery_mode 以及对应的目标配置（incoming_webhook_url、chat_id 或 team_id+channel_id）。相关配置可从 config.yaml 文件或 TEAMS_* 环境变量中获取。
Graph 应用权限问题。 虽然令牌获取正常（token-health 显示正常），但由于添加了权限但未重新获得管理员同意，Graph API 调用仍会返回 401/403 错误。此时需让用户再次进入 Azure 门户中的应用注册页面，重新点击“授予管理员同意”。

Hermes Agent Docs i18n

title: “Teams Meeting Pipeline” sidebar_label: “Teams Meeting Pipeline” description: “Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions”

Teams 会议处理流程

技能元数据

参考：完整 SKILL.md 文件

Teams 会议处理流程

何时使用此技能

先决条件

命令参考

状态查询与检查（从这里开始）

重新运行 / 调试

订阅管理

常见问题的决策树

重要注意事项：Microsoft Graph 订阅有效期为 72 小时

其他常见问题

相关文档

Keyboard shortcuts

Hermes Agent Docs i18n