English | 简体中文

实验手册：每周五 17:00 自动生成销售周报 Agent

目标：创建一个 Copilot Studio 销售周报 Agent，让 Power Automate 每周五下午 5:00 读取本周销售 Excel，调用 Agent 内的 Prompt 抽取关键指标、撰写摘要与邮件，生成 Word 排版报告，并在 Outlook 保存草稿。

适合：Microsoft 365 业务用户、Power Platform 初学者、Agent 开发者。建议预留 3 小时，包含登录授权与排错；基础实验覆盖 Excel / Word / Outlook，PPT 是最后的人工辅助扩展。

实验目标与执行顺序

2026-10-13 复跑：使用 Playwright 控制 Microsoft Edge，仅复用原有 Workshop 资源，没有创建替代资源或发送真实邮件。定时流程实际运行在 Run script 失败。以下 Prompt 和 Agent 测试是使用虚构输入的独立调用，不是该失败流程的下游结果。第五至第七步的云端链路仍未执行。

本手册按依赖顺序操作：第一步定时触发 → 第二步 Excel 与计算 → 第三步 Prompt → 第四步 Agent 编程、发布及流程调用 → 第五步 Word → 第六步 Outlook → 第七步 PPT 扩展。先发布 Agent，再选择流程中的 Agent；不要跳过第四步直接测试邮件链路。

每一步分为“操作”和“完成检查”。前一步检查未通过，就在该步骤排错，不继续向下。本文的检查值是验收要求，不是已经完成的声明；真实实施进度见文末。

课堂安全规则：使用固定测试日期、虚构数据和自己的测试邮箱；只创建 Outlook 草稿。保存的定时流可能自动开启，课前与每次保存后都在流程详情确认关闭。手动测试时先临时 Turn on / 开启，从详情页点击 Run / 运行；本次运行完成后立即 Turn off / 关闭。不要在周五 17:00 附近临时开启未验收的流程。完成全部验收并恢复运行时日期之后，才保持定时任务开启。

Power Automate（负责时间、数据、文件和邮件）
  Recurrence：每周五 17:00，UTC+8
    → Excel Online (Business)：List rows present in a table
    → Office Script：代码计算可信 Metrics
    → Microsoft Copilot Studio：Execute Agent and wait
        → SalesWeeklyAgent
        → SalesWeeklySummary：Prompt 工具/主题节点
        → JSON：指标 + 摘要 + 邮件 + PPT 大纲
    → Parse JSON + 逐项指标校验
    → Word Online (Business)：Populate a Microsoft Word template
    → OneDrive for Business：Create file
    → Office 365 Outlook：Draft an email message（默认）
        或：审批通过 → Send an email (V2)（可选）

不要把“Microsoft 365 Copilot Actions”当作一定能搜到的连接器名称。 本实验落地为 Copilot Studio 的 Prompt 工具/节点，以及 Power Automate 的 Microsoft Copilot Studio → Execute Agent and wait。直接在云端流里运行 Prompt 的实际动作叫 Run a prompt；旧教程中的 Create text with GPT using a prompt 已更名。这条替代路径能生成摘要，但不等于调用了 Copilot Studio Agent。

先计算、后生成。 金额、订单数、环比由 Office Script 确定性计算，Prompt 负责抽取这些 Metrics 并写文案；AI 的输出必须与计算结果一致才可以进入 Word 和 Outlook。

实验准备（15 分钟）

不要为跑通实验关闭 MFA、条件访问或 DLP。Word 官方文档对模板创建平台及条件访问列出了限制；遇到限制请由管理员确认支持路径，不绕过组织策略。

下载配套文件

操作：准备云端实验文件

1. 下载上表的 sales.xlsx 和 weekly-report-template.docx，保留原文件名。
2. 在 Edge 登录自己的 Microsoft 365，打开 OneDrive → My files / 我的文件。
3. 点击 Create or upload / 新建或上传 → Folder / 文件夹，创建 Workshop-SalesWeekly。
4. 打开该文件夹，点击 Create or upload → Files upload / 文件上传，上传两个文件。
5. 在同一文件夹内新建子文件夹 Reports。
6. 点击 sales.xlsx 在 Excel 网页版打开。确认有 16 条数据行，列名包含 OrderId、SaleDate、Region、Product、Units、RevenueCNY、Status；点击表内单元格，查看 Table / 表格选项卡中的表名为 SalesTable。

完成后，OneDrive 中应有：

/Workshop-SalesWeekly/sales.xlsx
/Workshop-SalesWeekly/weekly-report-template.docx
/Workshop-SalesWeekly/Reports/      ← 先创建文件夹

示例邮箱 reviewer@example.com、sales-team@example.com 都是占位值，不可直接发送。用自己的测试邮箱替换；先只给自己创建草稿。

完成检查：两个文件可以在浏览器打开；Reports 文件夹存在；Copilot Studio 和 Power Automate 选择同一个有权限的开发环境。表名不正确、Word 无法打开或许可不满足时，先解决准备问题。

本手册的界面操作约定

添加流程动作：点击上一动作下方的 ＋ → Add an action / 添加操作，在搜索框输入动作名，再选择本手册指定的连接器。重命名：打开动作卡片，通过标题或 … → Rename / 重命名设置名称；必须先重命名，再粘贴引用该名称的表达式。

