Custom Agent

Custom Agent is an AI Agent in Qoder designed to handle specific tasks. You can create custom agents to extend Qoder’s capabilities, with each agent having its own independent context window, tool permissions, and system prompt. Currently, the scheduling method for custom agents is through the subagent approach.

Create a Custom Agent

Method 1: Using create-agent (Recommended)

Qoder provides a built-in create-agent skill that helps you quickly create custom agents through interactive guidance. Usage:

/create-agent <Your requirement, e.g., code review expert>

create-agent will guide you through the following steps:

Define the agent’s name and description
Select required tool permissions
Automatically generate system prompt template
Save the agent file to the correct location

If this is your first time creating a custom agent, we recommend using /create-agent to automatically generate the configuration file, ensuring correct formatting and all necessary fields.

Method 2: Manual Creation

You can also manually create a .md file in one of the following locations:

Scope	Path	Availability
User-level	`~/.qoder/agents/<agentName>.md`	All projects
Project-level	`${project}/.qoder/agents/<agentName>.md`	Current project only

The file should contain a frontmatter block defining basic information, followed by the system prompt content:

---
name: code-review
description: Code review expert, checks code quality and security
tools: Read, Grep, Glob, Bash
model: "[ModelName](modelId)"
skills: 
 - {skillName1}
 - {skillName2}
mcpServers:
 - {mcpServerName1}
 - {mcpServerName2}
---

You are a senior code reviewer responsible for ensuring code quality.

Review checklist:
1. Code readability
2. Naming conventions
3. Error handling
4. Security checks
5. Test coverage

Field	Required	Description
`name`	Yes	Unique identifier for the Custom Agent
`description`	Yes	Brief description of functionality and expertise, used for automatic selection
`model`	No	Specify the model to use. If not set, follows the model selection in the conversation
`tools`	No	List of allowed tools, comma-separated
`skills`	No	List of allowed skills
`mcpServers`	No	List of allowed MCP servers

MCP servers

Custom agents support configuring MCP (Model Context Protocol) servers, enabling agents to invoke external tools and services. Add the mcpServers field in the agent configuration to associate MCP servers, extending the agent’s capabilities.

Model configuration

Custom agents support specifying which model to use. In the Quest view, go to Setting → Agents, select the target agent and click Change Model to assign the most suitable model for each agent’s role.

Tools List

Tool Name	Description
`Bash`	Execute shell commands in your environment
`Edit`	Make targeted edits to specific files
`Write`	Create or overwrite files
`Glob`	Find files based on pattern matching
`Grep`	Search for patterns in file content
`Read`	Read the contents of files
`WebFetch`	Fetch content from a specified URL
`WebSearch`	Perform web searches with domain filtering

Using in IDE

There are two ways to invoke custom agents:

Method 1: Automatic Trigger

In the Chat panel, describe the task in natural language, and the model will automatically recognize the intent and select the appropriate custom agent based on description:

Help me review the implementation of this interface

The model will automatically identify and invoke the code-review agent.

Method 2: Manual Trigger

Use /agent-name to manually trigger a specific agent:

/code-review

Detailed Documentation

For a complete guide on Custom Agents, including automatic creation and CLI usage, see CLI Usage Documentation.

Get Started

User Guide

Context

Extensions

Configuration

Account

Support

Events

Custom Agent

Create a Custom Agent

Method 1: Using create-agent (Recommended)

Method 2: Manual Creation

MCP servers

Model configuration

Tools List

Using in IDE

Method 1: Automatic Trigger

Method 2: Manual Trigger

Detailed Documentation

​Create a Custom Agent

​Method 1: Using create-agent (Recommended)

​Method 2: Manual Creation

​MCP servers

​Model configuration

​Tools List

​Using in IDE

​Method 1: Automatic Trigger

​Method 2: Manual Trigger

​Detailed Documentation

Create a Custom Agent

Method 1: Using create-agent (Recommended)

Method 2: Manual Creation

MCP servers

Model configuration

Tools List

Using in IDE

Method 1: Automatic Trigger

Method 2: Manual Trigger

Detailed Documentation