跳转到内容
Picaro.AI Picaro.AI Prompt Library

生成报告

月度·周度报告由 AI 一次性组装并以 HTML 幻灯片形式输出。 从数据源探索 → 预检 → 数据采集 → 幻灯片构建 → HTML 渲染，既可以一条命令完成，也可以分步确认推进。

本类别的使用场景

Section titled “本类别的使用场景”
  • “用一条命令做一份像样的报告”
  • “想先确认数据获取状态”
  • “想保存并复用自定义报告设置”
  • “想先确认是否能生成贡献度幻灯片”
  • “想生成包含 Before/After 对比的报告”

提示词 1：一条命令生成报告

Section titled “提示词 1：一条命令生成报告”

🎯 目的

Section titled “🎯 目的”

指定最近期间和对比期间，从数据预检到 HTML 幻灯片输出一条命令完成。

📋 使用场景

Section titled “📋 使用场景”
  • 想用一条命令将最近的广告报告输出为 HTML
  • 月末·周末的标准报告每次都按相同步骤生成
  • 不想关注各个步骤，只想拿到结果

📝 提示词

Section titled “📝 提示词”
请使用期间 {{PERIOD}}、对比期间 {{COMPARE_PERIOD}} 生成标准报告。
HTML 输出模式，自动衔接执行：预检 → 数据采集 → 幻灯片构建 → HTML 渲染。
max_pages {{MAX_PAGES}}。
中途若发现问题请停止并向用户确认。

占位符：

占位符说明默认来源
{{PERIOD}}对象期间（例：2026-04-01〜2026-04-30）用户输入（默认是最近已确定的月份）
{{COMPARE_PERIOD}}对比期间（例：2026-03-01〜2026-03-31）用户输入（默认是上月同期间）
{{MAX_PAGES}}幻灯片最大张数（例：10）默认 10

⚙️ AI 要做的事

Section titled “⚙️ AI 要做的事”
  1. 预检 — 用轻量处理确认 SQP·广告报告·销售各数据源在对象期间是否齐备
    • 为何要预检：报告生成耗时较长，若最后阶段因数据缺失而失败会很浪费
  2. 数据采集 — 从预检判定为 ready 的数据源采集 KPI·贡献度·Before/After 对比的素材
    • 为何也采集 Before/After：为了在报告中同时附上期间内执行的策略的效果验证
  3. 幻灯片结构组装 — 按 标题 / 摘要 / KPI / 贡献度 / 策略 Before/After / 下月行动方案 的顺序组织
    • 为何固定顺序：月度报告通常是管理层·代理商客户快速浏览，每月按相同顺序阅读能提高业务效率
  4. HTML 渲染 — 将幻灯片导出为 HTML，返回可共享的 URL
    • 为何选择 HTML：能同时支持 Slack 配信·内部 Wiki 嵌入·PDF 化
  5. 中途停止判定 — 预检出现 blocked / needs_confirmation 时立即停止并提示应对方针

📊 Example Output

Section titled “📊 Example Output”

报告生成 完成 期间：2026-04 / 对比：2026-03

项目结果
预检ready
数据采集完成（SQP 4 周 / 广告 30 天 / 销售 30 天）
幻灯片10 张（摘要 1 / KPI 2 / 贡献度 3 / 策略 Before/After 2 / 下月行动方案 2）
HTML 预览https://reports.picaro.ai/r/XXXXXX

预览 URL 有效期为 7 天。若要粘贴到 Slack 配信，直接共享该 URL 即可。 若想重新生成请回复”再生成一次”，若仅想替换特定幻灯片可以指定”只替换 KPI 幻灯片”等。

🔒 安全装置

Section titled “🔒 安全装置”
  • 预检判定为 blocked 时 不进入数据采集即停止（防止用无效数据生成报告）
  • 若混入推算值则 在幻灯片开头自动插入备注
  • 含敏感信息（客户名称·账户信息等）的项目 自动遮蔽（隐去或显示”***”）
  • 生成失败时 从最后一个成功步骤回退生成（即使只有模板也尽量保留体裁）
  • HTML 预览 URL 有效期为 7 天，超期需要重新生成
  • 样本数不足（对象期间行数低于阈值）时在开头显示警告