填写表达式：点击目标输入框，在新设计器输入 /，选择 Insert expression / 插入表达式，粘贴代码后点击 Add / 添加。代码块中的表达式不带开头 `@`，也不把它当普通文本输入。选择动态内容：在输入框选择 Insert dynamic content / 插入动态内容，从对应动作下选择字段。每次添加后点击另一输入框，确认令牌留在正确字段中。

固定值（例如 2026-10-09、5000）直接填入相应字段；不使用表达式编辑器。授权弹窗由学员自行完成登录和 MFA，不将密码写进流程或手册。

模拟数据和日期口径

SaleDate 是 YYYY-MM-DD 文本，RevenueCNY 是人民币元，Units 是件数；Status 只允许 Completed / Pending / Cancelled。OrderId 唯一，一行一单，未设计多行订单明细。

课堂固定报告日 2026-10-09（周五）、读取快照 2026-10-09T09:00:00Z = UTC+8 17:00。这不是把当前日期误当成 2026-10-09；正式版本要改为运行时日期。统计本周一至报告日，对比上周同星期截止日。

上周周末 20,000 元、当前周六 9,000 元、下一周 9,000 元都不应纳入周五的同期比较。日期列没有交易时间戳，不能精确逐笔排除周五 17:00 后录入的订单；本实验以读取快照为准。正式系统若要求严格截止，需新增带时区的时间戳并按 UTC 截止时间过滤。

第一步：建立 Recurrence 定时触发器（15 分钟）

本步产物：一个按每周五 17:00 UTC+8 触发的云端流，以及三个统一的时间输入。

1. 在 Microsoft Edge 打开 Power Automate，确认选中自己的开发环境。
2. 选择 Create / My flows → Create from blank，添加触发器 Recurrence。部分租户仍显示 Scheduled cloud flow，功能相同。
3. 流程命名为 Workshop-SalesWeekly-Friday。
4. 点击 Recurrence 卡片，在 Parameters / 参数中设置下表。看不到时区、星期、小时或分钟时，展开 Advanced parameters / 高级参数 → Show all / 显示全部。

17:00 是计划触发时间，不保证 Agent、Word 与邮件生成正好完成于 17:00。

图 1：Playwright 操作 Microsoft Edge，在真实 Power Automate 中设置 Week / Friday / 17 / 0；账号与环境信息已遮挡。该截图证明触发器参数配置，不证明完整报告链路已运行成功。

本轮核对仍为 Week / Friday / 17 / 0。最终以详情页的 Off 为准；固定课堂日期没有改为正式运行时日期。

图 2：Playwright 在 Edge 中截取的 Microsoft Learn 公开文档页面。原始文档。

1.1 先固定课堂测试时间

1. 在 Recurrence 下点击 ＋ → Add an action，搜索并选择 Data Operation / 数据操作 → Compose / 撰写，重命名为 RunUtc；在 Inputs 通过表达式编辑器添加 utcNow()。
2. 在 RunUtc 后再添加 Compose，重命名为 DataAsOf，Inputs 直接填固定值 2026-10-09T09:00:00Z。
3. 再添加 Compose，重命名为 ReportDate，Inputs 直接填固定值 2026-10-09。
4. 点击右上角 Save / 保存。返回流程详情页，确认定时流保持 Off / 关闭；再点击 Edit / 编辑继续第二步。

不要在课堂使用当前日期：模拟销售表对应的是固定测试周。RunUtc 用于唯一文件名；DataAsOf 和 ReportDate 用于销售数据口径。

完成检查：画布顺序为 Recurrence → RunUtc → DataAsOf → ReportDate；Recurrence 预览显示每周五 17:00；两个固定值分别在正确的 Compose 中，流程关闭。全部验收后再按“恢复正式定时运行”修改时间。

第二步：读取 Excel Online 数据并计算 Metrics（25 分钟）

本步产物：MetricsJson，包含经代码计算的销售指标，不包含 AI 推测。

2.1 读取 SalesTable

1. 上传 sales.xlsx 后，在 Excel 网页版打开；确认表名为 SalesTable。
2. 在 ReportDate 下添加 Excel Online (Business) → List rows present in a table，重命名为 ListSales。首次使用时，点击 Sign in / 登录创建自己的 Excel 连接。
3. 选择 Location = OneDrive for Business、Document Library = OneDrive、文件 /Workshop-SalesWeekly/sales.xlsx、Table = SalesTable。
4. 打开 ListSales 的 Settings / 设置选项卡，开启 Pagination / 分页，Threshold 填 5000；回到 Parameters，不设置 Top Count。
5. 不依赖 Excel 工作表已有筛选；此动作可能读取所有行。本实验由代码过滤两个比较周期。
6. 在 ListSales 下添加 Control / 控制 → Condition / 条件，重命名 CheckRowLimit。左侧通过表达式编辑器填写 length(body('ListSales')?['value'])，运算符选 is less than / 小于，右侧填数值 5000。
7. 在 False / 否分支添加 Control → Terminate / 终止：Status = Failed，Code = SALES_ROW_LIMIT，Message = 读取行数达到分页阈值，请核实数据完整性后重试。。实验通过失败状态和运行历史显式记录错误，不添加发送邮件动作。
8. 后续 AggregateMetrics 到 Outlook 的全部动作都放在 True / 是分支；不要放在 Condition 下方两个分支汇合的位置。

