Using custom agents in your IDE

You can create specialized agents with tailored expertise for specific development tasks, and invoke them from chat in your IDE.

Tool navigation

이 기사에서

Custom agents allow you to tailor Copilot's expertise for specific tasks. For a conceptual overview of custom agents, see 사용자 지정 에이전트 정보.

참고

Custom agents은(는) JetBrains IDE, Eclipse 및 Xcode의 경우 공개 미리 보기에 있으며 변경될 수 있습니다.

Creating a custom agent profile

  1. Open GitHub Copilot Chat in Visual Studio Code.
  2. From the agents dropdown at the bottom of the chat view, click Configure Custom Agents..., then click Create new custom agent.
  3. Choose the location where the agent profile should be created:
    • Workspace: Create the custom agent profile in the .github/agents folder of your workspace to only use it within that workspace.
    • User profile: Create the custom agent profile in the current user profile folder to use it across all your workspaces.
  4. Enter a file name for the custom agent. This is the default name that appears in the agents dropdown.
  5. Configure the agent profile in the newly created .agent.md file, including the description, tools, and prompts. For more information on what the agent profile can include, see Configuring an agent profile.
    • You can use the Configure Tools... button within the editor to open the "Configure Tools" dialog, where you can view and select available tools, including built-in tools and tools from MCP servers. Click OK to add selected tools to the agent profile.
    • To set which AI model the agent uses, add a model: property and select your preferred model from the autocomplete dropdown.

To update an agent profile, select Configure Custom Agents from the agents dropdown, and then click on an agent from the list to modify it. For more information on custom agents in VS Code, see Custom agents in VS Code.

Creating a custom agent profile

  1. Open the GitHub Copilot Chat window in your JetBrains IDE.
  2. From the agents dropdown at the bottom of the chat view, click Configure Agents..., then in the settings window, under "Chat Agents", click Workspace.
  3. Enter a file name for the custom agent. This is the default name that appears in the agents dropdown.
  4. Configure the agent profile in the newly created .agent.md file in the .github/agents directory, including the description, tools, and prompts. For more information on what the agent profile can include, see Configuring an agent profile.
    • You can use the Configure Tools... button within the editor to open the tools dialog, where you can view and select available tools, including built-in tools and tools from MCP servers. Click Apply to add selected tools to the agent profile.
    • To set which AI model the agent uses, add a model: property and select your preferred model from the autocomplete dropdown.

To update an agent profile, select Configure Custom Agents from the agents dropdown, and then click next to the agent you want to modify.

Creating a custom agent profile

  1. Open the GitHub Copilot Chat window in Eclipse.
  2. From the agents dropdown at the bottom of the chat view, click Configure Agents..., then click Add....
  3. Enter a file name for the custom agent. This is the default name that appears in the agents dropdown.
  4. Configure the agent profile in the newly created .agent.md file in the .github/agents directory, including the description, tools, and prompts. For more information on what the agent profile can include, see Configuring an agent profile.
    • You can use the Configure Tools... button within the editor to open the "Configure Tools" dialog, where you can view and select available tools, including built-in tools and tools from MCP servers. Click Apply to add selected tools to the agent profile.
    • To set which AI model the agent uses, add a model: property and select your preferred model from the autocomplete dropdown.

To update an agent profile, select Configure Agents... from the agents dropdown, and then select the agent you want to modify and click Edit.

Creating a custom agent profile

  1. Open the GitHub Copilot Chat window in Xcode.
  2. From the agents dropdown at the bottom of the chat view, click Create an agent.
  3. Enter a file name for the custom agent. This is the default name that appears in the agents dropdown.
  4. Configure the agent profile in the newly created .agent.md file in the .github/agents directory, including the description, tools, and prompts. For more information on what the agent profile can include, see Configuring an agent profile.
    • You can use the Customize Agent button within the file editor to open a dialog, where you can select the AI model for the agent to use, select available tools (including built-in and MCP server tools), and configure the handoffs property for transitioning between custom agents. Click Apply to add selected options to the agent profile.

To update an agent profile, from the agents dropdown, click the pencil icon next to the agent you want to modify.

Configuring an agent profile

agent profile 은 이름, 설명, 사용 가능한 도구 및 MCP 서버 구성을 지정custom agent하는 YAML 프런트매터가 있는 Markdown 파일입니다. 구성에는 agent profile 에이전트의 ID, 기능, 도구 액세스 및 동작 지침을 정의하는 작업이 포함됩니다.

YAML 속성, 도구, MCP 서버 설정, 도구 별칭 및 처리 방법에 custom agents 대한 자세한 구성 정보는 사용자 지정 에이전트 구성을 참조하세요.

