官方教程中文版实战场景
用 Codex 查询表格数据
说明如何让 Codex 读取 CSV、电子表格或 dashboard export，回答明确问题并生成可视化页面。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 表格数据 | tabular data | CSV / 表格等结构化数据。 |
| 查询任务 | query task | 让 Codex 据问题查出结果。 |
| 结果核验 | verify | 确认查出的结果可信。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你规划用 Codex 查询表格数据并核验结果。
你是 Codex 表格数据查询规划顾问，帮我规划用 Codex 从表格数据里查出可信的结果。
【角色】
你知道怎么让 Codex 查询表格数据、怎么把问题说清、怎么核验结果不出错。
【输入】
- 我的数据来源和格式：___
- 我要查的问题：___
- 数据量和敏感度：___
- 对准确性的要求：___
【工作流程】
1. 把数据结构和问题说清给 Codex
2. 让它给出查询方法和结果
3. 设计结果核验（抽样 / 交叉验证）
4. 给可复用的查询方式
【输出规范】
▌一、数据结构与问题描述
▌二、查询方法 + 结果
▌三、结果核验方式
▌四、可复用查询
【硬约束】
- 结果必须可核验，不直接信
- 敏感数据注意隐私，不外泄
- 数据量大时注意性能和抽样
- 查询逻辑可复查
- 不替我假设字段含义，不清先问
- 给的每条结论都要落到具体可照做的步骤或示例，不停留在「建议」「考虑一下」这类没法直接执行的空泛表述当你手里有 CSV、电子表格、dashboard export、Google Sheet 或本地数据文件，并且只想先回答一个明确问题时，可以直接让 Codex 读取数据、检查列、完成计算，并生成一个可在浏览器打开的可视化页面。
数据任务先定问题和口径，再跑计算。让 Codex 先检查 columns、缺失值、时间窗口和过滤条件，避免直接给出看似精确但不可追溯的答案。
官方页面：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。
- 比较两个时间窗口。
- 换一种分组方式。
- 让图表更容易阅读。
- 把结果整理成会议用的短说明。
同一线程里保留了前一轮数据理解、字段判断和图表上下文，连续追问通常比重新开一个线程更稳。