# 사용자 지정 에이전트 호출

사용자 지정 에이전트, 기술 및 MCP 서버를 Copilot CLI 사용하여 기능을 확장합니다.

## custom agents 사용

A custom agent 는 특수화된 버전의 Copilot.
Custom agents 는 고유한 워크플로, 특정 코딩 규칙 및 전문가 사용 사례를 처리하는 데 도움이 Copilot 됩니다.

Copilot CLI 에는 일반적인 작업에 대한 기본 그룹이 custom agents 포함되어 있습니다.

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

CLI에서 사용하는 AI 모델은 작업을 보다 효과적으로 완료할 수 있다고 판단할 경우 특정 전문 지식을 사용하여 custom agent 작동하는 자회사 스바겐트 프로세스에 작업을 위임하도록 선택할 수 있습니다. 모델은 주 에이전트에서 직접 작업을 처리하도록 똑같이 선택할 수 있습니다.

Markdown 파일인 custom agents을 사용하여 에이전트가 가져야 할 전문 지식, 사용할 수 있는 도구, 응답 방법에 대한 특정 지침을 정의하는 agent profiles을 직접 설정할 수 있습니다.

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

| 유형                                                                                                                                                                                                                                              | 위치                                                          | Scope         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------- |
| 사용자 수준 custom agent                                                                                                                                                                                                                             | 로컬 `~/.copilot/agents` 디렉터리                                 | 모든 프로젝트       |
| 리포지토리 수준 custom agent                                                                                                                                                                                                                           |                                                             |               |
| `.github/agents` 로컬 및 원격 리포지토리의 디렉터리                                                                                                                                                                                                            | 현재 프로젝트                                                     |               |
| 조직 수준 custom agent                                                                                                                                                                                                                              | 조직의 `/agents` 또는 `.github` 리포지토리에 있는 `.github-private` 디렉터리 | 조직 내의 모든 프로젝트 |
| 엔터프라이즈 수준 custom agent                                                                                                                                                                                                                          |                                                             |               |
| `/agents` 엔터프라이즈 설정에 `.github-private` 지정된 조직의 리포지토리에 있는 디렉터리입니다. 자세한 내용은 [엔터프라이즈에서 사용자 지정 에이전트 사용 준비](/ko/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents)을(를) 참조하세요. | 엔터프라이즈 계정의 모든 프로젝트                                          |               |

명명 충돌(에이전트가 동일한 파일 이름을 공유하는 경우)의 경우 사용자 수준 에이전트는 리포지토리 수준 에이전트를 재정의하고, 리포지토리 수준 에이전트는 조직 수준 에이전트를 재정의하고, 조직 수준 에이전트는 엔터프라이즈 수준 에이전트를 재정의합니다.

Custom agents 은 다음 세 가지 방법으로 사용할 수 있습니다.

* CLI의 대화형 인터페이스에서 슬래시 명령을 사용하여 사용 가능한 custom agents목록에서 선택합니다.

  ```shell
  /agent
  ```

* 프롬프트에서 custom agent 직접 호출:

  ```shell
  Use the refactoring agent to refactor this code block
  ```

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

* custom agent 명령줄 옵션과 함께 사용할 항목을 지정합니다. 다음은 그 예입니다.

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

자세한 내용은 [에 대한 사용자 지정 에이전트 만들기 Copilot cloud agent](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)을(를) 참조하세요.

## 기술 사용

명령, 스크립트 및 리소스를 사용하여 특수 작업을 수행하는 기능을 Copilot 향상시키는 기술을 만들 수 있습니다.

자세한 내용은 [GitHub Copilot CLI에 에이전트 기술 추가](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-skills)을(를) 참조하세요.

## MCP 서버 추가

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

사용 가능한 Copilot CLI기능을 확장하려면 MCP 서버를 더 추가할 수 있습니다.

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

   ```shell
   /mcp add
   ```

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

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

구성된 MCP 서버의 세부 정보는 `mcp-config.json` 파일에 저장됩니다. 이 파일은 기본적으로 `~/.copilot` 디렉터리에 위치합니다.
`COPILOT_HOME` 환경 변수를 설정하여 이 위치를 변경할 수 있습니다. 서버 정의의 JSON 구조에 대한 정보는 [리포지토리에 대한 MCP 서버 구성](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers)을(를) 참조하세요.

MCP 서버를 Copilot CLI추가하고 관리하는 방법에 대한 자세한 내용은 [에 대한 MCP 서버 추가 GitHub Copilot CLI](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)을 참조하세요.

## 다음 단계

작업을 계속 진행하기 위해 작업 실행 중에 에이전트 동작을 안내하고 구체화하는 방법을 알아보려면 [GitHub Copilot CLI의 조향 에이전트](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents)을 참조하세요.