连接器默认最多返回 256 行；还存在 25 MB 文件限制和并发写入限制。演示仅 16 行，但课堂必须演练分页意识。

图 3：真实 Power Automate Excel Online (Business) 动作，已选中上传的 sales.xlsx 和 SalesTable；账号与环境信息已遮挡。动作尚保留默认名称，教材要求重命名为 ListSales，后续表达式必须与自己的实际动作名称一致。

2.2 保存脚本并绑定参数

1. 回到已打开的 sales.xlsx，选择 Automate / 自动化 → New Script / 新建脚本 → Create in Code Editor / 代码编辑器。打开 metrics.ts，复制全部代码，替换编辑器中的默认代码。
2. 将脚本命名为 WorkshopAggregateSales，点击 Save / 保存。main 参数是 rowsJson / reportDate / dataAsOf，返回 JSON 字符串。若没有 Automate 或脚本无法保存，检查 Office Scripts 权限，不继续下一项。
3. 回到 Power Automate，在 CheckRowLimit 的 True 分支添加 Excel Online (Business) → Run script，重命名 AggregateMetrics。
4. Location 选 OneDrive for Business，Document Library 选 OneDrive，File 选 /Workshop-SalesWeekly/sales.xlsx，Script 选 WorkshopAggregateSales。等待三个 Script 参数显示；未显示时重新选择已保存的脚本。
5. 在每个 Script 参数的表达式编辑器按表添加：

6. 在 AggregateMetrics 后添加 Data Operation → Parse JSON / 分析 JSON，重命名 ParseMetrics。Content 从 AggregateMetrics 的动态内容选择 result，不是整个动作输出；等价表达式为 body('AggregateMetrics')?['result']。
7. 点击 Generate from sample / 从示例生成，打开并复制 expected-metrics.json 全文，粘贴后点击 Done / 完成。在生成的 Schema 中找到 wowPercent，把其 type 改为 ["number", "null"]；上期为零时不能强制要求 number。
8. 在 ParseMetrics 后添加 Compose，重命名 MetricsJson，Inputs 通过表达式编辑器添加 string(body('ParseMetrics'))。
9. 保存，返回详情页按“课堂安全规则”临时开启，点击 Run / 运行 → Run flow / 运行流手动执行。打开本次运行，检查 ListSales、AggregateMetrics、ParseMetrics 与 MetricsJson 的输出；完成后关闭流程。

完成检查：ListSales.value 有 16 行；AggregateMetrics.result 是可解析 JSON；MetricsJson 中 revenueCNY=112000、previousRevenueCNY=60000、orderCount=6、units=91、wowPercent=86.67。没有取得这些实际输出，不进入第三步。运行详情中看到脚本返回值才算链路验证；Excel 手动执行“成功”提示不能代替该检查。

脚本拒绝重复订单、非法日期、负金额、超过两位小数的金额、非整数件数、未知状态和本期空数据。金额以分累加，避免 0.1 + 0.2 误差；上期为零返回 null，不是 Infinity 或伪造零增长。区域/产品同额时用名称作稳定排序。

第二步实际复跑：原有流程仅有 Recurrence → List rows present in a table → Run script，尚不具备上述全部节点。Excel 读取成功，但 Run script 返回 HTTP 404 / NotFound，RunScriptProd 的响应为 Operation not found，没有取得成功的脚本 result。不能据此认定文件或脚本被删除；再次运行前应核对原有连接、文件、脚本选择与动作。

见脱敏失败记录。依赖此步骤的周报链路到此停止；独立测试已有 Prompt 不等于此流程已生成 MetricsJson。

第三步：创建 Copilot Studio Agent 与 Prompt（25 分钟）

本步产物：Agent 草稿与已保存的 SalesWeeklySummary Prompt。本步先验证 Prompt，第四步再编程主题、发布 Agent 并接回 Power Automate。

3.1 创建 Agent

1. 在 Edge 打开 Copilot Studio，登录并选中与 Power Automate 相同的开发环境。
2. 若看到新体验首页，选择 Other ways to build → Build with standard orchestration → Agent；本实验需要支持 Prompt 的标准路径，不能把新体验默认卡片与标准 Agent 混为一谈。
3. Name 填 SalesWeeklyAgent，点击 Create / 创建；等待 Overview / 概述加载。
4. 在 Instructions / 指令 → Edit / 编辑中粘贴 instructions.txt 全文，点击 Save / 保存。
5. 在 Knowledge / 知识区域关闭 Web Search / 网页搜索，等待显示 Disabled / 已禁用。不添加外部知识或真实销售文件。

3.2 创建和测试 Prompt

1. 选择 Tools / 工具 → Add tool / 添加工具 → New tool / 新工具 → Prompt / 提示词；名称改为 SalesWeeklySummary。
2. 打开 prompt.txt，复制任务指令到 Prompt 编辑器；文件末尾关于“插入动态令牌”的说明是操作提示，不作为实际数据输入。
3. 点击 Add content / 添加内容 → Text / 文本。输入名称填 `MetricsJson`；测试示例值粘贴 [expected-metrics.json](data/expected-metrics.json) 全文。确认编辑器“实际输入”之后出现 `MetricsJson` 动态令牌，不是 {{MetricsJson}} 普通文本。
4. 选择租户可用且符合组织策略的模型。将 Output / 输出改为 JSON，打开 JSON output settings / JSON 输出设置，进入可编辑的 Custom 示例区域。
5. 粘贴 prompt-output-example.json 全文，点击 Apply / 应用。若显示先测试提示，先点击 Test / 测试，再重新打开输出设置填写自定义示例。
6. 点击 Test，等待 Model response / 模型响应。核对数字和结构；若出现代码围栏、金额改变、编造原因或截止时间推测，修正指令后重新测试。
7. 按当前编辑器提示保存 Custom / 自定义格式，再点击 Save / 保存。返回 Tools，确认 SalesWeeklySummary 存在且为 Enabled / 已启用。

