title: “Teams Meeting Pipeline — Teams meeting summaries, job replay, Graph subscriptions” sidebar_label: “Teams Meeting Pipeline” description: “Teams meeting summaries, job replay, Graph subscriptions”

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

Teams 会议处理流程

用于生成 Teams 会议摘要、任务回放内容以及 Microsoft Graph 订阅相关功能。

技能元数据


来源	内置（默认已安装）
路径	`skills/productivity\teams-meeting-pipeline`
版本	`1.1.0`
开发者	Hermes Agent + Teknium
许可协议	MIT
支持平台	linux、macos、windows
标签	`Teams`、`Microsoft Graph`、`Meetings`、`Productivity`、`Operations`

参考：完整的 SKILL.md 文件

:::info 以下是当触发该技能时 Hermes 所加载的完整技能定义。当技能处于激活状态时，Agent 就会依据这些内容来执行操作。: ::

Teams 会议处理流程

每当用户询问有关 Microsoft Teams 会议摘要、文字记录、录像文件、待办事项、Microsoft 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 fetch --join-web-url "<url>" --organizer-user-id <id>   # organizer-scoped lookup (required for /meet/ short URLs)

订阅管理

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 — Teams meeting summaries, job replay, Graph subscriptions” sidebar_label: “Teams Meeting Pipeline” description: “Teams meeting summaries, job replay, Graph subscriptions”

Teams 会议处理流程

技能元数据

参考：完整的 SKILL.md 文件

Teams 会议处理流程

何时使用此技能

先决条件

命令参考

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

重新运行 / 调试

订阅管理

常见问题的决策流程

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

其他常见问题

相关文档

Keyboard shortcuts

Hermes Agent Docs i18n