VS Code의 사용자 지정 에이전트

사용자 지정 에이전트를 사용하면 AI를 특정 개발 역할 및 작업에 맞게 조정된 다양한 페르소나를 채택하도록 구성할 수 있습니다. 예를 들어 보안 검토자, 플래너, 솔루션 아키텍트 또는 기타 전문화된 역할에 대한 에이전트를 만들 수 있습니다. 각 페르소나는 자체 동작, 사용 가능한 도구 및 지침을 가질 수 있습니다.

핸드오프를 사용하여 에이전트 간에 안내된 워크플로를 만들 수도 있으므로 한 번의 클릭으로 한 전문 에이전트에서 다른 에이전트로 원활하게 전환할 수 있습니다. 예를 들어 플래닝 에이전트에서 구현 에이전트로 직접 이동하거나 관련 컨텍스트를 사용하여 코드 검토자에게 전달할 수 있습니다.

이 문서에서는 VS Code에서 사용자 지정 에이전트를 만들고 관리하는 방법을 설명합니다.

사용자 지정 에이전트란 무엇인가요?

기본 제공 에이전트는 VS Code에서 채팅에 대한 범용 구성을 제공합니다. 보다 맞춤화된 채팅 환경을 위해 자체 사용자 지정 에이전트를 만들 수 있습니다.

사용자 지정 에이전트는 해당 에이전트로 전환할 때 적용되는 지침 및 도구 집합으로 구성됩니다. 예를 들어 "계획" 에이전트에는 구현 계획 생성을 위한 지침이 포함될 수 있으며 읽기 전용 도구만 사용할 수 있습니다. 사용자 지정 에이전트를 만들면 매번 관련 도구와 지침을 수동으로 선택할 필요 없이 해당 특정 구성으로 빠르게 전환할 수 있습니다.

사용자 지정 에이전트는 .agent.md Markdown 파일로 정의되며, 작업 공간에 저장하여 다른 사람이 사용하거나 사용자 프로필에 저장하여 다른 작업 공간에서 재사용할 수 있습니다.

사용자 지정 에이전트를 백그라운드 에이전트 및 클라우드 에이전트에서 재사용하여 동일한 전문 구성을 사용하여 자동화된 작업을 실행할 수 있습니다.

사용자 지정 에이전트를 사용하는 이유는 무엇인가요?

다른 작업에는 다른 기능이 필요합니다. 플래닝 에이전트는 실수로 코드를 변경하지 않도록 연구 및 분석을 위한 읽기 전용 도구만 필요할 수 있지만, 구현 에이전트에는 전체 편집 기능이 필요합니다. 사용자 지정 에이전트를 사용하면 각 작업에 사용할 수 있는 도구를 정확하게 지정하여 AI가 해당 작업에 필요한 적절한 기능을 갖도록 할 수 있습니다.

사용자 지정 에이전트를 사용하면 AI가 작동해야 하는 방식을 정의하는 전문 지침을 제공할 수도 있습니다. 예를 들어, 플래닝 에이전트는 AI에게 프로젝트 컨텍스트를 수집하고 자세한 구현 계획을 생성하도록 지시할 수 있으며, 코드 검토 에이전트는 보안 취약성을 식별하고 개선 사항을 제안하는 데 중점을 둘 수 있습니다. 이러한 전문 지침은 해당 에이전트로 전환할 때마다 일관되고 작업에 적합한 응답을 보장합니다.

핸드오프

핸드오프를 사용하면 제안된 다음 단계로 에이전트 간에 전환되는 안내된 순차 워크플로를 만들 수 있습니다. 채팅 응답이 완료되면 핸드오프 버튼이 나타나 사용자가 관련 컨텍스트와 미리 채워진 프롬프트로 다음 에이전트로 이동할 수 있습니다.

핸드오프는 다단계 워크플로를 조정하는 데 유용하며, 개발자가 다음 단계로 이동하기 전에 각 단계를 검토하고 승인할 수 있는 제어를 제공합니다. 예를 들어