🚦 执行模式

Section titled “🚦 执行模式”
Phase状态条件
Phase 1（当前）一次性仅需 Picaro 接入即可使用
Phase 2（Q3 2026）月末手动报告规则注册 +“保存提示词”化，月末一键
Phase 3（Q4 2026）月末自动 + Slack 配信通过报告规则 ID 月末自动生成，HTML URL 配信至 Slack
Phase 4（2027）月末自动 + 异常时临时生成KPI 急剧变化检测时自动生成临时报告

👉 接下来要做的事

Section titled “👉 接下来要做的事”

❓ 常见问题

Section titled “❓ 常见问题”

Q：生成的 HTML 报告可以粘贴到 Slack 配信吗？ A：可以。将 HTML 预览 URL 粘贴到 Slack 会自动 Unfurl，可用于内部·客户共享。Phase 3 之后将通过 Slack 工作流联动自动配信。

Q：能让幻灯片不是 10 张吗？ A：可以。通过 {{MAX_PAGES}} 指定，或在生成后通过”只保留 KPI 幻灯片并压缩”等追加指令调整张数。

提示词 2：分步构建报告

Section titled “提示词 2：分步构建报告”

🎯 目的

Section titled “🎯 目的”

将预检·数据采集·幻灯片构建·HTML 渲染 4 个步骤逐一确认推进，并可在中途插入幻灯片结构的自定义。

📋 使用场景

Section titled “📋 使用场景”
  • 想边确认各步骤的中间产物边推进
  • 想先确认数据获取状态再进入数据采集
  • 想编辑幻灯片结构后再 HTML 化

📝 提示词

Section titled “📝 提示词”
请分步生成报告：
1. 用期间 {{PERIOD}} / 对比期间 {{COMPARE_PERIOD}} 做预检
2. status=ready 则执行数据采集
3. 提示幻灯片结构（若有编辑要求请反映）
4. HTML 渲染


每一步确认结果后再进入下一步。
中途若出现 blocked / needs_confirmation 请停止并告知。

占位符：

占位符说明默认来源
{{PERIOD}}对象期间用户输入
{{COMPARE_PERIOD}}对比期间用户输入

⚙️ AI 要做的事

Section titled “⚙️ AI 要做的事”
  1. Step 1：预检 — 执行与提示词 1 相同的预检逻辑
    • 为何最初独立成步：让人在数据缺失或匿名化率高时判断是否投入后续步骤
  2. Step 2：数据采集（确认后执行） — ready 判定后用户回复”下一步”再开始数据采集
    • 为何采用确认制：为了应对看完预检结果后想更改对象期间的场景
  3. Step 3：幻灯片结构提示 — 按 标题 / KPI / 贡献度 / 策略 Before/After / 下月行动方案 的顺序提示结构方案
    • 为何在 HTML 化前提示：为了在 HTML 渲染之前反映”想削减贡献度幻灯片、加厚 KPI”这样的编辑要求
  4. Step 4：HTML 渲染 — 结构方案确定后输出 HTML，返回可共享的 URL
  5. 步骤间状态管理 — 保留各步骤的中间产物，可回退（前一步重新执行）

📊 Example Output

Section titled “📊 Example Output”

Step 1：预检 完成 status=ready

SQP 4 周 / 广告 30 天 / 销售 30 天 均可获取。 回复”下一步”将开始数据采集。

Step 3：幻灯片结构（编辑前）

#幻灯片内容
1摘要本月 KPI 与总评
2-3KPIACoS / TACoS / ROAS 的月度走势
4-6贡献度按搜索词的销售贡献 Top 20
7-8策略 Before/After期间内执行的出价调整的效果验证
9-10下月行动方案有改善空间的关键词 / 机会评分前列的搜索词

如有编辑要求请指示”将 KPI 幻灯片压缩为 1 张""将贡献度扩展到 Top 30”等。 若按此推进请回复”HTML 化”。

