사용자 지정 에이전트 만들기 및 사용 GitHub Copilot CLI

특정 개발 작업에 대한 맞춤형 전문 지식을 갖춘 전문 에이전트를 만듭니다.

이 기사에서

소개

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

Copilot에게 작업을 수행하라고 요청하면, custom agents이/가 에이전트의 전문 지식이 그 작업에 적합하다고 판단할 경우, Copilot 중 하나를 선택하여 사용할 수 있습니다.

주 에이전트가 custom agent에 작업을 위임하면 해당 작업은 자체 컨텍스트 창이 있는 하위 에이전트에 의해 수행됩니다. 이렇게 하면 전문가가 주 에이전트의 컨텍스트를 어지럽히지 않고 할당된 작업에 집중할 수 있습니다. 세션에 대해 custom agent을 직접 선택할 수도 있습니다.

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

custom agent을 만들기

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

  1. 대화형 모드에서 .를 입력합니다 /agent.

  2. N 키를 눌러 새 에이전트를 만듭니다.

  3. 리포지토리 또는 홈 디렉터리에 만드는 custom agent 옵션 중에서 선택합니다.

    • Project(.github/agents/)

    • 사용자 (~/.copilot/agents/)

    참고

    개인과 리포지토리 custom agents의 ID가 동일하면 개인 에이전트가 사용됩니다. agents 디렉터리의 루트에 있는 에이전트의 경우 ID는 .md 또는 .agent.md 확장자를 제외한 파일 이름입니다. 선택적 name 필드는 중복 제거에 영향을 주지 않습니다. 같은 name를 가지지만 ID가 서로 다른 에이전트는 둘 다 로드되지만, --agent 값이 둘 이상의 ID 또는 name와 일치하면 CLI는 우선순위가 가장 높은 일치 항목을 사용합니다.

  4. Copilot를 가져와 custom agent 파일을 만들지, 아니면 직접 만들지를 결정합니다.

옵션 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됩니다.

    팁

    프로그래밍 방식으로 사용할 custom agent 때 사용 편의성을 위해 소문자와 하이픈으로만 구성된 이름을 선택하는 것이 좋습니다.

  2. 이 에이전트의 전문 지식과 사용 시기를 나타내는 설명을 입력합니다.

  3. 특정 지침, 수행해야 하는 작업 또는 따라야 하는 제약 조건을 포함하여 에이전트의 동작 방식에 대한 지침을 입력합니다.

  4. 귀하의 custom agent이(가) 액세스해야 할 도구를 선택하세요.

    기본적으로 custom agents 모든 도구에 액세스할 수 있습니다. 에이전트의 액세스를 tools 제한하는 경우 에이전트 파일에 사양이 추가됩니다.

  5. CLI를 다시 시작하여 새 custom agent를 로드합니다.

custom agent을(를) 사용하여

Custom agents 은 다음과 같은 방법으로 사용할 수 있습니다.

  • 슬래시 커맨드

    대화형 모드에서 /agent를 입력하고 사용 가능한 custom agents 목록에서 선택합니다. 그런 다음 선택한 에이전트에 전달될 프롬프트를 입력합니다.

    참고

    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 은 사용하려는 에이전트를 자동으로 유추합니다.

  • 프로그래밍적으로

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

copilot --agent security-auditor --prompt "Check /src/app/validator.go"

이 예에서 security-auditor는 custom agent의 ID입니다. ID는 파일 이름 또는 확장명 없이 .md``.agent.md 파생됩니다. 이 경우 파일의 경로는 하나 agents/security-auditor.md 또는 agents/security-auditor.agent.md. 파일이 하위 디렉터리에 agents있는 경우 하위 디렉터리 이름은 ID에 포함되고 디렉터리 구분 기호는 .로 --바뀝니다. 따라서 agents/security/security-auditor.agent.md에 있는 에이전트 파일의 ID는 security--security-auditor입니다. 또는 ID 대신 필드 값을 name 사용하여 따옴표로 묶을 수 있습니다. --agent "Security Auditor"을 예로 들 수 있습니다.

집중된 작업을 특정 모델에 위임

custom agent을(를) 특정 모델을 사용하도록 구성할 수 있습니다.

