---
title: "用 Codex 查询表格数据"
description: "说明如何让 Codex 读取 CSV、电子表格或 dashboard export，回答明确问题并生成可视化页面。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

当你手里有 CSV、电子表格、dashboard export、Google Sheet 或本地数据文件，并且只想先回答一个明确问题时，可以直接让 Codex 读取数据、检查列、完成计算，并生成一个可在浏览器打开的可视化页面。

> [!IMPORTANT]
> 数据任务先定问题和口径，再跑计算。让 Codex 先检查 columns、缺失值、时间窗口和过滤条件，避免直接给出看似精确但不可追溯的答案。

官方页面：[https://developers.openai.com/codex/use-cases/analyze-data-export](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](https://developers.openai.com/codex/skills) |
| `google-sheets` plugin | 当数据在已连接的共享表格里时，让 Codex 分析 Google Sheets | [https://developers.openai.com/codex/plugins](https://developers.openai.com/codex/plugins) |

相关官方说明：

- File inputs：[https://developers.openai.com/api/docs/guides/file-inputs](https://developers.openai.com/api/docs/guides/file-inputs)
- Agent skills：[https://developers.openai.com/codex/skills](https://developers.openai.com/codex/skills)

## 起始提示词

官方示例是一个低 reasoning effort 的轻量任务：

```text
请分析 @sales-export.csv

问题：上个季度变化最大的 customer segment 是哪一个？

请按顺序完成：
- 分析前先检查 columns
- 根据数据回答问题
- 创建一个简单的 HTML 文件，用 browser visualization 展示结果
- 启动本地预览，方便我在 Codex browser 中打开
```

这里最重要的不是图表，而是顺序：

1. 先让 Codex inspect columns。
2. 再回答问题。
3. 再生成 HTML visualization。
4. 最后启动 local preview，让你能在 Codex browser 中检查。

## 操作步骤

1. 通过 `@` 附加 CSV，或 mention 已连接的数据源。
2. 如果数据来自 dashboard，先导出原始 rows，让 Codex 能看到真实 columns。
3. 明确写出要回答的问题。
4. 要求 Codex 先检查字段，再运行计算。
5. 让它生成一个简单 HTML visualization。
6. 在 Codex browser 里打开 local preview。
7. 在同一线程里继续调整图表、分组或分析口径。

不要直接要求 Codex “全面分析这个表”。先从一个具体问题开始，跑通后再追问。

## 后续分析

第一轮答案出来后，可以继续让 Codex 做你平时会手工检查的下一步：

- 清理某一列。
- 排除测试 segment。
- 比较两个时间窗口。
- 换一种分组方式。
- 让图表更容易阅读。
- 把结果整理成会议用的短说明。

同一线程里保留了前一轮数据理解、字段判断和图表上下文，连续追问通常比重新开一个线程更稳。

## 接下来去哪

<Cards>
  <Card title="数据到报告" description="当一个问题扩展成完整分析和汇报时，进入报告场景。" href="/docs/codex/official/08-scenarios/92-data-to-report" />
  <Card title="整理脏数据" description="字段混乱、缺失值多、口径不统一时，先做数据清洗。" href="/docs/codex/official/08-scenarios/88-data-cleaning" />
  <Card title="生成幻灯片" description="分析结果要汇报时，再转成可编辑 deck。" href="/docs/codex/official/08-scenarios/97-report-slides" />
  <Card title="官方 Analyze data export" description="文件输入、skills 和 use case 细节以官方页面为准。" href="https://developers.openai.com/codex/use-cases/analyze-data-export" />
</Cards>