🔒 安全装置

Section titled “🔒 安全装置”
  • 每一步在 有明确”下一步”指示前都会等待（不会自动进入下一步）
  • Step 2 的数据采集可中途取消，已采集数据会被丢弃
  • 编辑幻灯片结构时，敏感信息遮蔽规则 不可由用户解除（编辑 UI 侧始终适用）
  • HTML 预览 URL 有效期为 7 天
  • 同一会话内中间产物 保留 1 小时，超期需从头重新执行

🚦 执行模式

Section titled “🚦 执行模式”
Phase状态条件
Phase 1（当前）一次性（分步确认）仅需 Picaro 接入即可使用
Phase 2（Q3 2026）保持一次性因前提是自定义编辑，不纳入自动化
Phase 3（Q4 2026）保持一次性可在报告规则中保存编辑模板
Phase 4（2027）保持一次性为保留自定义性继续一次性

👉 接下来要做的事

Section titled “👉 接下来要做的事”

提示词 3：仅做贡献度数据预检

Section titled “提示词 3：仅做贡献度数据预检”

🎯 目的

Section titled “🎯 目的”

在进入报告生成主体之前，用轻量处理先判定贡献度幻灯片所需的 SQP·广告数据是否齐备。

📋 使用场景

Section titled “📋 使用场景”
  • 月末后想先只知道”数据是否齐备”
  • 想含对比期间一起确认行数是否充足
  • 想判定贡献度幻灯片是否可生成

📝 提示词

Section titled “📝 提示词”
请用期间 {{PERIOD}}、对比期间 {{COMPARE_PERIOD}}
执行贡献度数据预检。
输出数据源探索结果、对象期间和对比期间的行数、
匿名化搜索词比例、是否可回退。
max_pages {{MAX_PAGES}}。

占位符：

占位符说明默认来源
{{PERIOD}}对象期间用户输入
{{COMPARE_PERIOD}}对比期间用户输入
{{MAX_PAGES}}获取页面数上限默认 10

⚙️ AI 要做的事

Section titled “⚙️ AI 要做的事”
  1. 数据源探索 — 在 SQP / 广告报告 / 销售中识别对象期间可获取的源
    • 为何要事前探索：报告本体生成处理时间长，最后因数据缺失失败会浪费工时
  2. 对象期间与对比期间的行数确认 — 按件数判定两期间是否有充足数据
    • 为何也看对比期间：贡献度以”与前期间的差异”输出，仅一侧齐备无法成立对比
  3. 匿名化搜索词比例 — 返回 Amazon 匿名化的搜索词占多少比例
    • 为何要看匿名化率：匿名化多的期间，按词分解的贡献度会变粗，影响报告粒度
  4. 回退可行性判定 — 数据缺失时是否可用替代源（仅广告数据等）生成
  5. 返回 status — 以 ready / needs_confirmation / blocked 三级呈现结果

本提示词调用与 用 SQP 查看市场搜索漏斗 提示词 3 相同的工具。可以从 SQP 一侧或报告一侧任一入口执行。

📊 Example Output

Section titled “📊 Example Output”

贡献度数据预检 期间：2026-04 / 对比：2026-03

项目结果
SQP 数据可获取（对象 4 周 / 对比 4 周）
广告报告可获取（对象 30 天 / 对比 30 天）
匿名化搜索词12.4%（在允许范围内）
回退不需要
statusready

可以直接推进到报告生成。 请使用 一条命令生成报告 生成月末报告。

🔒 安全装置

Section titled “🔒 安全装置”
  • 仅做预检 — 不会发生报告生成或对广告账户的写入
  • 匿名化搜索词比例高的期间会返回 needs_confirmation，把生成可否交给人来判断
  • 数据缺失的期间会返回 blocked 并提示应对步骤
  • 受 SQP 报告确定延迟的影响，月末后紧接的期间指定可能会预检失败（请等几天再执行）
  • 含敏感信息（客户名称·账户信息等）的字段也会被排除在确认结果之外

🚦 执行模式