이는 기본 세션에 클라우드 기반 모델을 사용하는 동안 로컬에서 호스팅되는 모델을 사용하는 custom agent 에이전트에 작고 명확하게 정의된 작업을 위임하려는 경우에 특히 유용할 수 있습니다. 예를 들어 이 방법을 사용하면 로컬 모델을 사용하는 custom agent에 단일 파일 변경 또는 집중된 테스트 수정 사항을 위임한 다음, 주 에이전트가 그 결과를 검토하도록 할 수 있습니다.

먼저 CLI에 로컬로 호스트된 모델을 추가합니다. GitHub Copilot CLI에 LLM 모델 추가하기을(를) 참조하세요.

  1. 다음 콘텐츠로 ~/.copilot/agents/local-coder.agent.md를 만드세요.

    ---
name: local-coder
description: >
  Use for small, well-defined coding tasks, such as a
  single-file change or a focused test fix.
model: LOCAL-PROVIDER/LOCAL-MODEL
model-policy: required
tools: ["read", "grep", "glob", "edit", "execute"]
strict-tools-list: true
include-custom-instructions: true
---

Complete only the requested task. Inspect the relevant
code, make the smallest correct change, and run focused
checks. Report what changed and any remaining issues.

  2. LOCAL-PROVIDER/LOCAL-MODEL를 표시 이름이 아닌 로컬 모델의 공급자 정규화 ID로 바꾸세요. providers.json에 있는 모델의 경우 모델 항목의 provider 및 id 값을 슬래시(/)로 구분하여 결합합니다. 예를 들어, "provider": "local" 및 "id": "qwen3:8b"는 local/qwen3:8b를 제공합니다.

model-policy: required 에는 선호로 처리하는 대신 구성된 모델이 필요합니다.

strict-tools-list: true 는 일반적인 기본 도구를 추가하지 않고 나열된 도구 그룹으로 에이전트를 제한합니다.

include-custom-instructions: true 는 하위 에이전트에 대해 리포지토리의 지침이 계속 유효하도록 유지합니다.

  1. CLI를 다시 시작하여 에이전트를 로드하세요. 클라우드 모델을 사용하는 세션에서는 범위가 제한된 작업을 명시적으로 위임합니다.

    Use the local-coder agent to add an empty-input test for
parseConfig in src/config.test.ts. Do not change other
files. Then review the result in the main session.

    로컬 모델은 위임된 작업을 실행하지만 주 에이전트는 여전히 결과를 받습니다. 이렇게 해서 전체 세션이 로컬 또는 오프라인으로 설정되지는 않습니다.

custom agent에 리포지토리의 사용자 지정 지침 적용

사용자 지정 명령 파일(예: .github/copilot-instructions.md, AGENTS.md및 CLAUDE.md)은 리포지토리에서 작업하는 방법을 알려줍니다 Copilot . 자세한 내용은 GitHub Copilot 대한 리포지토리 사용자 지정 지침 추가을(를) 참조하세요.

더 큰 작업의 일부를 처리하기 위해 하위 에이전트로 실행하는 custom agent 경우Copilot, 스바젠트는 기본적으로 리포지토리의 사용자 지정 지침을 따르지 않습니다. 이렇게 하면 하위 에이전트가 부여된 특정 작업에 집중할 수 있습니다.

하위 에이전트가 리포지토리의 규칙(예: 코드를 검토하거나 편집하는 에이전트)을 따르도록 하려면 에이전트 파일의 프런트매터에 추가 include-custom-instructions: true 합니다.

---
name: RepoAwareReviewer
description: Reviews a change against this repository's conventions
tools: ["*"]
include-custom-instructions: true
---

Review the change and flag anything that violates the repository's conventions.

참고

이 설정은 에이전트가 스바겐트로 실행되는 경우에만 영향을 줍니다. 사용자가 직접 선택한 --agent—/agent, custom agent 또는 추론을 통해 선택한 경우—는 이미 리포지토리에 설정된 사용자 지정 지침을 따르므로, 이 경우에는 이 설정이 적용되지 않습니다.

이 설정이 옵션과 --no-custom-instructions 상호 작용하는 방법을 비롯한 자세한 내용은 GitHub Copilot CLI 명령 참조을 참조하세요.

추가 읽기