完成检查：只有一个名为 MetricsJson 的文本输入；输出是 JSON；关键指标与基准一致；风险只能说明“日期列无交易时间戳，报告代表读取快照”和已知 Pending 情况，不能断言排除了某个时刻之后的订单。此处通过后才进入第四步。

Prompt 的 JSON 输出格式通过示例锁定；编辑器里的生成 schema 当前不可直接编辑。report.schema.json 给 Power Automate 的 Parse JSON 用，不是让你在 Prompt 编辑器直接粘贴 schema。

图 4：真实 Copilot Studio Prompt 编辑器的 JSON 输出设置。此截图取得于测试之前，右侧提示要求先 Test；它不是测试通过的截图。后续真实 Agent 已返回 JSON，结果与文案问题见“附录三：真实操作记录”。

图 5：Microsoft Learn Prompt 工具与编辑器说明。原始文档。

Prompt 的职责

Prompt 输出包含 reportDate / revenueCNY / orderCount / units / previousRevenueCNY / wowPercent / topRegion / topProduct 的原样复制，以及 summary / risks / nextActions / emailSubject / emailBody / pptOutline。

要求：不编造增长原因，不创建收件人，不生成可执行 HTML，不声称“已经发送”；缺少事实就说明限制。risks 和 nextActions 用 { "text": "..." } 对象数组，避免无键值的数组格式不被编辑器支持。

第三步复跑：第一次真实 Prompt 调用暴露了把增长百分比写成“百分点”、把业务日期标为 UTC 的问题。已修正仓库 Prompt，并在云端保留 MetricsJson 动态令牌、保存补充约束后重新测试。修正结果使用增长百分比，并单独说明 17:00（UTC+8） 快照。完整结果：初次调用，文案未通过、修正后的云端结果。

第四步：编程、发布 Agent 并接入定时流程（35 分钟）

本步产物：能一次返回 JSON 的已发布 Agent，以及 Power Automate 中的 ParseReport 与指标校验分支。创建主题必须在 Copilot Studio 完成，本地示例不冒充真实 Agent。

实施状态：下列固定输入/输出配置是验收要求。当前真实主题已经绑定 Prompt，但输入仍由 AI 动态填入，固定变量映射和流程调用尚未完成。具体输出字段用自己的工具变量选择器确认，不照抄虚构内部 ID。

4.1 建立机器请求主题

1. 打开第三步创建的 Agent，点击 Topics / 主题 → Add a topic / 添加主题 → From blank / 从空白创建，命名 GenerateWeeklyReport。
2. 点击顶部 Trigger / 触发器。在生成式编排中填写主题说明：处理以 WEEKLY_SALES_REPORT 开头的机器请求，提取换行后的 MetricsJson，调用 SalesWeeklySummary，只返回 JSON，不闲聊。。若界面使用触发短语，添加 WEEKLY_SALES_REPORT；不要把说明误填为一段用户消息。
3. 在触发器下点击 ＋ → Add a condition / 添加条件，通过 Power Fx 编辑器填写：

And(
    StartsWith(System.Activity.Text, "WEEKLY_SALES_REPORT"),
    Char(10) in System.Activity.Text
)

4. 在不满足条件的分支添加 Send a message / 发送消息，填入以下固定错误文本，再添加 End current topic / 结束当前主题。不要调用 Prompt：

{"error":"INVALID_WEEKLY_REQUEST","message":"请求必须包含 WEEKLY_SALES_REPORT、换行及指标 JSON。"}

5. 在满足条件的分支点击 ＋ → Variable management / 变量管理 → Set a variable value / 设置变量值。创建 String / 字符串变量 Topic.MetricsJson，值切换为 Formula / 公式，填入：

Trim(
    Mid(
        System.Activity.Text,
        Find(Char(10), System.Activity.Text) + 1,
        Len(System.Activity.Text)
    )
)

6. 在设置变量后点击 ＋ → Add a tool / 添加工具 → SalesWeeklySummary，在 MetricsJson 输入处选择 Custom value / 自定义值，绑定 Topic.MetricsJson。不要让本主题的输入继续动态填入不同指标。
7. 展开工具的 Outputs / 输出，通过变量选择器把报告 JSON 对象绑定为 Topic.PromptResult。具体报告对象路径以自己的工具 schema 为准，不假定叫 .text 或 .predictionOutput。
8. 在工具后添加 Send a message，在消息的 Formula / 公式编辑器填写：

JSON(Topic.PromptResult, JSONFormat.Compact)

如果变量选择器表明工具返回的报告已经是 JSON 字符串，直接选择该字符串变量，不再调用 JSON()，避免双重编码。如果输出是外层包装对象，选择其中的报告对象，不把包装对象整体作为报告。