• 계획 → 구현: 계획 에이전트에서 계획을 생성한 다음 구현 에이전트로 전달하여 코딩을 시작합니다.
• 구현 → 검토: 구현을 완료한 다음 코드 검토 에이전트로 전환하여 품질 및 보안 문제를 확인합니다.
• 실패하는 테스트 작성 → 통과하는 테스트 작성: 큰 구현보다 검토하기 쉬운 실패하는 테스트를 생성한 다음, 필요한 코드 변경을 구현하여 해당 테스트를 통과하도록 전달합니다.

에이전트 파일에 핸드오프를 정의하려면 프론트매터에 추가하세요. 각 핸드오프는 대상 에이전트, 버튼 레이블 및 선택적 보낼 프롬프트를 지정합니다.

---
description: Generate an implementation plan
tools: ['search', 'fetch']
handoffs:
  - label: Start Implementation
    agent: implementation
    prompt: Now implement the plan outlined above.
    send: false
---

사용자가 핸드오프 버튼을 보고 선택하면 미리 채워진 프롬프트로 대상 에이전트로 전환됩니다. send: true인 경우 프롬프트가 자동으로 제출되어 다음 워크플로 단계를 시작합니다.

사용자 지정 에이전트 파일 구조

사용자 지정 에이전트 파일은 Markdown 파일이며 .agent.md 확장자를 사용하고 다음 구조를 가집니다.

머리글 (선택 사항)

머리글은 다음과 같은 필드를 가진 YAML 프런트매터 형식으로 지정됩니다.

본문

사용자 지정 에이전트 파일 본문에는 Markdown 형식의 사용자 지정 에이전트 구현이 포함됩니다. 여기에는 AI가 이 사용자 지정 에이전트에 있을 때 따르도록 하려는 특정 프롬프트, 지침 또는 기타 관련 정보가 포함됩니다.

예를 들어, Markdown 링크를 사용하여 다른 파일을 참조하여 지침 파일을 재사용할 수 있습니다.

본문 텍스트에서 에이전트 도구를 참조하려면 #tool:<tool-name> 구문을 사용합니다. 예를 들어 githubRepo 도구를 참조하려면 #tool:githubRepo를 사용합니다.

채팅 보기에서 사용자 지정 에이전트를 선택하면 사용자 지정 에이전트 파일 본문의 지침이 사용자 채팅 프롬프트 앞에 추가됩니다.

사용자 지정 에이전트 예제

다음 코드 조각은 구현 계획을 생성하고 코드 편집을 수행하지 않는 "계획" 사용자 지정 에이전트 파일의 예제를 보여줍니다. 커뮤니티에서 제공한 더 많은 예제는 Awesome Copilot 리포지토리를 참조하세요.

---
description: Generate an implementation plan for new features or refactoring existing code.
name: Planner
tools: ['fetch', 'githubRepo', 'search', 'usages']
model: Claude Sonnet 4
handoffs:
  - label: Implement Plan
    agent: agent
    prompt: Implement the plan outlined above.
    send: false
---
# Planning instructions
You are in planning mode. Your task is to generate an implementation plan for a new feature or for refactoring existing code.
Don't make any code edits, just generate a plan.

The plan consists of a Markdown document that describes the implementation plan, including the following sections:

* Overview: A brief description of the feature or refactoring task.
* Requirements: A list of requirements for the feature or refactoring task.
* Implementation Steps: A detailed list of steps to implement the feature or refactoring task.
* Testing: A list of tests that need to be implemented to verify the feature or refactoring task.

사용자 지정 에이전트 만들기

작업 공간 또는 사용자 프로필에 사용자 지정 에이전트 파일을 만들 수 있습니다.

1. 에이전트 드롭다운에서 사용자 지정 에이전트 구성을 선택한 다음 새 사용자 지정 에이전트 만들기를 선택하거나 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 Chat: New Custom Agent 명령을 실행합니다.

2. 사용자 지정 에이전트 파일이 생성될 위치를 선택합니다.

   • 작업 공간: 작업 공간의 .github/agents 폴더에 사용자 지정 에이전트 정의 파일을 만들어 해당 작업 공간 내에서만 사용합니다.

   • 사용자 프로필: 현재 프로필 폴더에 사용자 지정 에이전트 정의 파일을 만들어 모든 작업 공간에서 사용합니다.

