37 自定义Agent开发引言虽然Codex内置的default、worker和explorer Agent已经覆盖了大部分日常开发场景，但真实项目的需求往往更加复杂和特定。你可能需要一个专门审查Java代码安全性的Agent、一个专注于SQL性能优化的Agent、或者一个熟悉你团队特有编码规范的Agent。自定义Agent机制正是为此而生——通过简单的TOML配置文件，你可以创建任意数量的专用Agent，每个Agent拥有独立的系统指令、模型配置、沙箱模式甚至MCP服务器绑定。一、TOML配置文件基础1.1 什么是TOMLTOML（Tom’s Obvious Minimal Language）是一种配置文件格式，设计目标是"对人类友好、对机器明确"。相比于JSON和YAML，TOML的语法更直观，错误更不容易发生。一个自定义Agent的配置文件存储在.toml文件中，Codex会在加载时解析这些文件并创建对应的Agent。1.2 必填三件套每一个自定义Agent配置文件必须包含三个核心字段：[name] description = "一句话说明这个Agent是做什么的" developer_instructions = """ 详细的系统提示词，定义Agent的行为、知识和约束 多行字符串用三个双引号包裹 """name（Agent名称）Agent的名称，用于在/agent命令中引用：name = "java-security-reviewer"命名规则：使用小写字母、数字和短横线（-）简短且有意义不能与内置Agent名称冲突（default、worker、explorer）description（简短描述）一行描述，在/agent列表视图中显示：description = "Java代码安全审查专家，专注OWASP漏洞检测"developer_instructions（系统提示词）这是自定义Agent的"灵魂"——一段详细的中文或英文指令，定义了Agent的角色、行为约束、工作风格和专业知识。这部分内容直接关系到Agent的实际表现，因此需要精心设计：