9. 添加 End current topic / 结束当前主题，不添加满意度调查、问候或“还需要什么”；点击 Save。缺输入或工具失败必须显式失败，不构造成功形态的空报告。
10. 打开 Test / 测试面板，发送第一行 WEEKLY_SALES_REPORT，第二行粘贴 expected-metrics.json 全文。确认最终回复只有一个报告 JSON，且金额、订单数、件数与环比准确。

完成检查：不是只看到工具调用成功，而是看到 Agent 最终回复可直接解析为报告 JSON；没有 Markdown 围栏、外层包装或结语。缺少固定输入映射或无法确定输出对象时，在本节停止排查，不进入发布和邮件步骤。

完整实际响应已通过报告 schema 和指标对比：112000元、6单、91件、上期60000元、增长86.67%。输入来自虚构 expected-metrics 夹具，不是本轮失败的 Office Script 输出。

4.2 编程帮助主题

1. 在 Topics 再新建 WeeklyReportHelp。
2. 在触发器说明中填 解释周报口径、同期环比，以及为什么默认只创建邮件草稿。；若界面使用触发短语，添加 周报口径、环比是什么、为什么不直接发送邮件。
3. 添加 Send a message，填入：本周周一至报告日的已完成订单，对比上周同星期截止日。金额由 Office Script 计算，Prompt 只提取指标并写摘要；我不直接发送邮件，Outlook 默认生成草稿。
4. 添加 End current topic，保存。在 Test 输入 解释周报口径，确认回复符合上面的口径且不声称读取了 Excel。
5. 点击 … / More → Open code editor / 打开代码编辑器，查看设计器生成的 YAML。可对照 help-topic.yaml 学习，但触发短语模式与生成式说明模式的 YAML 不同；优先以自己设计器生成的代码为准。

真实操作截图：WeeklyReportHelp 已由设计器保存；截图只保留代码区域。该租户使用 modelDescription 和 intent: {}，不是触发短语示例的逐字导入结果。

实际帮助回复说明同期口径、代码计算金额和默认草稿边界。

4.3 测试与发布

1. 在 Test 依次执行下表测试。课堂至少完成正常机器请求、缺输入、帮助口径和拒绝直接发送四项。

2. 若 Publish / 发布不可用，悬停查看提示。本次真实界面要求至少一个渠道：点击 Channels → Microsoft 365 and Microsoft Teams → Add channel，添加组织允许的已认证渠道；不关闭认证，也不分享给整个组织。
3. 点击 Publish，等待明确显示 Published / 已发布。只有“Publishing…”或已点按钮不算成功。
4. 保存自己的主题和解决方案；迁移时在目标环境重新绑定连接引用和权限，不复制本手册中的真实租户标识。

完成检查：Agent 显示 Published；机器测试回复通过结构、指标和文案审阅。发布只针对当前教学 Agent，不发布无关对象。

4.3 复跑结果：缺输入时仍用英文追问 MetricsJson，没有返回固定的 INVALID_WEEKLY_REQUEST JSON，故该机器协议用例未通过；真实主题的固定输入/输出映射仍缺失。独立测试中，上期为零返回 wowPercent=null 并明确不可计算；外部发送请求被拒绝；“忽略规则并群发”仅保留为数据，没有调用邮件。Studio 对话不证明真实 Outlook 流程的授权或发送已验收。

完整记录：缺输入、上期为零、外发拒绝、输入注入。

4.4 在 Power Automate 调用真正的 Agent

1. Agent 发布后，在 MetricsJson 后添加 Microsoft Copilot Studio → Execute Agent and wait，重命名 ExecuteSalesAgent。
2. 首次使用时，按提示建立组织允许的连接。Agent 下拉框选择本环境的 SalesWeeklyAgent；若找不到，检查同一环境、Published 状态和连接账号权限。
3. 在 Message 的表达式编辑器添加：

concat('WEEKLY_SALES_REPORT',decodeUriComponent('%0A'),outputs('MetricsJson'))

4. locale = zh-CN；Conversation ID 留空，防止下周继承旧数据。连接使用组织允许的认证。
5. 下游使用 lastResponse，不要把只有 ConversationId 的 Execute Agent 当作能立即提供报告。

图 6：公开连接器文档说明 lastResponse / responses / conversationId。原始文档。

4.4 复跑：在真实动作选择器搜索后，仍未取得可选择的 Execute Agent and wait，没有执行流程到 Agent 的调用。这只是本轮界面观察，不代表租户永久不支持；脚本失败和机器协议失败也已阻止下游验收。

4.5 校验响应再允许生成文件

1. 在 ExecuteSalesAgent 后添加 Condition，重命名 CheckAgentResponse。左侧表达式填 empty(body('ExecuteSalesAgent')?['lastResponse'])，运算符选择 is equal to / 等于，右侧也通过表达式编辑器填 false。实际字段位置通过该动作的动态内容确认；这里不能填字符串 "false"。
2. False 分支添加 Terminate：Status = Failed，Code = EMPTY_AGENT_RESPONSE，Message = Agent 未返回报告，请检查发布状态与主题输出。。以下操作都放在此条件的 True 分支。
3. 添加 Data Operation → Parse JSON，命名 ParseReport；Content 从 ExecuteSalesAgent 动态内容选 lastResponse，Schema 粘贴 report.schema.json 全文。
4. 添加 Condition，重命名 CheckReportMetrics，使用 And / 且组合条件，逐行比较 ParseReport 与 ParseMetrics 的下列字段，全部相同才通过： reportDate, revenueCNY, orderCount, units, previousRevenueCNY, wowPercent； 再比较 topRegion.name / revenueCNY 和 topProduct.name / revenueCNY。

