GitHub Copilot 명령 줄 인터페이스 (CLI)를 위한 사용자 지정 에이전트 생성 및 사용

소개

사용자 지정 에이전트를 사용하면 특정 작업에 맞게 Copilot의 전문성을 조정할 수 있습니다.

Copilot에 작업 수행을 요청하면, 해당 작업에 에이전트의 전문성이 적합하다고 판단되는 경우 Copilot는 사용자의 사용자 지정 에이전트 중 하나를 선택해 사용할 수 있습니다.

사용자 지정 에이전트가 수행하는 작업은 작업 완료를 위해 일시적으로 생성되는 하위 에이전트를 통해 수행됩니다. Subagent에는 주 에이전트와 관련이 없는 정보로 채울 수 있는 자체 컨텍스트 창이 있습니다. 이러한 방식으로 특히 대규모 작업의 경우 주 에이전트의 컨텍스트 창을 어지럽히지 않고도 작업의 일부를 사용자 지정 에이전트로 오프로드할 수 있습니다. 그런 다음 주 에이전트는 더 높은 수준의 계획 및 조정에 집중할 수 있습니다.

자세한 내용은 사용자 지정 에이전트 정보을(를) 참조하세요.

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

각 사용자 지정 에이전트는 .agent.md 확장자를 가진 Markdown 파일로 정의됩니다. 다음 단계에 설명된 대로 이러한 파일을 직접 만들거나 CLI 내에서 추가할 수 있습니다.

대화형 모드에서 .를 입력합니다 /agent.
옵션 목록에서 새 에이전트 만들기 를 선택합니다.
사용자 지정 에이전트를 리포지토리에 생성할지 또는 홈 디렉터리에 생성할지 옵션 중에서 선택합니다.
- ```
     **프로젝트** (`.github/agents/`)
```
- ```
     **사용자** (`~/.config/copilot/agents/`)
```
참고 항목

두 위치에 동일한 이름의 사용자 지정 에이전트가 있는 경우, 리포지토리에 있는 것 대신 홈 디렉터리에 있는 것이 사용됩니다.
Copilot가 사용자 지정 에이전트 파일을 생성하도록 할지, 아니면 직접 생성할지 선택합니다.
```
       **옵션 1: Copilot 사용**
```
만들려는 에이전트의 세부 정보를 입력합니다. 에이전트의 전문 지식과 에이전트를 사용해야 하는 시기를 설명합니다. Copilot는 사용자가 입력한 설명을 바탕으로 에이전트 프로필을 작성합니다.

예를 들어 다음과 같이 입력할 수 있습니다.
```
I am a security expert. I check code files thoroughly for potential security issues. Use me whenever a security review/check/audit is requested for one or more code files, or when the word "seccheck" is used in a prompt in reference to code files.

I will identify potential problems, such as code that:

- Exposes secrets or credentials
- Allows cross-site scripting
- Allows SQL injection
- Contains vulnerable dependencies
- Allows authentication to be bypassed

If any problems are identified, create a single GitHub issue in this repository on GitHub.com with details of problems, giving full details of each issue, including, but not limited to, risk level and recommended fix.
```
Copilot이(가) 초기 에이전트 프로필 생성을 완료하면 다음 옵션이 표시됩니다.
- 계속
- 콘텐츠 검토
- 다시 시도
- Quit
콘텐츠를 검토하도록 선택하면 에이전트 파일이 기본 편집기에서 열립니다. 필요한 경우 CLI에서 에이전트 만들기 프로세스를 계속하기 전에 검토하고 변경할 수 있습니다.

만들기 프로세스를 완료하려면 [계속]을 선택합니다.
```
       **옵션 2: 수동으로 에이전트 프로필 만들기**
```
에이전트 파일을 직접 만들도록 선택하면 에이전트 프로필을 만드는 데 필요한 정보를 입력하는 일련의 프롬프트를 안내합니다.
1. 에이전트의 이름을 입력합니다. 입력한 이름은 사용 가능한 에이전트를 나열할 때 표시되는 이름입니다. 이 버전은 에이전트 파일의 이름으로 사용됩니다. 예를 들어 "보안 전문가"를 입력하면 에이전트 파일의 이름이 지정 security-expert.agent.md됩니다.
  
  팁
  
  사용자 지정 에이전트를 프로그래밍 방식으로 사용할 때의 편의를 위해, 소문자와 하이픈만으로 구성된 이름을 선택하는 것이 권장됩니다.
2. 이 에이전트의 전문 지식과 사용 시기를 나타내는 설명을 입력합니다.
3. 특정 지침, 수행해야 하는 작업 또는 따라야 하는 제약 조건을 포함하여 에이전트의 동작 방식에 대한 지침을 입력합니다.
사용자 지정 에이전트가 접근할 수 있어야 할 도구를 선택합니다.

기본적으로 사용자 지정 에이전트은(는) 모든 도구에 액세스할 수 있습니다. 에이전트의 액세스를 tools 제한하는 경우 에이전트 파일에 사양이 추가됩니다.
새로운 사용자 지정 에이전트를 로드하려면 CLI를 다시 시작합니다.

사용자 지정 에이전트를 사용하는 방법

사용자 지정 에이전트는 다음과 같은 방식으로 사용할 수 있습니다.

```
        **슬래시 커맨드**
```
대화형 모드에서 /agent을 입력하고 사용 가능한 사용자 지정 에이전트 목록에서 선택합니다. 그런 다음 선택한 에이전트에 전달될 프롬프트를 입력합니다.

참고 항목

CLI의 기본 에이전트는 이 목록에 포함되지 않습니다. 기본 에이전트에 대한 자세한 내용은 GitHub Copilot CLI 사용을 참조하세요.

        **명시적 명령**

Copilot에게 특정 에이전트를 사용하도록 지시하세요. 다음은 그 예입니다.

Use the security-auditor agent on all files in the /src/app directory

```
        **유추별**
```
에이전트 파일의 설명에 따라 특정 에이전트의 사용을 트리거하는 프롬프트를 사용합니다. 다음은 그 예입니다.
```
Check all TypeScript files in or under the src directory for potential security problems
```
또는 (여기서 "seccheck"는 에이전트 프로필에서 트리거 단어로 정의됩니다.)
```
seccheck /src/app/validator.go
```
Copilot은(는) 자동으로 사용자가 사용하려는 에이전트를 유추합니다.
```
        **프로그래밍적으로**
```
명령줄 옵션을 사용하여 사용할 사용자 지정 에이전트를 지정합니다. 다음은 그 예입니다.
```
copilot --agent security-auditor --prompt "Check /src/app/validator.go"
```
여기서 security-auditor은 .agent.md 확장자를 제외한 사용자 지정 에이전트 프로필의 파일 이름입니다. 일반적으로 반드시 그렇지는 않지만 에이전트 프로필의 name 값과 동일합니다.

추가 읽기

        [AUTOTITLE](/copilot/concepts/agents/copilot-cli/comparing-cli-features)

        [AUTOTITLE](/copilot/reference/custom-agents-configuration)

        [AUTOTITLE](/copilot/tutorials/customization-library/custom-agents) - 큐레이팅된 예제 컬렉션

GitHub Copilot 명령 줄 인터페이스 (CLI)를 위한 사용자 지정 에이전트 생성 및 사용

이 문서의 내용

소개

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

사용자 지정 에이전트를 사용하는 방법

추가 읽기