自定义智能体(Custom Agent)是专门用于处理特定任务的Agent。你可以创建自定义智能体来扩展基础能力,每个智能体拥有独立的上下文窗口、工具权限和系统提示词。目前自定义智能体的调度方式是通过 subagent 的方式进行管理。
创建自定义智能体
方式1:使用 create-agent(推荐)
Qoder CN提供了内置的 create-agent 技能,可以通过交互式引导帮助你快速创建符合规范的自定义智能体。使用方式:
/create-agent <您的诉求,例如代码审查专家>
create-agent 会引导你完成以下步骤:
-
定义智能体的名称和描述
-
选择需要的工具权限
-
自动生成系统提示词模板
-
将智能体文件保存到正确的位置
如果你是第一次创建自定义智能体,建议使用 /create-agent 来自动生成配置文件,这样可以确保格式正确并包含所有必要的字段。
方式2:手动创建
你也可以手动在以下位置创建一个 .md 文件:
|
位置 |
路径 |
作用域 |
|
用户级 |
|
所有项目 |
|
项目级 |
|
仅当前项目 |
文件需要包含 frontmatter 区块定义基本信息,以及系统提示词内容:
---
name: code-review
description: 代码审查专家,检查代码质量和安全性
tools: Read, Grep, Glob, Bash
---
你是一位资深代码审查员,负责确保代码质量。审查清单:
1. 代码可读性
2. 命名规范
3. 错误处理
4. 安全性检查
5. 测试覆盖
|
字段 |
必填 |
说明 |
|
|
是 |
自定义智能体的唯一标识名称 |
|
|
是 |
简短描述功能和专长,用于模型自动选择 |
|
|
否 |
允许使用的工具列表,用逗号分隔 |
支持的工具列表
|
工具名称 |
说明 |
|
|
在您的环境中执行 shell 命令 |
|
|
对特定文件进行有针对性的编辑 |
|
|
创建或覆盖文件 |
|
|
检索文件 |
|
|
检索文件内容 |
|
|
读取文件的内容 |
|
|
从指定的 URL 获取内容 |
|
|
执行带有域过滤的 Web 搜索 |
在 IDE 中使用
方式1:自动触发
用自然语言描述任务,模型会根据 description 自动识别意图并选择合适的自定义智能体:
帮我审查这个接口的实现
模型将自动识别并调用 code-review 智能体。
方式2:手动触发
输入 /agent-name 手动触发指定的智能体:
/code-review