사용자 지정 에이전트 호출

사용자 지정 에이전트와 기술, 그리고 MCP 서버를 통합하여 Copilot CLI의 기능을 더욱 폭넓게 확장해 보세요.

누가 이 기능을 사용할 수 있나요?

GitHub Copilot CLI는 모든 Copilot 플랜에서 사용할 수 있습니다. 조직에서 Copilot을 수신하는 경우 조직의 설정에서 Copilot CLI 정책을 활성화해야 합니다.

이 문서의 내용

사용자 지정 에이전트 사용하기

사용자 지정 에이전트는 Copilot의 특화시킨 버전입니다. 사용자 지정 에이전트는 Copilot가 고유한 워크플로, 특정 코딩 규칙, 그리고 전문적인 사용 사례를 처리하도록 지원합니다.

Copilot CLI에는 일반적인 작업을 위한 기본 사용자 지정 에이전트 그룹이 포함되어 있습니다.

대리인 설명
탐험하다 빠른 코드베이스 분석을 수행하여 주 컨텍스트에 추가하지 않고 코드에 대해 질문할 수 있습니다.
과업 테스트 및 빌드와 같은 명령을 실행하여 성공에 대한 간략한 요약과 실패 시 전체 출력을 제공합니다.
범용 전체 도구 집합 및 고품질 추론이 필요한 복잡한 다단계 작업을 처리하여 기본 대화에 명확하게 집중하도록 별도의 컨텍스트에서 실행합니다.
코드 검토 변경 내용을 검토할 때 실제 문제만 노출하여 노이즈를 최소화하는 데 중점을 둡니다.

CLI에서 사용되는 AI 모델은 작업을 보다 효과적으로 완료할 수 있다고 판단하는 경우, 특정 전문성을 갖춘 사용자 지정 에이전트를 사용하는 보조 하위 에이전트 프로세스에 작업을 위임하도록 선택할 수 있습니다. 모델은 주 에이전트에서 직접 작업을 처리하도록 똑같이 선택할 수 있습니다.

에이전트가 갖추어야 할 전문성, 사용할 수 있는 도구, 그리고 응답 방식에 대한 구체적인 지침을 지정하는 에이전트 프로필라는 Markdown 파일을 사용하여 고유한 사용자 지정 에이전트를 정의할 수 있습니다.

사용자, 리포지토리 또는 조직/엔터프라이즈 수준에서 사용자 지정 에이전트를 정의할 수 있습니다.

유형위치Scope
사용자 수준 사용자 지정 에이전트로컬 ~/.copilot/agents 디렉터리모든 프로젝트
리포지토리 수준 사용자 지정 에이전트
          `.github/agents` 로컬 및 원격 리포지토리의 디렉터리 | 현재 프로젝트 |

| 조직 및 Enterprise 수준 사용자 지정 에이전트 | /agents 조직 또는 엔터프라이즈의 .github-private 리포지토리에 있는 디렉터리 | 조직 및 엔터프라이즈 계정의 모든 프로젝트 |

명명 충돌이 발생할 경우 시스템 수준 에이전트는 리포지토리 수준 에이전트를 우선하고 리포지토리 수준 에이전트는 조직 수준 에이전트를 우선합니다.

사용자 지정 에이전트는 세 가지 방법으로 사용할 수 있습니다.

  • CLI의 대화형 인터페이스에서 슬래시 명령을 사용하여 사용 가능한 사용자 지정 에이전트 목록에서 선택합니다.

    /agent

  • 프롬프트 내에서 사용자 지정 에이전트을 바로 불러올 수 있습니다.

    Use the refactoring agent to refactor this code block

    Copilot은(는) 자동으로 사용자가 사용하려는 에이전트를 유추합니다.

  • 명령줄 옵션을 사용하여 사용자 지정 에이전트를 지정하세요. 다음은 그 예입니다.

    copilot --agent=refactor-agent --prompt "Refactor this code block"

자세한 내용은 Copilot 코딩 도우미용 사용자 지정 에이전트 만들기을(를) 참조하세요.

기술 사용

Copilot의 특수 작업 수행 능력을 강화시키기 위해 지침, 스크립트 및 리소스를 사용하여 기술을 만들 수 있습니다.

자세한 내용은 GitHub Copilot CLI용 에이전트 기술 생성을(를) 참조하세요.

MCP 서버 추가

Copilot CLI는 이미 구성된 GitHub MCP 서버와 함께 제공됩니다. 이 MCP 서버를 사용하면 GitHub.com 리소스와 상호 작용할 수 있습니다. 예를 들어, CLI에서 끌어오기 요청을 병합할 수 있습니다.

Copilot CLI에서 사용할 수 있는 기능을 확장하려면 MCP 서버를 더 추가하세요.

  1. 다음 슬래시 명령 사용:

    /mcp add

  2.        <kbd>Tab</kbd> 키를 사용하여 필드 간에 이동하면서 추가하려는 MCP 서버의 세부 정보를 입력합니다.

  3.        <kbd>Ctrl</kbd>+<kbd>S</kbd>를 눌러 세부 정보를 저장하세요.

구성된 MCP 서버의 세부 정보는 mcp-config.json 파일에 저장됩니다. 이 파일은 기본적으로 ~/.copilot 디렉터리에 위치합니다. COPILOT_HOME 환경 변수를 설정하여 이 위치를 변경할 수 있습니다. 서버 정의의 JSON 구조에 대한 정보는 MCP(모델 컨텍스트 프로토콜)를 사용하여 GitHub Copilot 코딩 에이전트 확장을(를) 참조하세요.

Copilot CLI에서 MCP 서버를 추가하고 관리하는 방법에 대한 자세한 내용은 GitHub Copilot CLI에 MCP 서버 추가하기을 참조하세요.

다음 단계:

작업을 계속 진행하기 위해 작업 실행 중에 에이전트 동작을 안내하고 구체화하는 방법을 알아보려면 GitHub Copilot CLI의 조작 에이전트을 참조하세요.