Section titled “🚦 执行模式”
Phase状态条件
Phase 1（当前）一次性仅需 Picaro 接入即可使用
Phase 2（Q3 2026）月末手动作为报告生成前的预检在月末执行
Phase 3（Q4 2026）月末自动作为报告自动生成的前置自动执行，仅 blocked 时通知
Phase 4（2027）月末自动与异常时临时生成联动

👉 接下来要做的事

Section titled “👉 接下来要做的事”

提示词 4：报告规则的保存与复用

Section titled “提示词 4：报告规则的保存与复用”

🎯 目的

Section titled “🎯 目的”

为自定义报告设置赋予 ID 并保存，使月度生成时能调用相同设置。

📋 使用场景

Section titled “📋 使用场景”
  • 想每月以相同体裁生成报告
  • 想固定”禁止推测 / 推算值确认”的方针
  • 在代理商有多个不同客户的报告样式

📝 提示词

Section titled “📝 提示词”
管理报告规则：
- 列表：action=list
- 获取：action=get rule_id={{RULE_ID}}
- 保存：action=upsert rule_id={{RULE_ID}} name={{RULE_NAME}} rules={{RULES_JSON}}
- 删除：action=remove rule_id={{RULE_ID}}


保存的规则会在之后的数据采集·幻灯片构建·
报告生成中被复用。

占位符：

占位符说明默认来源
{{RULE_ID}}规则 ID（例：monthly-standard / agency-client-a）用户输入
{{RULE_NAME}}规则的显示名用户输入
{{RULES_JSON}}规则本体（幻灯片结构·阈值·遮蔽设置等）用户输入

⚙️ AI 要做的事

Section titled “⚙️ AI 要做的事”
  1. 按 action 分支处理 — 区分 list / get / upsert / remove 四种操作
  2. 规则本体的验证 — upsert 时确认必填项（幻灯片结构·数据源·期间类型）是否齐备
    • 为何要验证：用不完整的规则生成报告，后续幻灯片构建会出现意料之外的缺漏
  3. 常用规则示例的提示 — 将以下组合作为模板提示
    • 禁止推测：不让 AI 补全缺失数据（必要推算值时需显式确认）
    • 推算值确认：含推算值时务必在报告开头插入备注
    • 贡献度 precheck 必须：不允许跳过贡献度数据预检
    • 敏感信息遮蔽强化：除客户名称·账户信息外，将特定列名追加到自动遮蔽目标
  4. 规则 ID 重复防护 — upsert 时若同 ID 已存在则发出警告，经明确确认后再覆盖
  5. 复用时自动引用 — 在提示词 1 / 2 中指定规则 ID，将自动应用所保存的规则

📊 Example Output

Section titled “📊 Example Output”

规则保存 完成 rule_id=monthly-standard

项目设置
名称月度标准报告
幻灯片张数上限10
必备幻灯片摘要 / KPI / 贡献度 / 策略 Before/After
推算值处理必须确认（自动插入开头备注）
贡献度 precheck必须
敏感信息遮蔽自动遮蔽客户名称 / 账户信息 / 个人姓名

之后在提示词 1 / 2 中指定 rule_id=monthly-standard，将以此设置生成。

🔒 安全装置

Section titled “🔒 安全装置”
  • upsert 仅在明确确认后覆盖（防止误覆盖已有规则）
  • remove 是完全删除且不可恢复，删除前要求最终确认
  • 敏感信息遮蔽设置 即使用户解除，默认遮蔽（客户名称·账户信息）始终适用
  • 规则本体（rules）仅保存在内部，不会显示在 CMS 或公开页面
  • 每个账户的规则数 上限为 50 个（超过时会要求从旧的开始整理）

🚦 执行模式

Section titled “🚦 执行模式”
Phase状态条件
Phase 1（当前）一次性仅需 Picaro 接入即可使用
Phase 2（Q3 2026）保持一次性预计可从 CMS UI 编辑规则
Phase 3（Q4 2026）保持一次性通过规则 ID 与报告自动生成联动
Phase 4（2027）保持一次性规则管理需要人工判断，不纳入自动化

