自定义智能体(Custom Agent)是专门用于处理特定任务的Agent。你可以创建自定义智能体来扩展基础能力,每个智能体拥有独立的上下文窗口、工具权限和系统提示词。目前自定义智能体的调度方式是通过 subagent 的方式进行管理。
创建自定义智能体
方式1:使用 create-agent(推荐)
灵码提供了内置的 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