每行左、右分别通过表达式编辑器填写。例如金额为 body('ParseReport')?['revenueCNY'] is equal to body('ParseMetrics')?['revenueCNY']；领先区域名为 body('ParseReport')?['topRegion']?['name'] is equal to body('ParseMetrics')?['topRegion']?['name']。其余字段按同样方式添加，不能只比较总金额。

5. wowPercent 可能为 null，双方均 null 才算一致。不把 null 当零；本实验直接比较脚本保留两位小数的数值。
6. 在同一个 And 条件组中追加下表四行；运算符都选 is equal to / 等于，左右都通过表达式编辑器输入：

7. False 分支添加 Terminate：Status = Failed，Code = REPORT_METRICS_MISMATCH，Message = Agent 指标或邮件主题未通过核对，停止生成文件和草稿。。第五、六步的全部动作都放在 CheckReportMetrics 的 True 分支。
8. 保存并从详情页手动运行，检查 ExecuteSalesAgent 的实际 lastResponse、ParseReport 和两个 Condition。纯文本正文及风险仍需人工审阅；本地校验实现见 scripts/runtime.mjs → validateReport。

完成检查：lastResponse 是报告 JSON；ParseReport 成功；指标条件为 True。此处未通过，不生成 Word 和邮件。动作找不到时记录阻塞，不改用不等待响应的 Execute Agent 来冒充完成。

Parse JSON 只检查结构，并不证明内容正确；同样，逐项指标一致不能证明生成文案完全无误。草稿人工审阅是最后一道关卡。

最终画布位置对照

第五、六步完成后，画布应保持以下结构。缩进表示条件分支，所有下游操作都在三个检查的 True 分支内部：

Recurrence → RunUtc → DataAsOf → ReportDate → ListSales
  → CheckRowLimit
      False → Terminate（SALES_ROW_LIMIT）
      True
        → AggregateMetrics → ParseMetrics → MetricsJson → ExecuteSalesAgent
        → CheckAgentResponse
            False → Terminate（EMPTY_AGENT_RESPONSE）
            True
              → ParseReport → CheckReportMetrics
                  False → Terminate（REPORT_METRICS_MISMATCH）
                  True
                    → SelectRisks → RisksText
                    → SelectNextActions → NextActionsText
                    → ReportFileName → PopulateWord → CreateWordFile
                    → SafeEmailText → DraftBody → DraftWeeklyEmail

第五步：Word 模板生成排版报告（20 分钟）

本步产物：一份保存在 OneDrive Reports 文件夹内的排版 Word 报告。操作位置始终在 CheckReportMetrics 的 True 分支。

5.1 把风险与建议转换为多行文本

1. 在 True 分支添加 Data Operation → Select / 选择，重命名 SelectRisks。From 用表达式 body('ParseReport')?['risks']。
2. 将 Map / 映射切换为文本模式，填写表达式 item()?['text']。输出应为字符串数组，不是带新键值的对象数组。
3. 在其后添加 Compose，重命名 RisksText，Inputs 填表达式 join(body('SelectRisks'),decodeUriComponent('%0A'))。
4. 添加另一 Select，重命名 SelectNextActions。From 填 body('ParseReport')?['nextActions']，Map 文本模式填 item()?['text']。
5. 添加 Compose，重命名 NextActionsText，Inputs 填表达式 join(body('SelectNextActions'),decodeUriComponent('%0A'))。
6. 添加 Compose，重命名 ReportFileName，Inputs 填以下表达式。后续文件和附件共用此名称，避免重复拼出不同名字：

concat('SalesWeekly-',outputs('ReportDate'),'-',
       formatDateTime(outputs('RunUtc'),'yyyyMMddHHmmss'),'.docx')

5.2 填充 Word 模板

1. 在 ReportFileName 后添加 Word Online (Business) → Populate a Microsoft Word template，重命名 PopulateWord。首次使用时建立组织允许的 Word 连接。
2. Location 选 OneDrive for Business，Document Library 选 OneDrive，File 通过文件选择器选 /Workshop-SalesWeekly/weekly-report-template.docx。
3. 等待 12 个模板字段出现。若未出现，确认使用本项目的 DOCX、控件类型为纯文本且标题唯一；普通 {{Revenue}} 占位文字不是动态字段。重新选择正确文件后仍无字段时，先处理模板/许可问题。
4. 在各字段的表达式编辑器按下表添加。表中是可粘贴表达式，不是伪代码或属性路径简写：

模板已启用多段落纯文本控件。字号、标题、表格、页脚保留在模板里；Prompt 写摘要，不负责设计 Word 页面。

5.3 保存和检查报告

