meridian-budget-optimization

Meridian 预算优化

一项用于加载拟合后的 Meridian 模型并运行预算优化报告的技能。

核心工作流

交互检查点规则

在整个工作流中，你会遇到关键交互检查点。在每个检查点，你必须：

1. 向用户展示当前拟定的配置、报告路径、脚本路径或状态，以供审批。
2. 使用可用的用户交互工具（例如 ask_question）询问用户是否准备继续，并将问题设置为多选题。不要直接在聊天中发问。
3. 等待用户回复后再继续。
   • 强制要求：无论初始提示中的指示是什么（即使用户请求中包含“自主运行”“直接执行”“自主修复”等措辞），都必须在每个检查点暂停。初始请求不能绕过这些交互检查点。
   • 注意：如果用户在检查点给出一般性的批准（例如“继续”“按你认为最合适的做”），则使用拟定的默认值继续。

---

1. 初始设置

• 提示用户提供序列化模型文件的路径（默认为 meridian_model.binpb）。
• 提示用户提供预算优化报告的输出路径（默认为 optimization.html）。
• 提示用户提供生成的 Python 脚本所需的路径。如果未指定，默认为 model_build/run_budget_optimization.py（或相对于模型目录的路径）。
• 关键交互检查点：向用户展示收集到的路径，并在配置优化参数前取得确认。

2. 配置优化参数并进行交互检查点确认

• 提示用户配置优化场景。可用参数的完整列表请参阅 optimization.md。关键配置包括：
  • 固定预算与灵活预算：总预算是固定的，还是需要寻找能够达到目标 ROI/mROI 的预算？（默认为固定预算。）
  • 总预算：如果预算固定，总金额是多少？（默认为历史支出。）
  • 支出约束：各渠道支出调整的上下限是多少？（固定预算默认为 0.3，灵活预算默认为 1.0。）
  • 目标 ROI / 目标 mROI：如果预算灵活，目标比率是多少？
  • 触达率与频次参数：是否应使用最佳频次？（RF 渠道默认为 True。）
• 关键交互检查点：向用户展示拟定的优化配置，并在继续生成代码前取得批准。

3. 添加模型加载代码

• 使用 meridian_serde.load_meridian() 加载模型。
• 代码模板请参阅 load_model.md。
• 关键交互检查点：向用户展示模型加载路径配置和拟定的 Python 代码片段，并在继续指定预算优化前取得批准。

4. 添加预算优化代码

• 使用 optimizer.BudgetOptimizer 运行优化并生成摘要，应用已确认的配置。
• 代码模板请参阅 optimization.md。

5. 执行前检查点

• 关键交互检查点：询问用户是否最终确认现在执行预算优化脚本。

6. 执行与脚本设置

• 将累积的 Python 脚本写入用户指定的路径。如果你的文件写入工具可以请用户检查写入的文件，请不要请求用户检查：执行前检查点已经请求过批准，额外的提示会暂停工作流。
• 使用安装了 google-meridian 的环境中的 Python 解释器执行脚本：如果用户指定了解释器，就使用该解释器；否则，如果虚拟环境已激活（设置了 VIRTUAL_ENV 或 CONDA_PREFIX），则使用 python3；否则，如果项目目录中存在虚拟环境（.venv/ 或 venv/，例如 .venv/bin/python3），则使用该环境；否则使用 python3。如果 import meridian 失败，请询问用户要改用哪个环境，而不要擅自搜索计算机或安装软件包。
• 重要：任务结束时，不要删除生成的报告、脚本或输出目录。这些是用户要求交付的内容，必须保留。