自定义智能体
Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
自定义智能体
自定义智能体（Custom Agent）是 Qoder 中专门用于处理特定任务的 AI Agent。你可以创建自定义智能体来扩展 Qoder 的能力，每个智能体拥有独立的上下文窗口、工具权限和系统提示词。目前自定义智能体的调度方式是通过 subagent 的方式进行管理。
创建自定义智能体
方式1：使用 create-agent（推荐）
Qoder 提供了内置的 create-agent 技能，可以通过交互式引导帮助你快速创建符合规范的自定义智能体。
使用方式：
“`bash theme={null}
/create-agent <您的诉求，例如代码审查专家>
`create-agent` 会引导你完成以下步骤：
* 定义智能体的名称和描述
* 选择需要的工具权限
* 自动生成系统提示词模板
* 将智能体文件保存到正确的位置
<Tip>
如果你是第一次创建自定义智能体，建议使用 `/create-agent` 来自动生成配置文件，这样可以确保格式正确并包含所有必要的字段。
</Tip>
### 方式2：手动创建
你也可以手动在以下位置创建一个 `.md` 文件：
| 位置 | 路径 | 作用域 |
| --- | ----------------------------------------- | ----- |
| 用户级 | `~/.qoder/agents/<agentName>.md` | 所有项目 |
| 项目级 | `${project}/.qoder/agents/<agentName>.md` | 仅当前项目 |
文件需要包含 frontmatter 区块定义基本信息，以及系统提示词内容：
```markdown theme={null}
---
name: code-review
description: 代码审查专家，检查代码质量和安全性
tools: Read, Grep, Glob, Bash
---
你是一位资深代码审查员，负责确保代码质量。
审查清单：
1. 代码可读性
2. 命名规范
3. 错误处理
4. 安全性检查
5. 测试覆盖
| 字段 | 必填 | 说明 |
|---|---|---|
name |
是 | 自定义智能体的唯一标识名称 |
description |
是 | 简短描述功能和专长，用于模型自动选择 |
tools |
否 | 允许使用的工具列表，用逗号分隔 |
支持的工具列表
| 工具名称 | 说明 |
|---|---|
Bash |
在您的环境中执行 shell 命令 |
Edit |
对特定文件进行有针对性的编辑 |
Write |
创建或覆盖文件 |
Glob |
检索文件 |
Grep |
检索文件内容 |
Read |
读取文件的内容 |
WebFetch |
从指定的 URL 获取内容 |
WebSearch |
执行带有域过滤的 Web 搜索 |
在 IDE 中使用
有以下两种触发方式：
方式1：自动触发
在 Chat 面板中，用自然语言描述任务，模型会根据 description 自动识别意图并选择合适的自定义智能体：
帮我审查这个接口的实现
模型将自动识别并调用 code-review 智能体。
方式2：手动触发
输入 /agent-name 手动触发指定的智能体：
/code-review
详细文档
关于自定义智能体的完整指南，包括自动创建、CLI 中的使用方式等，请参阅 CLI 使用文档。
Allen
暂无介绍....