구성을 하려면 다음을 수행하세요.agent profile

  1. 필요에 따라 name에 대한 custom agent를 작성하세요. 설정되지 않은 경우 이름은 기본적으로 파일 이름(또는 .md 접미사 없음.agent.md)으로 설정됩니다.
  2. 에이전트가 수행하는 작업과 특정 기능 또는 도메인 전문 지식을 설명하는 간단한 description (필수) 작성
  3. 속성에서 tools 에이전트가 사용할 수 있는 도구를 정의합니다. 리포지토리 설정 또는 agent profile에 구성된 MCP 서버의 도구(예: tools: ["read", "edit", "search", "some-mcp-server/tool-1"])를 포함하는 도구 이름 및 별칭 목록입니다. 이 속성을 생략하면 에이전트가 사용 가능한 모든 도구에 액세스할 수 있습니다. 사용자 지정 에이전트 구성에서 "도구"를 참조하세요.
  4. 필요에 따라 속성에서 mcp-servers 이 에이전트에서만 사용할 수 있는 MCP 서버를 구성하여 기능을 확장할 수 있습니다. 사용자 지정 에이전트 구성에서 "MCP 서버 구성 세부 정보"를 참조하세요.
  5. JetBrains IDE, Eclipse 또는 Xcode에서 agent profile를 만들고 사용하는 경우, 에이전트가 사용할 AI 모델을 제어하기 위해 VS Code 속성을 사용할 수 있습니다.
  6. 필요에 따라 특정 환경에서만 에이전트를 사용하려면 target 속성을 vscode 또는 github-copilot로 설정하세요. 속성을 생략하면 두 환경에서 에이전트를 사용할 수 있습니다.
  7. 에이전트의 프롬프트를 작성합니다. YAML 프런트매터 아래의 Markdown 콘텐츠에서 에이전트의 동작, 전문 지식 및 지침을 정의합니다. 프롬프트는 최대 30,000자일 수 있습니다.

Example agent profiles

다음 예제에서는 테스트를 작성하거나 프로젝트 구현을 계획하는 일반적인 작업에 대해 agent profile가 어떻게 나타날 수 있는지를 보여줍니다. 추가 영감을 얻으려면 맞춤화 라이브러리의 Custom agents 예제를 참조하세요. awesome-copilot 커뮤니티 컬렉션에서 보다 구체적인 예제를 찾을 수 있습니다.

테스트 전문가

이 예제에서는 속성을 생략 tools 하여 모든 도구를 사용하도록 설정합니다.

Text
---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---

You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:

- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested

Always include clear test descriptions and use appropriate testing patterns for the language and framework.

구현 플래너

이 예제에서는 도구의 하위 집합만 사용하도록 설정합니다.

Text
---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---

You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:

- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow

Always structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.

Using custom agents

custom agent를 만든 후, Copilot cloud agent를 사용할 수 있는 모든 곳에서 사용할 수 있습니다.

  • Copilot cloud agent에 GitHub.com 관련 작업을 지시할 때는, 에이전트 패널이나 에이전트 탭의 드롭다운 메뉴를 사용하여 기본값인 custom agent 대신 cloud agent를 선택하십시오.
  • 문제에 Copilot cloud agent를 할당할 때, 드롭다운 메뉴에서 custom agent을 선택하면, 당신의 전문화된 설정으로 문제를 처리할 수 있습니다.
  • GitHub Copilot CLI을 사용할 때, 슬래시 명령 custom agent를 사용하거나 프롬프트에서 에이전트를 참조하거나 명령줄 인수를 통해 특정 /agent을 선택하여 사용할 수 있습니다. 자세한 내용은 GitHub Copilot CLI 사용을(를) 참조하세요.

Copilot가 풀 리퀘스트를 생성할 때, 해당 작업을 완료하는 데 어떤 custom agent가 사용되었는지를 풀 리퀘스트 설명에 명시할 것입니다.

Copilot cloud agent 사용에 대한 자세한 내용은 GitHub Copilot 세션 시작을(를) 참조하세요.

Using custom agents in your IDE

You can also use your custom agent profiles directly in supported IDEs. You can switch between custom agents using the agent dropdown in the Chat window, allowing you to access specialized configurations for different tasks like planning, code editing, or research.

Some properties may function differently between the GitHub.com and IDE environments. For more information on supported properties, see 사용자 지정 에이전트 구성.

For more information on custom agents in VS Code specifically, see Custom agents in VS Code in the VS Code documentation.

Next steps