1. 在 PopulateWord 后添加 OneDrive for Business → Create file / 创建文件，重命名 CreateWordFile。
2. Folder Path 填 /Workshop-SalesWeekly/Reports；File Name 从动态内容选择 ReportFileName 的 Outputs。
3. File Content 从 PopulateWord 动态内容选择 Microsoft Word document 二进制输出，不是文件 URL，不做二次 Base64 编码。
4. 保存并按课堂安全规则手动运行一次。打开 OneDrive 的 Reports 文件夹，找到本次 SalesWeekly-2026-10-09-<运行时间>.docx，在 Word 网页版打开；运行结束后关闭定时流。

完成检查：报告显示 112,000.00 元、6 单、91 件、86.67%、华东 47,000.00 元、订阅B 63,000.00 元；风险和建议分行，无未填充控件、JSON 数组或“null”。UTC 快照时间写明时区；文案不宣称按不存在的时间戳过滤了订单。

可选 PDF：先保存 DOCX，按官方限制等待文件可见（约 1 分钟），再调用 Convert Word Document to PDF；不要用文件内容当文件标识符。基础实验不要求 PDF。

可下载离线模拟 Word 报告 对照排版；它不是已运行云端 Word Connector 的证明。

第六步：Outlook 草稿与可选群发（20 分钟）

本步产物：自己 Outlook 草稿箱中的一封周报，包含正确的 Word 附件。基础实验不添加发送动作。

6.1 生成安全的邮件正文

1. 在 CreateWordFile 后添加 Compose，重命名 SafeEmailText。
2. 在 Inputs 的表达式编辑器粘贴以下表达式。先转义 & 和尖括号，再将换行转为 <br>：

replace(
  replace(
    replace(
      replace(body('ParseReport')?['emailBody'],'&','&'),
      '<','&lt;'
    ),
    '>','&gt;'
  ),
  decodeUriComponent('%0A'),'<br>'
)

3. 在其后添加 Compose，重命名 DraftBody，Inputs 填表达式：

concat('<h2>销售周报</h2>',
       '<p>以下为待审阅的销售周报，请核对 Word 附件。</p>',
       '<p>',outputs('SafeEmailText'),'</p>')

不要直接运行模型返回的 HTML，不拼接模型生成的链接、属性或脚本。需要富文本时使用组织审查过的模板。

6.2 创建 Outlook 草稿

1. 在 DraftBody 后添加 Office 365 Outlook → Draft an email message，重命名 DraftWeeklyEmail。首次使用时建立自己的 Outlook 连接。
2. 按下表填写；Attachments 未显示时展开 Advanced parameters / 高级参数，并添加一个附件项：

3. 点击 Save，按课堂安全规则手动运行一次；查看 DraftWeeklyEmail 是否成功，运行结束后关闭定时流。
4. 在 Edge 打开自己的 Outlook 网页版，点击 Drafts / 草稿，搜索主题中的 2026-10-09销售周报。如果模型在日期和标题之间插入空格，分别搜索日期和“销售周报”。
5. 打开本次草稿，检查 To 只有自己、关键指标正确、正文分段、Word 附件名称与 OneDrive 文件一致；打开附件核对内容。不要点击 Send / 发送。

完成检查：运行历史显示草稿动作成功，且草稿箱确实存在本次邮件、附件可以打开；只有动作配置截图或模拟预览不算完成。多次手动运行会产生多份报告和草稿，请只审阅本次运行的文件。

Send an email (V2) 没有本实验所需的“Save as Draft”开关；不能用发送动作冒充草稿。 真正的草稿动作是 Draft an email message；后续可用 Send a Draft message 发送已有草稿，但草稿可能被人工编辑，需重新审阅。

6.3 可选进阶：审批后发送或群发

正式实验只在确认权限和收件人后启用发送分支：

1. SendMode 默认 Draft，可通过管理员控制的环境变量改为 ApprovedSend，不让用户自由给任意邮箱。
2. 添加 Approvals → Start and wait for an approval。审批对象是报告内容与固定收件人；审批拒绝/超时不发送。
3. 仅当 Outcome = Approve，且配置的收件人属于组织允许列表时，才调用 Send an email (V2)。
4. 群发用自己的组织分发列表；不要把 sales-team@example.com 当作真实列表，不用未授权 BCC。
5. 记录 ReportDate、运行标识、审批结果、文件位置和发送状态；真实收件人等敏感信息遵守日志策略。
6. 正式上线加幂等记录：例如 SharePoint 列表唯一键 SalesWeekly:<ReportDate>:<Audience>，流程并发设 1。发送结果未知时人工对账，不能自动重试到重复群发。只有成功收到明确确认才记为 Sent。

第七步：PPT 管理层简报扩展（10 分钟）

本步产物：人工核对后保存的三页管理层简报。此项需要 PowerPoint Copilot 许可，未具备时可只交付 Markdown 大纲，并明确记录“未生成 PPTX”。

基础主链路没有实现无人值守 PowerPoint 文件生成。Prompt 的 pptOutline 提供三页内容，Word 报告作为可信输入：

1. 打开 PowerPoint，选择 Copilot 的基于文件创建演示文稿（需对应 Microsoft 365 Copilot 能力）。
2. 选择云端保存的 Word 周报，使用 demo-ppt-outline.md 的三页结构：业绩、分布、行动。
3. 提示词：

根据这份销售周报创建 3 页中文管理层演示文稿。
第 1 页展示本周金额、订单数、件数与上周同期环比；
第 2 页展示区域与产品贡献；
第 3 页展示报告中的风险和下周建议。
不得增加输入文件中没有的客户、目标或增长原因。金额单位为人民币元。

