---
title: "大批同类任务用 spawn_agents_on_csv"
summary: "一行一个工作项。Codex 读 CSV、按行 spawn、等全部结束、把结果写回 CSV。实验性功能。"
category: subagents
level: advanced
surfaces: [cli, ci]
tags: ["CSV", "批量", "exec"]
canonical: /tips/spawn-agents-on-csv/
---

# 大批同类任务用 spawn_agents_on_csv

一行一个工作项。Codex 读 CSV、按行 spawn、等全部结束、把结果写回 CSV。实验性功能。

适合：批量改 API、对文件清单做审查、对目录清单做迁移。

`codex exec` 会在 stderr 打一行进度。导出的 CSV 带原行数据以及 `job_id`、`item_id`、`status`、`last_error`、`result_json`。

在指令模板里强制 `report_agent_job_result`。给 `agents.job_max_runtime_seconds` 设超时，避免一个卡住的 worker 拖死整批。

这是高 token 操作。先用 3 行样本验证提示，再开全量。

## 来源

- [OpenAI · Subagents](https://developers.openai.com/codex/subagents)