사용자 지정 에이전트 정보

          사용자 지정 에이전트 은 고유한 워크플로, 코딩 규칙 및 사용 사례에 맞게 조정할 수 있는 에이전트의 Copilot 특수 버전입니다. 표준을 따르고, 올바른 도구를 사용하고, 팀별 사례를 구현하는 맞춤형 팀원처럼 작동합니다. 동일한 지침과 컨텍스트를 반복적으로 제공하는 대신 이러한 에이전트를 한 번 정의합니다.

You define 사용자 지정 에이전트 를 에이전트 프로필 라는 Markdown 파일을 사용하여 정의합니다. 이러한 파일은 프롬프트, 도구 및 MCP 서버를 지정합니다. 이렇게 하면 규칙, 프레임워크 및 원하는 결과를 직접 인코딩할 Copilot수 있습니다.

          에이전트 프로필는 사용자 지정 에이전트의 동작을 정의합니다. 작업 또는 문제에 에이전트를 할당하면 사용자 지정 에이전트가 인스턴스화됩니다.

자체적으로 사용자 지정 에이전트를 정의하는 것 외에도 Copilot에는 미리 빌드된 사용자 지정 에이전트 집합이 포함됩니다. 기본 제공 에이전트를 참조하세요.

          에이전트 프로필 형식

          에이전트 프로필 는 YAML 프런트매터가 있는 Markdown 파일입니다. 가장 간단한 형식으로 다음을 포함합니다.

이름 (선택 사항): 에 대한 사용자 지정 에이전트표시 이름입니다. 생략하면 에이전트의 파일 이름이 식별자 및 기본 표시 이름으로 사용됩니다.
설명: 에이전트의 용도 및 기능을 설명합니다.
프롬프트: 에이전트의 동작 및 전문 지식을 정의하는 사용자 지정 지침입니다.
도구 (선택 사항): 에이전트가 액세스할 수 있는 특정 도구입니다. 기본적으로 에이전트는 기본 제공 도구 및 MCP 서버 도구를 포함하여 사용 가능한 모든 도구에 액세스할 수 있습니다.
```
        에이전트 프로필 는 `mcp-servers` 속성을 사용하여 MCP 서버 구성을 포함할 수 있습니다.
```

예제 에이전트 프로필

이 예제는 이름, 설명 및 프롬프트가 구성된 기본 에이전트 프로필 예제입니다.

---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images

구성할 수 있는 위치 사용자 지정 에이전트

다음과 같은 다양한 수준에서 정의 에이전트 프로필 할 수 있습니다.

리포지토리 수준: 프로젝트별 에이전트를 위해 리포지토리에서 .github/agents/CUSTOM-AGENT-NAME.md 생성합니다.
조직 또는 엔터프라이즈 수준: 더 광범위한 가용성을 위해 /agents/CUSTOM-AGENT-NAME.md를 .github-private 리포지토리에 만듭니다.

자세한 내용은 조직에서 사용자 지정 에이전트 사용 준비 및 엔터프라이즈에서 사용자 지정 에이전트 사용 준비을(를) 참조하세요.

기본 제공 에이전트

프롬프트 Copilot 를 제출할 때 요청을 처리하는 주 코파일럿 CLI 에이전트 외에도 주 에이전트가 일반적인 개발 작업을 지원하기 위해 하위 에이전트로 실행할 수 있는 다음과 같은 기본 제공 에이전트가 포함되어 있습니다. 이러한 에이전트는 효율성과 정확도에 최적화되어 기본 언어 모델 및 도구의 기능을 활용하여 해당 도메인에서 고품질 지원을 제공합니다.

          Copilot 는 프롬프트 및 현재 컨텍스트에 따라 적절한 기본 제공 에이전트를 자동으로 사용합니다. 예를 들어 프롬프트 `How does authentication work in this codebase?` 는 일반적으로 Explore 에이전트를 트리거하고 슬래시 명령을 사용하면 `/research` Research 에이전트가 트리거됩니다.

