---
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="/zh-Hant/docs/codex/official/08-scenarios/92-data-to-report" />
  <Card title="整理髒資料" description="欄位混亂、缺失值多、口徑不統一時，先做資料清洗。" href="/zh-Hant/docs/codex/official/08-scenarios/88-data-cleaning" />
  <Card title="生成幻燈片" description="分析結果要彙報時，再轉成可編輯 deck。" href="/zh-Hant/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>