3. 사용자 지정 에이전트의 파일 이름을 입력합니다. 이것은 에이전트 드롭다운에 표시되는 기본 이름입니다.

4. 새로 생성된 .agent.md 파일에 사용자 지정 에이전트에 대한 세부 정보를 제공합니다.

   • 파일 상단의 YAML 프론트매터를 채워 사용자 지정 에이전트의 이름, 설명, 도구 및 기타 설정을 구성합니다.
   • 파일 본문에 사용자 지정 에이전트에 대한 지침을 추가합니다.

사용자 지정 에이전트 정의 파일을 업데이트하려면 에이전트 드롭다운에서 사용자 지정 에이전트 구성을 선택한 다음 목록에서 사용자 지정 에이전트를 선택하여 수정합니다.

에이전트 드롭다운 목록 사용자 지정

여러 사용자 지정 에이전트가 있는 경우 에이전트 드롭다운에 표시되는 에이전트를 사용자 지정할 수 있습니다. 특정 사용자 지정 에이전트를 표시하거나 숨기려면

1. 에이전트 드롭다운에서 사용자 지정 에이전트 구성을 선택합니다.

2. 목록에서 사용자 지정 에이전트 위로 마우스를 이동한 다음 눈 아이콘을 선택하여 에이전트 드롭다운에서 표시하거나 숨깁니다.

도구 목록 우선순위

tools 메타데이터 필드를 사용하여 사용자 지정 에이전트와 프롬프트 파일 모두에 대해 사용 가능한 도구 목록을 지정할 수 있습니다. 프롬프트 파일은 agent 메타데이터 필드를 사용하여 사용자 지정 에이전트를 참조할 수도 있습니다.

채팅에서 사용 가능한 도구 목록은 다음 우선순위 순서에 따라 결정됩니다.

1. 프롬프트 파일에 지정된 도구(있는 경우)
2. 프롬프트 파일의 참조된 사용자 지정 에이전트의 도구(있는 경우)
3. 선택한 에이전트에 대한 기본 도구(있는 경우)

팀 간 사용자 지정 에이전트 공유(실험적)

팀 전체에서 사용자 지정 에이전트를 공유하려면 작업 공간 수준 사용자 지정 에이전트(.github/agents 폴더)를 만들 수 있습니다. 조직 내 여러 작업 공간에서 사용자 지정 에이전트를 공유하려면 조직 수준에서 정의할 수 있습니다.

VS Code는 계정이 액세스할 수 있는 조직 수준에서 정의된 사용자 지정 에이전트를 자동으로 감지합니다. 이러한 에이전트는 채팅의 에이전트 드롭다운에 기본 제공 에이전트, 개인 및 작업 공간 사용자 지정 에이전트와 함께 표시됩니다.

조직 수준 사용자 지정 에이전트의 검색을 사용하려면 github.copilot.chat.customAgents.showOrganizationAndEnterpriseAgents을(를) true로 설정합니다.

GitHub 설명서에서 조직에 대한 사용자 지정 에이전트를 만드는 방법을 알아보세요.

자주 묻는 질문

사용자 지정 에이전트는 채팅 모드와 다른가요?

이전에는 사용자 지정 에이전트가 사용자 지정 채팅 모드로 알려져 있었습니다. 기능은 동일하지만, 특정 작업에 대한 AI 동작을 사용자 지정하는 목적을 더 잘 반영하기 위해 용어가 업데이트되었습니다.

VS Code는 여전히 .chatmode.md 파일을 사용자 지정 에이전트로 인식합니다. 빠른 수정 작업을 사용하여 새 .github/agents 폴더로 이름을 바꾸고 이동하여 .agent.md 확장자로 만들 수 있습니다.

관련 리소스

• 사용자 지정 지침으로 AI 사용자 지정
• 재사용 가능한 프롬프트 파일 만들기
• 채팅에서 도구 사용