👉 接下来要做的事

Section titled “👉 接下来要做的事”

提示词 5：数据源探索

Section titled “提示词 5：数据源探索”

🎯 目的

Section titled “🎯 目的”

为新建报告规则或扩展现有规则，返回 Picaro 后端可获取的数据源候选前 5 名。

📋 使用场景

Section titled “📋 使用场景”
  • 想在创建自定义报告规则前调查数据源
  • 想按特定功能名（库存 / 利润率等）查找可用端点
  • 想在扩展现有规则前确认数据范围

📝 提示词

Section titled “📝 提示词”
从 OpenAPI 探索报告生成所需的 Picaro 数据源：
- source_names：{{SOURCE_NAMES}}（逗号分隔）
- top_n：{{TOP_N}}
请给出候选。

占位符：

占位符说明默认来源
{{SOURCE_NAMES}}想探索的功能名·关键词（逗号分隔）用户输入
{{TOP_N}}候选前列件数（例：5）默认 5

⚙️ AI 要做的事

Section titled “⚙️ AI 要做的事”
  1. 检索 OpenAPI 规范 — 从 Picaro 后端 API 目录中抽取与功能名接近的端点
    • 为何看 OpenAPI：后端真实状态在 API 目录中，连未文档化的数据源也能候选化
  2. 打分 — 按路径完全匹配 / 操作 ID / 标签 / 摘要 / 描述的匹配度排序
    • 为何多段打分：“库存”这种概念会出现在路径（/inventory）和描述中，多字段加权能提升候选精度
  3. 返回前 5 名 — 同时列出匹配理由（在哪个字段匹配）
    • 为何附理由：让人可以区分同名但目的不同的多个 API
  4. 报告规则交接提示 — 候选中可纳入报告的，会附上”在 rules JSON 中的书写示例”

📊 Example Output

Section titled “📊 Example Output”

数据源探索结果 source_names：库存, 利润

#路径匹配位置得分
1/inventory/daily路径 / 摘要 / 标签0.92
2/finance/profit-margin路径 / 描述0.87
3/inventory/forecast路径 / 操作 ID0.78
4/finance/cost-breakdown描述0.64
5/inventory/restock-alerts摘要 / 标签0.58

若要纳入报告，请在报告规则的 rules JSON 中追加：

{
  "data_sources": ["inventory/daily", "finance/profit-margin"]
}

可通过 报告规则的保存与复用 反映到新规则中。

🔒 安全装置

Section titled “🔒 安全装置”
  • 仅做探索 — 不会发生数据获取或对广告账户的写入
  • 内部限定（gated）数据源 不会显示 在检索结果中（仅返回对外公开对象）
  • 得分为参考，最终选定交由人工判断（防止同名 API 混淆）
  • 探索结果 仅在该会话内保留，若想复用请保存到报告规则中

🚦 执行模式

Section titled “🚦 执行模式”
Phase状态条件
Phase 1（当前）一次性仅需 Picaro 接入即可使用
Phase 2（Q3 2026）保持一次性数据源选定需人工判断，不纳入自动化
Phase 3（Q4 2026）保持一次性同上
Phase 4（2027）保持一次性同上

👉 接下来要做的事

Section titled “👉 接下来要做的事”

提示词速查表

Section titled “提示词速查表”
想做的事使用的提示词
一条命令输出 HTML 报告提示词 1
分步确认推进生成提示词 2
仅做贡献度数据预检提示词 3
报告规则的保存·更新·删除提示词 4
数据源候选探索提示词 5

报告生成流水线

Section titled “报告生成流水线”
[报告规则保存（可选，提示词 4）]
   ↓
数据源探索（可选，提示词 5）
   ↓
预检（提示词 3 或 提示词 2 的 Step 1）
   ↓
数据采集
   ↓
幻灯片结构组装
   ↓
HTML 渲染 → Slack 配信

提示词 1（一条命令）是上面 预检 → 数据采集 → 幻灯片结构 → HTML 渲染 的一次性快捷方式。

相关类别

Section titled “相关类别”