官方教程中文版實戰場景
用 Codex 查詢表格資料
說明如何讓 Codex 讀取 CSV、電子表格或 dashboard export，回答明確問題並生成視覺化頁面。
當你手裡有 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。
- 比較兩個時間視窗。
- 換一種分組方式。
- 讓圖表更容易閱讀。
- 把結果整理成會議用的短說明。
同一執行緒裡保留了前一輪資料理解、欄位判斷和圖表上下文，連續追問通常比重新開一個執行緒更穩。