必须先初始化项目并配置模型才能启用agent space:执行/opencode进入tui,/init生成索引和agents.md,/connect选择提供商,/models确认模型可用;之后用tab切换主智能体,新增需在.opencode/agents/下创建含mode: primary的md文件;调用subagent可输入预设指令(如/review)或自然语言描述任务;通过/compact压缩上下文、/share分享会话链接、导出.codencode/agents/下配置文件实现协作复用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在终端中使用 OpenCode 的 Agent Space 功能完成多智能体协同任务,必须先确保项目已初始化并配置好可用模型,否则 Agent 无法加载上下文或调用子智能体。
启动 Agent Space 前的必要准备
进入你的项目根目录,运行 opencode 启动终端界面。
在 OpenCode TUI 中输入 /init,等待索引完成——这会生成 .opencode/ 目录和 AGENTS.md,【没有这一步,Agent Space 将无法感知项目结构】。
执行 /connect 并选择一个已认证的提供商(如 OpenCode Zen),再运行 /models 确认当前模型可被调用。
启用 Agent Space 并切换主智能体
按 Tab 键可在已加载的 Primary 智能体间切换,首次启动时默认只有 build 和 plan 两个内置主智能体。
若需新增主智能体,需在项目根目录的 .opencode/agents/ 下新建 reviewer.md 文件,内容包含 mode: Primary 和明确的功能描述,保存后重启 OpenCode 即可识别。
切换到目标主智能体后,界面上方状态栏会显示当前 Agent 名称,此时所有自然语言指令都由该 Agent 解析执行。
智能订单处理助手,帮助用户快速创建WMS发货单。 当用户请求以下操作时使用: 1. 采购/下单/创建发货单(如"帮我采购一本书"、"帮我下单") 2. 批量处理订单(如"帮我完成这个表格中所有订单的发货") 3. 从Excel/CSV文件导入订单 支持从标准格式的Excel表格中提取:商品名称、数量、ISBN、收...
调用 SubAgent 执行后台任务
方法一:直接触发预设子智能体
在任意主智能体下输入 /review src/main.py,系统将自动调度 codereview SubAgent 进行静态分析,无需手动切换。
方法二:通过自然语言指令唤起
输入“请检查 test/ 目录下所有单元测试是否覆盖了 error handling 分支”,OpenCode 会自主决定调用 test-analyzer SubAgent 并返回带行号标注的缺失点清单。
注意:SubAgent 默认不修改文件,只读分析结果会以折叠块形式呈现,点击展开才能查看详细建议。
管理 Agent Space 中的会话与上下文
第一步:压缩冗长对话上下文
输入 /compact,系统将把前 20 轮问答提炼为三句话摘要,释放约 65% 的 token 空间,避免因上下文溢出导致 SubAgent 拒绝响应。
第二步:保存当前 Agent Space 状态
执行 /share,获得唯一会话链接;该链接包含当前主智能体、激活的 SubAgent 列表及压缩后的上下文快照,他人点击即可复现完全一致的协作环境。
第三步:导出 Agent 配置供团队复用
复制项目根目录下的 .opencode/agents/codereview.md 文件,将其提交至 Git 仓库,其他成员 git pull 后无需重配即可使用同版本审查逻辑。










