内置 agent
子代理不直接与用户对话，结果返回主代理。具备命令执行能力的角色仍可执行写入操作，实际行为受工具权限约束。
subagent 工具
single、parallel 与 chain
您可以通过自然语言授权主代理使用这些能力：
后台任务
subagent 支持run_in_background 参数：任务转入后台后立即返回通道编号，任务结束时推送通知，包含结果摘要、用量和子会话路径。任务期间需保持 Step Code 进程运行。
agent_send 按通道编号对后台任务执行操作：
后台任务并发上限为 8，空闲 10 分钟后自动停止。已结束的任务仅保留最近 16 条记录，更早记录的子会话路径见其结束通知。
需要所有 subagent 任务在前台执行时，在
config.toml 中设置 [subagent] background = false，详见配置文件。
workflow 与 ultraloop
workflow 在无网络、无文件系统的沙箱 VM 中运行 JavaScript 编排脚本，提供phase()、parallel()、pipeline()、agent() 和 iterate() 原语。运行记录保存在项目 .stepcode/workflows/runs/，支持断点续跑，使用 /workflows 查看已保存的 workflow 与近期运行。
ultraloop 或 ultracode，或使用 /ultraloop on 开启会话级授权、/ultraloop off 关闭。单条消息的授权不自动延续，也不从任务规模推断。
STEP_DISABLE_WORKFLOW=1 禁用注册。
多代理任务示例见常见使用案例。
/ultracode [on|off|status|help] 管理多代理协作，/ultraloop 为别名；/workflows 查看工作流与运行记录。开关按会话保存，恢复同一会话会恢复状态，没有保存状态的新会话默认关闭。
自定义 agent
使用 Markdown frontmatter 定义角色，正文作为系统指令：tools 可以使用数组或逗号分隔列表。项目角色需显式纳入发现范围，调用时通过 agentScope: "both" 启用，并按提示确认。
专项工作流的定义见Agent Skills。
通过插件分发 Agent 的方式见插件与 Packages。
上下文隔离与安全
沙箱 VM 的限制仅作用于 workflow 编排脚本，子任务进程仍受操作系统权限控制。- 子代理拥有独立上下文和用量，主代理主要接收结果摘要。
- 子代理可能与主代理共享工作目录，文件修改会作用于同一工作树。
- 并行写入时应划分互不重叠的文件，或明确安排独立 Git worktree。
- Git worktree 只隔离工作树，不限制其他目录、网络或凭据访问。
- 完成后先检查差异和测试，再合并结果；未合并改动不要直接清理。