탐색 - 빠르고 간단한 코드베이스 탐색 에이전트입니다. 이 도구는 코드 인텔리전스, grep, glob, view 및 셸 도구를 활용하여 파일을 검색하고 코드 구조를 파악합니다. 파일을 변경하지 않으므로 주 Copilot 에이전트에서 실행하는 다른 스바겐트와 병렬로 호출할 수 있습니다. GITHUB MCP 서버 도구에 대한 읽기 전용 액세스 권한이 있습니다.
task - 개발 명령(테스트, 빌드, linter, 포맷터, 종속성 설치)을 실행하고 결과를 효율적으로 보고하는 명령 실행 에이전트입니다. 성공에 대한 간략한 요약과 실패에 대한 전체 출력을 반환하여 주 컨텍스트를 정리합니다. 동일한 사용 권한을 부여하거나 거부하여 부모 에이전트가 사용할 수 있는 모든 도구(하위 컨텍스트에서 적절하지 않은 도구 제외)에 액세스할 수 있습니다.
범용 - 이 에이전트는 기본적으로 주 Copilot 에이전트와 동일한 기능을 모두 갖습니다. 주 에이전트는 범용 에이전트를 하위 에이전트로 실행하여 별도의 컨텍스트 창이 필요한 작업을 지원하거나 적절한 경우 병렬로 실행할 수 있습니다.
코드 검토 - 매우 높은 신호 대 노이즈 비율로 코드 변경 내용을 검토합니다. 이 에이전트는 스테이징된 변경 사항과 스테이징되지 않은 변경 사항 및 브랜치 간 차이점을 분석하여 버그, 보안 취약점, 경합 조건, 메모리 누수, 논리 오류 등 진정으로 중요한 문제만 선별해 보여줍니다. 스타일이나 서식에 대해서는 주석을 달지 않습니다. 파일을 변경하지 않습니다.
연구 - 이 에이전트는 직원 수준의 소프트웨어 엔지니어 및 연구 전문가로 운영됩니다. 코드베이스, API, 라이브러리 및 소프트웨어 아키텍처에 대한 완전하고 세심하게 조사된 답변을 제공합니다. 검색/탐색 도구, 웹 페치/검색 및 로컬 도구를 사용합니다 GitHub . 다른 에이전트와 달리 연구 에이전트는 슬래시 명령을 사용하여 /research 호출할 수 있습니다. 주 에이전트에 의해 자동으로 트리거될 수 없습니다.
rubber-duck - 자체 계획, 코드 및 테스트에 대한 두 번째 의견을 제공하는 Copilot 건설적인 비평가입니다. 세션을 구동하는 모델과 다른 모델에서 실행되므로 보완적인 관점을 제공합니다. 파일 자체를 변경하지 않고 제안된 변경 내용을 검토하도록 설계되었습니다. 자세한 내용은 고무 오리 에이전트 정보을(를) 참조하세요.

에이전트를 스바젠트로 실행

직접 정의한 사용자 지정 에이전트 또는 기본 제공 에이전트를 사용할 경우의 이점 중 하나는 주 Copilot 에이전트가 별도의 컨텍스트 창을 사용하여 하위 에이전트로 실행할 수 있다는 점입니다. 즉, 사용자 지정 에이전트 또는 기본 제공 에이전트는 주 에이전트의 컨텍스트 창을 어지럽히지 않고 특정 하위 작업에 집중할 수 있습니다.

적절한 경우 스바겐트에서 수행하는 작업을 병렬로 실행하여 전체 작업을 더 빠르게 완료할 수 있습니다.

자세한 내용은 GitHub Copilot CLI 사용자 지정 기능 비교을(를) 참조하세요.

다음 단계

직접 사용자 지정 에이전트만들려면 다음을 참조하세요.

사용자 지정 에이전트 정보

이 기사에서