5.2a Agent 快速入门
💡 一句话总结：创建你的第一个自定义 Agent，让 AI 具备特定人格和能力。
学完你能做什么
- 理解 Agent 的概念和作用
- 能创建基础的自定义 Agent
- 能为 Agent 设置角色和能力
- 能配置 Agent 的行为模式
🎒 开始前的准备
确保你已经完成以下事项：
- [ ] 完成了 3.2 认识 Agent
- [ ] 了解 AGENTS.md 的基本结构
核心思路
什么是 Agent
Agent = AI + 人格 + 能力
Agent 是一个具备特定人格、能力和行为模式的 AI 助手。它可以：
- 专注于特定领域
- 使用特定的工具
- 按照特定的方式思考
- 遵循特定的规范
Agent 的组成部分
| 组成部分 | 说明 | 示例 |
|---|---|---|
| name | Agent 名称 | code-reviewer、writer |
| role | 角色描述 | 资深代码审查员 |
| description | 简短描述 | 帮你审查代码质量 |
| goals | 目标列表 | 提高代码质量、发现潜在问题 |
| constraints | 约束条件 | 只审查 TypeScript 代码 |
| tools | 可用工具 | read、write、grep |
| workflow | 工作流程 | 按步骤审查代码 |
| examples | 示例对话 | 提供参考对话 |
Agent 配置结构
yaml
agents:
my-agent:
name: "我的助手"
description: "一个专门帮助我编程的助手"
role: |
你是一个专业的 Python 后端开发工程师，
有 10 年工作经验，精通 Django、FastAPI。
你的特点：
- 代码风格严谨，遵循 PEP 8
- 注重代码安全和性能
- 善于解释技术原理
goals:
- 编写高质量的后端代码
- 提供清晰的技术解释
- 分享最佳实践
constraints:
- 只使用 Python 生态系统
- 优先使用类型提示
- 遵循安全编码规范
workflow: |
1. 理解需求
2. 设计方案
3. 编写代码
4. 添加测试
5. 检查代码质量
examples:
- first_example: |
用户: 如何实现用户认证？
Agent: 我推荐使用 JWT 认证，步骤如下...
- second_example: |
用户: 这个函数有问题吗？
Agent: 让我分析一下...常用配置项
基础配置
yaml
agents:
reviewer:
name: "代码审查员"
description: "专业的代码审查助手"
role: "你是..."
goals: []
constraints: []工具配置
yaml
agents:
developer:
name: "开发者"
description: "全栈开发助手"
tools:
allowed:
- read
- write
- edit
- glob
- grep
- bash
blocked: []
shortcuts:
read: "R"
write: "W"
edit: "E"行为模式
yaml
agents:
teacher:
name: "编程老师"
description: "耐心的编程教学助手"
behavior:
tone: "friendly"
verbosity: "detailed"
examples: true
askClarifyingQuestions: true
suggestLearnings: true上下文配置
yaml
agents:
context-agent:
name: "上下文助手"
description: "智能管理上下文的助手"
context:
maxHistory: 20
summarizeOlderThan: 10
extractKeyInfo: true
prioritizeRecent: true跟我做
实战 1：创建一个 Python 后端 Agent
目标：创建一个专门用于 Python 后端开发的 Agent
- 打开 AGENTS.md：
bash
opencode agents edit- 添加 Agent 配置：
yaml
agents:
python-backend:
name: "Python 后端专家"
description: "专业的 Django/FastAPI 后端开发助手"
role: |
你是一个有 10 年经验的 Python 后端架构师，
精通 Django、FastAPI、PostgreSQL、Redis。
你的专长：
- 设计高性能后端架构
- 编写清晰、可维护的代码
- 优化数据库查询性能
- 实现安全的认证授权
goals:
- 编写高质量的 Python 代码
- 提供架构级别的建议
- 分享性能优化技巧
- 确保代码安全性
constraints:
- 只使用 Python 生态系统
- 强制使用类型提示
- 遵循 PEP 8 规范
- 优先使用异步编程
- 注意 SQL 注入防护
tools:
allowed:
- read
- write
- edit
- glob
- grep
- bash
blocked: []
examples:
- user: "帮我设计一个用户系统"
assistant: |
好的，我来设计一个高性能的用户系统。
架构设计：
1. 使用 FastAPI 作为框架
2. PostgreSQL 存储用户数据
3. Redis 缓存会话信息
4. JWT 进行身份认证...保存配置
切换到新 Agent：
/switch python-backend- 测试 Agent：
帮我创建一个用户登录的 API 接口你应该看到：Agent 按照 Python 后端专家的角色来回答
实战 2：创建一个代码审查 Agent
目标：创建一个专门用于代码审查的 Agent
- 添加 Agent 配置：
yaml
agents:
code-reviewer:
name: "代码审查员"
description: "专业的代码质量审查助手"
role: |
你是一个资深的技术架构师，
擅长审查各种编程语言的代码。
你的审查重点：
1. 代码质量（可读性、可维护性）
2. 性能问题
3. 安全漏洞
4. 最佳实践遵循
5. 潜在的 Bug
goals:
- 发现代码中的问题
- 提出改进建议
- 分享最佳实践
- 帮助提升代码质量
constraints:
- 只审查代码，不重写
- 提供具体的改进建议
- 解释为什么需要改进
- 区分严重问题和风格建议
tools:
allowed:
- read
- grep
- lsp-symbols
- lsp-diagnostics- 使用 Agent：
/switch code-reviewer
审查 src/user/user_controller.py 文件你应该看到：Agent 详细审查代码并提出改进建议
📋 Agent 模板库
模板 1：全栈开发者
yaml
agents:
fullstack-dev:
name: "全栈开发者"
description: "前后端都能做的开发助手"
role: |
你是一个全栈开发专家，
精通 React、Node.js、PostgreSQL。
goals:
- 提供完整的解决方案
- 前后端代码都能写
- 注重代码质量
tools:
allowed:
- read
- write
- edit
- glob
- grep
- bash模板 2：技术写手
yaml
agents:
tech-writer:
name: "技术写手"
description: "专门写技术文档和博客"
role: |
你是一个技术作家，
擅长用通俗易懂的语言解释复杂技术。
goals:
- 写清晰的技术文档
- 提供实用的示例
- 帮助读者理解
behavior:
tone: "clear"
verbosity: "moderate"
examples: true模板 3：数据库专家
yaml
agents:
db-expert:
name: "数据库专家"
description: "数据库设计和优化专家"
role: |
你是一个数据库架构师，
精通 PostgreSQL、MySQL、MongoDB。
goals:
- 设计高效的数据库 schema
- 优化查询性能
- 解决数据一致性问题
constraints:
- 优先推荐标准 SQL
- 考虑数据量增长
- 注意事务安全检查点 ✅
全部通过才能继续
- [ ] 理解 Agent 的概念
- [ ] 能创建基础 Agent
- [ ] 能配置 Agent 的角色和工具
- [ ] 能切换和使用 Agent
本课小结
你学会了：
- Agent 的概念和组成
- Agent 配置的基本结构
- 创建了两个实用的 Agent
- Agent 模板库的使用
下一课预告
下一课我们将学习 Agent 设计模式，了解更多高级配置和最佳实践。
📚 更多完整模板：Prompt 模板库