OpenCode 中文社区

Appearance

3.2 认识 Agent：你的专属团队 ​

💡 一句话总结：Agent 就像不同工种的专家，用 Tab 切换主 Agent，用 @agent名 调用子 Agent。

学完你能做什么 ​

  • 理解什么是 Agent（主代理 vs 子代理）
  • 知道内置 Agent 各自擅长什么
  • 能调用不同 Agent 完成任务
  • 能在父子会话之间导航

核心思路 ​

什么是 Agent ​

Agent 就像你的 AI 团队成员，每个人有不同的专长：

  • Build Agent：全能开发者，能读写文件、执行命令
  • Plan Agent：规划分析师，主要用于分析代码和提供建议
  • Explore Agent：代码探索者，快速理解代码库结构
  • General Agent：通用助手，擅长复杂研究和多步骤任务

两种类型 ​

类型说明调用方式
Primary Agent（主代理）你直接对话的 Agent（Build、Plan）Tab 切换
Subagent（子代理）被主代理自动调用或你手动调用的专家@agent名

内置 Agent 速览 ​

Agent类型擅长默认权限
BuildPrimary全能开发（默认主 Agent）全能（可读写文件、执行命令）
PlanPrimary分析代码、规划方案、审查建议受限（文件修改和命令执行会提示批准）
ExploreSubagent快速找到文件、搜索代码、回答代码库问题只读（可搜索、浏览代码）
GeneralSubagent复杂研究、多步骤任务多任务执行（可用 Todo 工具）

跟我做 ​

第 1 步：查看当前 Agent ​

看状态栏，会显示当前 Agent 名称（如 Build 或 Plan）。

第 2 步：用 Tab 切换主 Agent ​

按 Tab 键在 Build Agent 和 Plan Agent 之间切换。

第 3 步：调用 Explore Agent ​

输入：

@explore 帮我梳理这个项目的整体结构

你应该看到：Explore Agent 开始工作，分析项目结构。

💡 子代理会话：调用子代理后，会创建一个子会话。你可以用 <leader>→ 进入子会话，用 <leader>← 返回父会话。

第 4 步：调用 General Agent ​

输入：

@general 帮我研究 Node.js 和 Python 的性能对比，并输出总结报告

你应该看到：General Agent 并行执行多个研究任务，整合结果。

第 5 步：让主 Agent 自动调用子 Agent ​

输入一个复杂任务：

帮我分析这个项目的代码结构，然后添加一个 README.md

你应该看到：Build Agent 可能会自动调用 Explore Agent 分析项目结构，然后自己创建 README。

第 6 步：查看 Agent 列表 ​

按 <leader>a 列出所有 Agent（默认 leader 是 Ctrl+X，即 Ctrl+X+a）。

第 7 步：在父子会话间导航 ​

  • 按 <leader>→ 进入下一个会话（父 → 子1 → 子2 → ... → 父）
  • 按 <leader>← 返回上一个会话（父 ← 子1 ← 子2 ← ... ← 父）
  • 按 <leader>↑ 直接跳转到父会话

会话层级示例：

主会话 (Build)
  └── 子会话 (Explore)
        └── 孙会话 (General)

检查点 ​

✅ 全部通过才能继续：

  • [ ] 知道当前是哪个 Agent（看状态栏）
  • [ ] 能用 Tab 在 Build 和 Plan 之间切换
  • [ ] 能用 @explore 和 @general 调用子 Agent
  • [ ] 能用快捷键在父子会话间切换

踩坑提醒 ​

现象原因解决
@agent名 没反应Agent 名称拼错了检查拼写
子会话看不到没有展开或导航到错误的层级用 <leader>→ / <leader>← 导航

下一课预告 ​

下一课我们将学习 3.3 项目初始化，用 /init 让 AI 更懂你的项目。

微信群