4. 人工核对数据、图表、保密标签及分享权限，保存 .pptx。

完成检查：仅有三页，金额单位人民币元；第一页指标为 112000 / 6 / 91 / 86.67%，第二页区域与产品数据来自报告，第三页风险与建议不新增事实。没有实际保存文件就不标记 PPTX 成功。

若要无人值守 PPTX，需另行设计受治理的文件生成服务或经验证的特定连接器，不假设存在能完成本任务的通用内置 PowerPoint Connector。本教材交付的是大纲，不是自动生成的 PPTX。

实验验收与故障排查

手动验收的操作

1. 确认 ReportDate=2026-10-09、DataAsOf=2026-10-09T09:00:00Z，To 只有自己的测试邮箱，流程中没有 Send an email 动作。
2. 保存并返回流程详情，临时开启流程，点击 Run / 运行 → Run flow / 运行流。
3. 在 Run history / 运行历史打开本次运行，逐一点击动作查看 Inputs / 输入与 Outputs / 输出；错误时定位最先失败的动作，不只看最后一项是否跳过。
4. 按下表逐项检查，打开真实 Word 文件和 Outlook 草稿；完成后关闭定时流。没有真实结果的项标记为“未完成/阻塞”，不把离线模拟文件当作成功证据。

失败演练

1. 在 sales.xlsx 临时复制一条已有 OrderId 的订单，保存后手动运行：应在 AggregateMetrics 明确失败，不创建报告和草稿；随后删除刚复制的行并保存。
2. 在单独的 Agent 测试中删除 Metrics JSON，检查明确缺输入错误。不要为演练改动真实业务数据。
3. 在临时测试副本的 CheckReportMetrics 中将收入比较的右值设为 1，手动运行：应进入 REPORT_METRICS_MISMATCH 分支。恢复原表达式后再验证正常链路。

恢复正式定时运行

只在全部基础验收通过、确认数据源已经换成持续更新的销售表后操作：

1. 打开 DataAsOf 的 Inputs，删除固定值，通过表达式编辑器添加 outputs('RunUtc')。
2. 打开 ReportDate 的 Inputs，删除固定值，添加：

formatDateTime(
  convertTimeZone(outputs('RunUtc'),'UTC','China Standard Time'),
  'yyyy-MM-dd'
)

3. 保留 RunUtc=utcNow()，重新核对 Recurrence 为 Week / Friday / 17 / 0 / UTC+8。
4. 保存，手动验证实际运行日期的数据与同期比较；无本期数据时应明确失败，不生成零销售的假报告。
5. 确认审批与收件人治理后 Turn on / 开启。仍默认草稿；只有另行完成审批和幂等改造才启用群发。

常见问题

附录一：Markdown 与配套文件的使用

在工作区打开 lab-01/README.md，使用 VS Code Markdown 预览或支持 Markdown 的阅读器阅读。data/、agent/、templates/、output/ 与 screenshots/ 均在 lab-01/ 内；复制实验时保留整个文件夹，相对链接无需修改。

若需要重新生成模拟数据和离线 Word 示例，使用 Node.js 22：

cd lab-01
npm ci
npm run generate
npm run check
npm test

模拟文件生成不访问真实 Microsoft 365，不读取真实销售数据，不发送邮件。真实产品截图必须来自登录后的 Microsoft Edge 操作，不用本地网页替代产品界面。Playwright 启动 Edge 的配置为：

const browser = await chromium.launch({
  channel: "msedge",
  headless: true
});

Playwright 用 chromium API 操作 Edge 的 Chromium 引擎，不意味着启动 Google Chrome。脚本必须验证 User-Agent 含 Edg/；不提供 Chrome/Chromium fallback。若 Edge 未安装或组织禁止自动化，明确报错。npm 使用 .npmrc 中的微软代理端点。

公开文档截图来源清单 记录 Microsoft Learn 截图的浏览器、时间及来源；真实操作截图的状态在各图注与“真实操作记录”中记录。离线模拟 Word 报告、模拟结构化结果 和 PPT 大纲 Markdown 可直接下载对照。

附录二：官方参考

核实日期：2026-10-11。界面、许可、功能可用性可能按租户与区域变化；以实际环境和官方文档为准。

• Recurrence / Scheduled flow
• Excel Online (Business)
• Copilot Studio Prompt 工具与节点
• Prompt JSON 输出与 Custom 示例
• Power Automate Run a prompt
• Microsoft Copilot Studio Connector
• Word Online (Business)
• Office 365 Outlook
• Copilot Studio 主题与代码编辑器
• Agent 与 Agent flows 的关系

附录三：真实操作记录

以下记录来自 Playwright 操作 Microsoft Edge 的真实登录会话，使用虚构销售数据；不公开账号、租户 ID 或登录状态。

本轮记录取代历史“待重测”的观察，不改变集成链路未完成的状态。本轮截图来源区分真实配置检查、实际调用与失败证据。

当前交付是 Markdown 实操教材、配套资产和已取得的真实步骤截图，不是完整云端链路已验收的声明。 完成后续操作时，必须核实发布、脚本输出、Agent 返回、Word 文件和 Outlook 草稿，才能将相应行改为成功。固定测试日期尚未恢复为运行时日期；未验收的定时流程应保持关闭，避免定期生成过期数据。