这篇教程带你把一条真实存在的链路走通:把一场 Teams 会议的转录丢进 Copilot 工作区,让它输出一份结构化的周报正文,再折算成几个关键指标,最后把正文保存成 OneDrive 里的 .docx,把指标回写进 Excel 台账。全程不需要来回复制粘贴十几次,也没有需要手工打开的对话框。
读完之后你手上会有四样东西:一条从会议到周报的可复现流程、一份可以反复套用、不需要每次重写的提示词模板、一张最小权限清单、以及一段把「取转录、生成文档、回写表格」串起来运行的脚本。
这篇能做出什么
一条典型的产出链路长这样:
1. 周五下午,从 Teams 里翻出本周三次例会的转录文本;
2. Copilot 工作区读入转录,按「进展、风险、下周计划、需要协调的事项」四段式出稿,同时输出一份机器可读的 JSON,里面是本周的三个指标;
3. 正文保存成 周报_2025-Wxx.docx 落在共享库,同事可以直接在 Word 里接着改;
4. JSON 里的数字由脚本回写到 Excel「周报汇总」表的对应行,表格里的公式和图表自动刷新。
最终文档里的导语大致是这样:
> 本周完成 A 模块联调,接口平均返回时间从 380ms 降到 210ms;B 需求因上游数据未到位顺延至下周三;需要协调的是测试环境的账号额度,目前只够 5 人并行。
这段话没有一句是手写的,但你随时可以在 Word 里把它改掉,这正是「Office 跑进 Copilot」和纯聊天机器人的区别:生成的结果是一个真实的 Office 文件,而不是一段只能留在对话框里的文字。
前置条件清单
动手前把孩子准备好,后面会顺很多。
- 账号与许可:一个 Microsoft 365 商业版或企业版账号,且所在租户已开通 Copilot 相关许可。功能入口和许可名称会随官方更新变化,以官方文档当前版本为准。
- 角色:你是会议组织者或拥有该会议的转录查看权限;对目标 SharePoint 站点或 OneDrive 文件夹有编辑权限。
- 管理员配合:部分 Graph 权限(如转录读取)需要管理员一次性授予同意,提前和管理员打个招呼。
- 工具:Python(较新版本即可)、
msal、requests、python-docx;或者用 PowerShell 的 Microsoft Graph 模块,二选一。 - 测试素材:一场开启了转录的会议(没有就手动上传一份 VTT)、一份 Excel 台账、一份 Word 周报模板,统一放在一个文件夹里,例如
CopilotWork/。 - 一个应用注册:在 Entra 管理中心的「应用注册」里建一个公开客户端应用,拿到 Client ID 和 Tenant ID,用来跑脚本。
分步骤
第 1 步:建一个“固定地址”的工作区目录
Copilot 引用文件时,靠的是你给它的路径。路径天天变,提示词就没法复用。
在 OneDrive 或某个团队站点下建三层:
```text
CopilotWork/
├── inbox/ # 会议转录落这里
├── templates/ # 周报模板.docx
└── out/ # 生成的周报与台账
```
指标台账.xlsx 放在根目录,里面先建好一张名为 周报汇总 的工作表,第一行是表头:周期 | 会议数 | 完成任务数 | 新增风险数 | 平均响应毫秒。表名和表头后面会被脚本直接引用,不要随手改名。
用 browser 或者命令行建目录都可以,用 Graph 验证一下路径是否可达:
```bash
列出目录,确认路径拼写正确
curl -s -H "Authorization: Bearer $TOKEN" \
"https://graph.microsoft.com/v1.0/me/drive/root:/CopilotWork:/children"
```
第 2 步:圈定最小权限范围
这一步最容易出问题。原则只有一条:用委派权限,不用应用权限。委派权限是以你本人身份行事,天然继承你已有的文件访问边界;应用权限则可能让一个脚本读遍整个租户。
| 要做的事 | 需要的委派权限 | 说明 |
|---|---|---|
| 读取会议转录 | OnlineMeetings.Read、OnlineMeetingTranscript.Read.All | 后者通常需管理员同意 |
| 读写 Word / Excel 文件 | Files.ReadWrite | 只覆盖当前用户有权限的文件 |
| 读取日历(定位本周会议) | Calendars.Read | 可选 |
| 读取 Teams 频道消息(可选) | ChannelMessage.Read.All | 有合规要求时慎开 |
把权限清单写成应用注册的配置片段,方便交给管理员审阅:
```json
{
"clientType": "public",
"signInAudience": "AzureADMyOrg",
"requiredResourceAccess": [
{
"resourceAppId": "00000003-0000-0000-c000-000000000000",
"resourceAccess": [
{ "id": "<OnlineMeetings.Read 的权限 GUID>", "type": "Scope" },
{ "id": "<OnlineMeetingTranscript.Read.All 的权限 GUID>", "type": "Scope" },
{ "id": "<Files.ReadWrite 的权限 GUID>", "type": "Scope" }
]
}
],
"notes": "权限 GUID 请从官方 Graph 权限参考文档复制,以当前版本为准"
}
```
另外要确认一件事:目标文件上有没有敏感度标签。带加密或「禁止导出」标签的文件,脚本读得到元数据也未必读得到内容,这条限制优先于任何 API 权限。
第 3 步:把会议转录取下来
转录内容的接口返回的是 WebVTT 格式,带时间轴和说话人标记。先把时间轴去掉,只留「谁说了什么」,模型的摘要质量会明显提升。
```python
import msal, requests
CLIENT_ID = "<你的 Client ID>"
TENANT_ID = "<你的 Tenant ID>"
SCOPES = [
"OnlineMeetings.Read",
"OnlineMeetingTranscript.Read.All",
"Files.ReadWrite",
]
app = msal.PublicClientApplication(
CLIENT_ID,
authority=f"https://login.microsoftonline.com/{TENANT_ID}",
)
result = app.acquire_token_interactive(scopes=SCOPES)
token = result["access_token"]
headers = {"Authorization": f"Bearer {token}"}
1) 找到会议
meetings = requests.get(
"https://graph.microsoft.com/v1.0/me/onlineMeetings",
headers=headers,
).json()
meeting_id = meetings["value"][0]["id"]
2) 列出该会议的转录
transcripts = requests.get(
f"https://graph.microsoft.com/v1.0/me/onlineMeetings/{meeting_id}/transcripts",
headers=headers,
).json()
transcript_id = transcripts["value"][-1]["id"] # 取最近一次
3) 下载 VTT 内容
vtt = requests.get(
f"https://graph.microsoft.com/v1.0/me/onlineMeetings/{meeting_id}"
f"/transcripts/{transcript_id}/content",
headers={**headers, "Accept": "text/vtt"},
).text
4) 去掉时间轴,只留说话人和文本
lines = []
for line in vtt.splitlines():
line = line.strip()
if not line or line.startswith(("WEBVTT", "NOTE")) or "-->" in line:
continue
if line.isdigit():
continue
lines.append(line)
plain = "\n".join(lines)
with open("CopilotWork/inbox/week_transcript.txt", "w", encoding="utf-8") as f:
f.write(plain)
print(f"已保存 {len(lines)} 行转录")
```
多场会议就循环一遍,把所有转录拼成一份,段与段之间用 --- 会议名 / 日期 --- 分隔。这个分隔符很有用,模型能据此判断哪句话来自哪场会。
第 4 步:在工作区对话里生成周报正文
打开 Copilot 工作区,把 week_transcript.txt 作为引用文件挂上去(入口名称各版本略有差异,以官方文档为准),然后贴入下面这段提示词。注意提示词里同时要求两种输出:给人读的正文,和给机器读的 JSON。
```text
你是我的周报助手。请只依据我提供的会议转录内容作答,不要补充转录里没有的事实。
【输出要求】
第一部分:周报正文,Markdown 格式,严格按以下四节,每节不超过 5 条:
本周进展
风险与阻塞
下周计划
需要协调
每条不超过 40 字,写成「做了什么 + 结果/数字」的句式,不要写"持续推进""有序开展"这类空话。
第二部分:一个 JSON 代码块,字段固定为:
{
"period": "YYYY-Www",
"meeting_count": 整数,
"tasks_done": 整数,
"risks_new": 整数,
"avg_response_ms": 整数或 null
}
数值只能来自转录里明确出现的数字;没提到就填 null,不要估算。
【转录内容】
(在此粘贴第 3 步生成的纯文本)
```
几个提升稳定性的写法:
- 给句式模板比给形容词有效。「做了什么 + 结果/数字」能把模型逼到具体事实上。
- 允许 null。不给这个出口,模型就会为了填满字段而编数字,这是回写表格时最难排查的错误。
- 限定「只依据转录」。会议纪要场景里,模型最容易自作主张补充的背景知识,恰恰是最容易被同事挑出毛病的地方。
拿到结果后,先人工扫一遍「风险与阻塞」和 JSON 里的数字,这两块是后面要落到正式表格里的。
第 5 步:把正文写成真正的 .docx
两条路径,按团队习惯选:
路径 A(推荐给大多数人):直接在工作区里让 Copilot 把上一步的结果导出为 Word 文档,落到 CopilotWork/out/。之后所有修改都在 Word 里进行,Copilot 侧边栏还能基于这份文档继续改写。
路径 B(需要批量或自动化时):用脚本生成 docx 再上传。适合每周固定时间跑一次的场景。
```python
from docx import Document
import requests
doc = Document("CopilotWork/templates/周报模板.docx")
doc.add_heading("本周进展", level=2)
for item in progress_items: # 上一步正文拆出来的列表
doc.add_paragraph(item, style="List Bullet")
doc.add_heading("风险与阻塞", level=2)
for item in risks:
doc.add_paragraph(item, style="List Bullet")
local_path = "CopilotWork/out/周报_2025-W07.docx"
doc.save(local_path)
filename = "周报_2025-W07.docx"
with open(local_path, "rb") as f:
resp = requests.put(
f"https://graph.microsoft.com/v1.0/me/drive/root:/CopilotWork/out/{filename}:/content",
headers={
"Authorization": f"Bearer {token}",
"Content-Type": "application/vnd.openxmlformats-officedocument"
".wordprocessingml.document",
},
data=f,
)
print(resp.status_code, resp.json().get("webUrl"))
```
用 PUT 上传同名文件会覆盖并保留版本历史,所以文件名里带上周期号(2025-W07)比用 周报_final_v3.docx 靠谱得多。
第 6 步:把指标回写进 Excel
先读结构,再写值。不要闭着眼睛往固定单元格里塞,台账被人插过一行就全错位了。
```python
BASE = "https://graph.microsoft.com/v1.0/me/drive/root:/CopilotWork/指标台账.xlsx:/workbook"
1) 看清已有内容,确认行号
used = requests.get(
f"{BASE}/worksheets('周报汇总')/usedRange",
headers=headers,
).json()
for i, row in enumerate(used["values"], start=1):
print(i, row)
2) 追加一行(假设当前最后一行是第 8 行,新行写第 9 行)
new_row = [[
"2025-W07", # 周期
3, # 会议数
11, # 完成任务数
2, # 新增风险数
210, # 平均响应毫秒
]]
requests.patch(
f"{BASE}/worksheets('周报汇总')/range(address='A9:E9')",
headers={**headers, "Content-Type": "application/json"},
json={"values": new_row},
)
```
两个细节:address 里的范围大小必须和 values 的二维数组形状完全一致,宽一个格或少一个格都会返回 400;工作表名里有中文或空格时,在 URL 里保持单引号包裹即可。
写完之后回到 Excel,图表和数据透视表会自己按新行刷新。需要额外分析时,直接在 Excel 里唤出 Copilot,用对话让它「按周画一张完成任务数的折线图」,比手工拖字段快。
第 7 步:把整条链路固化
把上面的步骤串成一个脚本,每周固定时间跑:
```powershell
run-weekly.ps1 —— 顺序执行,任一步失败就停
$ErrorActionPreference = "Stop"
python .\scripts\fetch_transcripts.py # 第 3 步:取转录
python .\scripts\build_prompt.py # 拼接提示词,输出 prompt.txt
Write-Host "请把 prompt.txt 内容贴入 Copilot 工作区,导出正文到 out/"
Read-Host "完成后按回车继续"
python .\scripts\write_docx.py # 第 5 步:生成并上传 docx
python .\scripts\write_excel.py # 第 6 步:回写指标
Write-Host "本周周报已就绪"
```
中间留一个人工确认的停顿是刻意的:周报是要发给同事看的东西,把「生成」和「发出」之间隔一步复核,比全自动更省心。等提示词稳定运行几周、返工率降下来,再考虑把这一步也自动化。
常见坑与排错
401 或 403,但权限明明加了。 先分清是委派还是应用权限。委派权限看的是「登录的这个人的权限」,如果管理员只给了应用权限,而脚本走的是用户登录,就会 403。其次看管理员是否点了「代表组织授予同意」——用户自己点的那次同意,只对部分低敏感权限有效。
转录接口返回空数组。 三种可能:会议没开转录、租户的录制与转录策略被关闭、你不是会议组织者且没被授予查看权限。用「会议组织者账号」跑一次,能快速排除第三种。
Excel 写入报 400 或 423。 400 多半是 values 的形状和 address 对不上;423 是文件被占用,有人正开着这个工作簿编辑,让 ta 关闭后再写,或者改用「先应用到副本、再合并」的流程。
Copilot 引用了旧版本的周报。 工作区里的文件索引有延迟,而且同名文件容易让它挑错。给文件加周期号、把过期文件移出工作区目录,比反复纠正提示词有效。
长转录超出上下文,摘要开始丢细节。 分段处理:每场会议单独摘要,再把几份摘要合并成周报。比硬塞一整周的转录稳定得多。
数字对不上。 大概率是模型在 JSON 里做了估算。检查提示词里有没有「没提到就填 null」这一条,以及回写前有没有核对 usedRange 里的上一周数据。
周次算错。 周报周期按 ISO 周计算,跨年那几周特别容易出错。脚本里统一用 date.isocalendar() 生成 YYYY-Www,不要手写。
下一步建议
链路跑通之后,有三个方向可以继续投入。
一是把提示词做成可复用的资产。现在它躺在你的记事本里,下一步把它放进 Copilot Studio 或自定义 Agent,团队成员不用看教程也能直接调用,输出格式还能锁定。
二是把复核环节做成流程。用 Power Automate 监听 out/ 目录的新文件,自动发一条待审通知给负责人,批准后才同步到周报汇总库。生成和发布分离,出错时影响面小得多。
三是扩展数据源。会议转录只是入口之一,项目看板、工单系统的导出表都能作为输入喂进同一套提示词。输入端越丰富,周报里「本周进展」那一节的含金量越高。
最后提醒一句:所有涉及许可名称、接口字段、功能入口的细节都会随产品迭代变化,落地前花十分钟对照官方文档当前版本核一遍,比照着教程硬抄省事。
