腾讯会议一键总结
调用 office-mate 上已发布的「会议助手(Token 入参版 v3)」工作流:
取智能纪要 → 结构化 → 总结与待办 → 按需推送企微群。会议内容全部来自腾讯会议,不编造。
使用者需要准备两个令牌,都配置在自己本机:office-mate 令牌(向 skill 提供者申请)和自己的腾讯会议 Token。skill 包里不含任何令牌。
一键流程
用户说「总结一下会议 123456789」「把『交付交底会』的纪要整理出来推到某群」时,直接执行,不需要再追问:
python3 <skill 目录>/scripts/meeting_summary.py --meeting 123456789
python3 <skill 目录>/scripts/meeting_summary.py --meeting "交付交底会" --notify-target wrxxxxxxxx --operator zhangsan
| 参数 | 说明 |
|---|---|
--meeting |
必填。9~12 位纯数字按会议号查;否则按会议名称关键词在最近 30 天已结束的会议里模糊匹配(多个命中取最近一场) |
--notify-target |
选填。企微群 ID(ww 开头)/ 机器人 ID(wrk 开头)/ RTX 英文名;不填则按工作流默认目标,仍无目标时只生成总结、不推送 |
--operator |
选填。自己的 RTX 英文名,仅用于消息里显示「整理人」 |
--timeout |
最长等待秒数,默认 1500。一场会通常几分钟,长会议更久,期间不要中断 |
--dry-run |
只检查配置、打印将提交的入参(Token 已掩码),不调用接口 |
stdout 是单行 JSON,进度和诊断在 stderr。成功时关键字段:
meeting(主题 / 时间 / 主持)、summary_text(总结)、decisions、riskstodos(每条含title / assignee / need_assign / due_date / priority / source_quote)、stats、alertspushed(是否已推送:true/false/null未知)、push_result(推送原始结果)
回复用户时:先给总结和待办,need_assign 为 true 的待办要明确标「责任人待指派」;pushed 为 false 时说明没有推送成功及原因,不要说成已推送。
首次使用
需要两步,都配置在自己本机(环境变量,或写进 ~/.workreport/.env,每行一个 KEY=值):
- office-mate 令牌
AUTH_KEY:向 skill 提供者申请,对方会给你一个令牌,且需要为你开通 workflow 编辑权限。 - 腾讯会议 Token
TENCENT_MEETING_TOKEN:自己到 https://meeting.tencent.com/ai-skill 获取,只能查到你本人有权限的会议。
export AUTH_KEY='向提供者申请到的令牌'
export TENCENT_MEETING_TOKEN='你的腾讯会议Token'
不要把任何令牌发到对话里、不要放进命令行参数、不要转发给别人;脚本只从环境变量或 ~/.workreport/.env 读取。
需要 Python 3.8+,无第三方依赖。配置好后可先 --dry-run 检查。
状态速查
| status / reason | 含义 | 处理 |
|---|---|---|
no_tencent_token |
本机没有设置腾讯会议 Token,或格式不对 | 按「首次使用」设置 |
no_auth_key |
本机没有设置 office-mate 令牌 | 向 skill 提供者申请后按「首次使用」设置 |
config_error |
skill 包配置不完整(缺 WORKFLOW_ID / WORKFLOW_ROLE) |
联系 skill 提供者,不要自己改 |
api_error(401/403/404) |
你的 office-mate 令牌失效 / 无权限 / 工作流未发布 | 联系 skill 提供者,不要重试 |
business_failed + auth_failed |
腾讯会议 Token 无效或过期 | 重新获取 Token |
business_failed + not_found |
没匹配到会议 | 核对会议号,或换更完整的关键词 |
business_failed + no_minutes |
会议没有智能纪要和转写 | 确认会议是否开启云录制 / 智能纪要 |
business_failed + no_permission |
没有录制查看权限 | 向录制所有者申请 |
timeout |
等待超时,工作流可能仍在跑 | 稍后让提供者按 run_id 查,不要重复提交 |
failed / stopped |
工作流执行失败或被终止 | 把 message 和 run_id 原样告诉用户 |
同一个错误最多重试 1 次;会议内容类错误(not_found / no_minutes / no_permission)不要重试。
铁律
- 绝不回显、转述、写入任何令牌(腾讯会议 Token、office-mate 令牌)。
- 总结和待办只引用脚本返回的内容,不补充会上没说过的结论;责任人没明确指派就保持「待指派」,不要猜。
- 每次运行会真实消耗资源并可能向企微群发消息:同一场会议不要无故重复提交;用户没给推送目标时不要自己编群 ID。
- 不要修改
config.env;脚本不接受自定义服务地址。
给 skill 提供者
打包
1. 把「会议助手(Token 入参版 v3)」导入 office-mate 并发布,确认是团队工作流且关闭运行结果缓存(开着缓存,相同入参会直接返回旧结果、不再推送)。
2. 在 config.env 填 WORKFLOW_ID、WORKFLOW_ROLE。
3. 自测:python3 scripts/meeting_summary.py --meeting <一个真实会议号> --dry-run,再真跑一次。
4. 打包分发。包里不含任何令牌,可以放心分享。
给使用者开通
- 为每位使用者在 office-mate 单独创建令牌(auth_tokens 表,见《工作流与Agent_API文档》2.2),角色需有 workflow 编辑权限;令牌只发给本人,不要多人共用,这样出问题时可以单独停用。
- 使用者拿到令牌后,按「首次使用」配置到自己本机即可。
| 文件 | 用途 |
|---|---|
scripts/meeting_summary.py |
唯一入口:提交工作流 → 轮询 → 输出 JSON |
config.env |
服务地址、工作流 ID(无任何密钥) |