사용자 지정 에이전트 정보

          사용자 지정 에이전트 정보

          사용자 지정 에이전트 은 고유한 워크플로, 코딩 규칙 및 사용 사례에 맞게 조정할 수 있는 에이전트의 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, 뷰 도구 및 셸 도구를 사용하여 파일을 검색하고 코드 구조를 이해합니다. 파일을 변경하지 않으므로 주 Copilot 에이전트에서 실행하는 다른 스바겐트와 병렬로 호출할 수 있습니다. GitHub MCP 서버 도구에 대한 읽기 전용 액세스 권한이 있습니다.

        **task** - 개발 명령(테스트, 빌드, linter, 포맷터, 종속성 설치)을 실행하고 결과를 효율적으로 보고하는 명령 실행 에이전트입니다. 성공에 대한 간략한 요약과 실패에 대한 전체 출력을 반환하여 주 컨텍스트를 정리합니다. 동일한 사용 권한을 부여하거나 거부하여 부모 에이전트가 사용할 수 있는 모든 도구(하위 컨텍스트에서 적절하지 않은 도구 제외)에 액세스할 수 있습니다.

        **범용** - 이 에이전트는 기본적으로 주 Copilot 에이전트와 동일한 기능을 모두 갖습니다. 주 에이전트는 범용 에이전트를 하위 에이전트로 실행하여 별도의 컨텍스트 창이 필요한 작업을 지원하거나 적절한 경우 병렬로 실행할 수 있습니다.

        **코드 검토** - 매우 높은 신호 대 노이즈 비율로 코드 변경 내용을 검토합니다. 이 에이전트는 스테이지된/스테이지되지 않은 변경 사항 및 브랜치 간 차이에서 버그, 보안 취약성, 경합 상태, 메모리 누수, 논리 오류와 같이 진정으로 중요한 문제를 분석합니다. 스타일이나 서식에 대해서는 주석을 달지 않습니다. 파일을 변경하지 않습니다.

        **연구** - 이 에이전트는 직원 수준의 소프트웨어 엔지니어 및 연구 전문가로 운영됩니다. 코드베이스, API, 라이브러리 및 소프트웨어 아키텍처에 대한 완전하고 세심하게 조사된 답변을 제공합니다. 검색/탐색 도구, 웹 페치/검색 및 로컬 도구를 사용합니다 GitHub . 다른 에이전트와 달리 연구 에이전트는 슬래시 명령을 사용하여 `/research` 호출할 수 있습니다. 주 에이전트에 의해 자동으로 트리거될 수 없습니다.

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

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

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

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

다음 단계

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

        [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)

        [AUTOTITLE](/copilot/reference/customization-cheat-sheet)

이 기사에서

예제 에이전트 프로필

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

기본 제공 에이전트

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

다음 단계