官方教程中文版实战场景
用 Codex 查询表格数据
当你手里有 CSV、电子表格、dashboard export、Google Sheet 或本地数据文件，并且只想先回答一个明确问题时，可以直接让 Codex
当你手里有 CSV、电子表格、dashboard export、Google Sheet 或本地数据文件，并且只想先回答一个明确问题时，可以直接让 Codex 读取数据、检查列、完成计算，并生成一个可在浏览器打开的可视化页面。
官方页面：https://developers.openai.com/codex/use-cases/analyze-data-export
适合什么任务
这类任务的输入不是“帮我分析一下数据”，而是“基于这份数据回答一个具体问题”。
| 适合 | 不适合 |
|---|---|
| 快速计算、汇总、分组比较、趋势判断 | 还没有明确问题，只想泛泛探索 |
| 基于 CSV、spreadsheet、dashboard export、Google Sheet 或本地数据文件做分析 | 数据源无法导出、字段含义完全不清楚 |
| 需要把结果做成简单图表或 HTML 预览 | 需要正式 BI 系统、权限模型或长期数据管道 |
| 会继续在同一线程里追问下一轮比较 | 一次性把所有分析方向都塞给 Codex |
使用的能力
| 能力 | 用法 | 链接 |
|---|---|---|
$spreadsheet | 检查表格数据、做计算、生成 chart 或 table | https://developers.openai.com/codex/skills |
google-sheets plugin | 当数据在已连接的共享表格里时，让 Codex 分析 Google Sheets | https://developers.openai.com/codex/plugins |
相关官方说明：
- File inputs：https://developers.openai.com/api/docs/guides/file-inputs
- Agent skills：https://developers.openai.com/codex/skills
起始提示词
官方示例是一个低 reasoning effort 的轻量任务：
请分析 @sales-export.csv
问题：上个季度变化最大的 customer segment 是哪一个？
请按顺序完成：
- 分析前先检查 columns
- 根据数据回答问题
- 创建一个简单的 HTML 文件，用 browser visualization 展示结果
- 启动本地预览，方便我在 Codex browser 中打开这里最重要的不是图表，而是顺序：
- 先让 Codex inspect columns。
- 再回答问题。
- 再生成 HTML visualization。
- 最后启动 local preview，让你能在 Codex browser 中检查。
操作步骤
- 通过
@附加 CSV，或 mention 已连接的数据源。 - 如果数据来自 dashboard，先导出原始 rows，让 Codex 能看到真实 columns。
- 明确写出要回答的问题。
- 要求 Codex 先检查字段，再运行计算。
- 让它生成一个简单 HTML visualization。
- 在 Codex browser 里打开 local preview。
- 在同一线程里继续调整图表、分组或分析口径。
不要直接要求 Codex “全面分析这个表”。先从一个具体问题开始，跑通后再追问。
后续分析
第一轮答案出来后，可以继续让 Codex 做你平时会手工检查的下一步：
- 清理某一列。
- 排除测试 segment。
- 比较两个时间窗口。
- 换一种分组方式。
- 让图表更容易阅读。
- 把结果整理成会议用的短说明。
同一线程里保留了前一轮数据理解、字段判断和图表上下文，连续追问通常比重新开一个线程更稳。