에 대한 사용자 지정 에이전트 만들기 Copilot 클라우드 에이전트

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

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

Copilot 클라우드 에이전트는 GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business,GitHub Copilot Enterprise 플랜과 함께 사용할 수 있습니다. 에이전트는 GitHub에 저장된 모든 리포지토리에서 사용할 수 있습니다. 단, 관리형 사용자 계정가 소유한 리포지토리에서는 에이전트가 명시적으로 비활성화되어 있습니다.
Sign up for Copilot

이 기사에서

          사용자 지정 에이전트 를 사용하면 Copilot의 전문성을 특정 작업에 맞게 조정할 수 있습니다. 개념적 개요는 사용자 지정 에이전트[AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents)을 참조하세요.

참고

사용자 지정 에이전트은(는) JetBrains IDE, Eclipse 및 Xcode의 경우 공개 미리 보기에 있으며 변경될 수 있습니다.

리포지토리에서 사용자 지정 에이전트 프로필을 GitHub

생성하기

  1.        [
       https://github.com/copilot/agents
       ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) 에이전트 탭으로 이동합니다.

  2. 프롬프트 상자의 드롭다운 메뉴를 사용하여 사용자 지정 에이전트 프로필을 만들 리포지토리를 선택합니다.

    참고

    조직 및 엔터프라이즈 소유자는 조직 또는 엔터프라이즈의 모든 리포지토리에서 사용할 수 있는 사용자 지정 에이전트를 .github-private 리포지토리에서 조직 및 엔터프라이즈 수준으로 만들 수 있습니다. 자세한 내용은 엔터프라이즈에서 사용자 지정 에이전트 사용 준비 및 조직에서 사용자 지정 에이전트 사용 준비을(를) 참조하세요.

  3. 옵션으로, 에이전트 프로필를 만들려는 분기를 선택합니다. 기본값은 메인 브랜치입니다.

  4. 를 클릭한 다음 에이전트 만들기를 클릭합니다. 그러면 대상 리포지토리의 my-agent.agent.md 디렉터리에서 .github/agents이라는 템플릿 에이전트 프로필이 열립니다.

  5. 조직 또는 엔터프라이즈 수준 사용자 지정 에이전트을(를) 만드는 경우, 템플릿을 루트 agents 디렉터리로 이동하려면 파일 경로의 .github/ 부분을 삭제합니다.

  6. 에이전트의 용도를 식별하는 고유한 설명이 포함된 이름을 선택하여 파일 이름(이전 .agent.md텍스트)을 편집합니다. 파일 이름에는 다음 문자.만 포함될 수 있습니다. , , -``_, a-z``A-Z``0-9.

  7.        에이전트 프로필이름, 설명, 도구 및 프롬프트를 포함하여 구성합니다. 자세한 내용은 에이전트 프로필가 포함할 수 있는 항목에 대해 [구성을 에이전트 프로필](#configuring-an-agent-profile) 참조하세요.

  8. 파일을 리포지토리에 커밋하고 기본 분기에 병합합니다. 에이전트 탭으로 돌아가세요. 필요한 경우 페이지를 새로 고치세요. 사용자 지정 에이전트 프롬프트 상자를 클릭하면 드롭다운에 표시됩니다.

          Visual Studio Code에서 사용자 지정 에이전트 프로필 만들기

1. Visual Studio Code에서 GitHub Copilot 채팅를 엽니다.

  1. 채팅 보기 아래쪽의 에이전트 드롭다운에서 사용자 지정 에이전트 구성을 클릭한 다음 새로 만들기를 클릭합니다사용자 지정 에이전트.
  2.        에이전트 프로필를 만들 위치를 선택하십시오.
    * 작업 영역: 해당 작업 영역에서만 사용하려면 작업 영역의 .github/agents 폴더에 프로필을 사용자 지정 에이전트 생성합니다. * 사용자 프로필: 현재 사용자 프로필 폴더에 프로필을 만들어 사용자 지정 에이전트 모든 작업 영역에서 사용합니다.
  3. 에 대한 파일 이름을 입력합니다 사용자 지정 에이전트. 에이전트 드롭다운에 표시되는 기본 이름입니다.
  4.        에이전트 프로필 설명, 도구 및 프롬프트를 포함하여 새로 만든 `.agent.md` 파일에서 구성합니다. 
       에이전트 프로필에 포함될 수 있는 항목에 대한 자세한 내용은 [에이전트 프로필 구성하기](#configuring-an-agent-profile)를 참조하세요.
    • 편집기 내에서 도구 구성... 단추를 사용하여 MCP 서버에서 기본 제공 도구 및 도구를 포함하여 사용 가능한 도구를 보고 선택할 수 있는 "도구 구성" 대화 상자를 열 수 있습니다. [확인]을 클릭하여 선택한 도구를 에 추가합니다에이전트 프로필.
    • 에이전트에서 사용하는 AI 모델을 설정하려면 속성을 추가하고 model: 자동 완성 드롭다운에서 원하는 모델을 선택합니다.

업데이트 에이전트 프로필하려면 에이전트 드롭다운에서 사용자 지정 에이전트 구성 을 선택한 다음 목록에서 에이전트를 클릭하여 수정합니다. 사용자 지정 에이전트에 대한 자세한 정보는 VS Code에서 사용자 지정 에이전트VS Code을 참조하십시오.

          사용자 지정 에이전트 JetBrains IDE에서 프로필 만들기

1. GitHub Copilot 채팅 JetBrains IDE에서 창을 엽니다.

  1. 채팅 보기 아래쪽의 에이전트 드롭다운에서 에이전트 구성을 클릭한 다음 설정 창의 "채팅 에이전트"에서 작업 영역을 클릭합니다.
  2. 에 대한 파일 이름을 입력합니다 사용자 지정 에이전트. 에이전트 드롭다운에 표시되는 기본 이름입니다.
  3.        `.github/agents` 디렉터리에 있는 새로 만든 `.agent.md` 파일에서 에이전트 프로필을(를) 구성하되, 설명, 도구 및 프롬프트를 포함하십시오. 자세한 정보를 보려면 에이전트 프로필에 포함할 수 있는 것에 대해서 [에이전트 프로필 구성하기](#configuring-an-agent-profile)를 참조하세요.
    • 편집기 내에서 도구 구성... 단추를 사용하여 도구 대화 상자를 열 수 있습니다. 여기서 MCP 서버의 기본 제공 도구 및 도구를 포함하여 사용 가능한 도구를 보고 선택할 수 있습니다. 적용을 클릭하여 선택한 도구를 에 추가합니다에이전트 프로필.
    • 에이전트에서 사용하는 AI 모델을 설정하려면 속성을 추가하고 model: 자동 완성 드롭다운에서 원하는 모델을 선택합니다.

업데이트할 에이전트 프로필을 선택하려면 에이전트 드롭다운에서 사용자 지정 에이전트 구성을 선택한 다음 수정할 에이전트 옆의 를 클릭하십시오.

Eclipse에서 사용자 지정 에이전트 프로필 만들기

  1. Eclipse에서 GitHub Copilot 채팅 창을 엽니다.
  2. 채팅 보기 아래쪽의 에이전트 드롭다운에서 에이전트 구성... 을 클릭한 다음 추가... 를 클릭합니다.
  3. 에 대한 파일 이름을 입력합니다 사용자 지정 에이전트. 에이전트 드롭다운에 표시되는 기본 이름입니다.
  4.        `.github/agents` 디렉터리의 새로 만든 `.agent.md` 파일에서 에이전트 프로필를 구성하고, 설명, 도구 및 프롬프트를 포함합니다. 
       에이전트 프로필에 포함할 수 있는 항목에 대한 자세한 내용은 [에이전트 프로필 구성하기](#configuring-an-agent-profile)를 참조하세요.
    • 편집기 내에서 도구 구성... 단추를 사용하여 MCP 서버에서 기본 제공 도구 및 도구를 포함하여 사용 가능한 도구를 보고 선택할 수 있는 "도구 구성" 대화 상자를 열 수 있습니다. 적용을 클릭하여 선택한 도구를 에 추가합니다에이전트 프로필.
    • 에이전트에서 사용하는 AI 모델을 설정하려면 속성을 추가하고 model: 자동 완성 드롭다운에서 원하는 모델을 선택합니다.

업데이트 에이전트 프로필하려면 에이전트 드롭다운에서 에이전트 구성을 선택한 다음 수정할 에이전트를 선택하고 편집을 클릭합니다.

          사용자 지정 에이전트 Xcode에서 프로필 만들기
  1. Xcode에서 GitHub Copilot 채팅 창을 엽니다.
  2. 채팅 보기 아래쪽의 에이전트 드롭다운에서 에이전트 만들기를 클릭합니다.
  3. 에 대한 파일 이름을 입력합니다 사용자 지정 에이전트. 에이전트 드롭다운에 표시되는 기본 이름입니다.
  4. 새로 생성된 .github/agents 디렉터리의 .agent.md 파일에서 에이전트 프로필를 구성하고, 설명, 도구 및 프롬프트를 포함합니다. 자세한 정보는 에이전트 프로필 구성하기에서 에이전트 프로필에 포함될 수 있는 항목을 참조하세요.
    • 파일 편집기 내에서 에이전트 사용자 지정 단추를 사용하여 대화 상자를 열 수 있습니다. 여기서 에이전트에서 사용할 AI 모델을 선택하고, 사용 가능한 도구(기본 제공 및 MCP 서버 도구 포함)를 선택하고, 전환handoffs할 속성을 구성할 사용자 지정 에이전트 수 있습니다. 적용을 클릭하여 선택한 옵션을 에 추가합니다에이전트 프로필.

에이전트를 업데이트하려면, 에이전트 드롭다운에서 수정하려는 에이전트 옆에 있는 연필 아이콘을 클릭합니다.

          에이전트 프로필 구성하기

          에이전트 프로필 은 이름, 설명, 사용 가능한 도구 및 MCP 서버 구성을 지정사용자 지정 에이전트하는 YAML 프런트매터가 있는 Markdown 파일입니다. 구성에는 에이전트 프로필 에이전트의 ID, 기능, 도구 액세스 및 동작 지침을 정의하는 작업이 포함됩니다.

YAML 속성, 도구, MCP 서버 설정, 도구 별칭 및 처리 방법에 사용자 지정 에이전트 대한 자세한 구성 정보는 사용자 지정 에이전트 구성을 참조하세요.

구성을 하려면 다음을 수행하세요.에이전트 프로필

  1. 필요에 따라 사용자 지정 에이전트에 대한 name를 작성하세요. 설정되지 않은 경우 이름은 기본적으로 파일 이름(또는 .md 접미사 없음.agent.md)으로 설정됩니다.
  2. 에이전트가 수행하는 작업과 특정 기능 또는 도메인 전문 지식을 설명하는 간단한 description (필수) 작성
  3. 속성에서 tools 에이전트가 사용할 수 있는 도구를 정의합니다. 리포지토리 설정 또는 에이전트 프로필에 구성된 MCP 서버의 도구(예: tools: ["read", "edit", "search", "some-mcp-server/tool-1"])를 포함하는 도구 이름 및 별칭 목록입니다. 이 속성을 제하면 에이전트가 사용 가능한 모든 도구에 접근합니다. 사용자 지정 에이전트 구성에서 "도구"를 참조하세요.
  4. 필요에 따라 속성에서 mcp-servers 이 에이전트에서만 사용할 수 있는 MCP 서버를 구성하여 기능을 확장할 수 있습니다. 사용자 지정 에이전트 구성에서 "MCP 서버 구성 세부 정보"를 참조하세요.
  5. JetBrains IDE, Eclipse 또는 Xcode에서 에이전트 프로필를 만들고 사용하는 경우, 에이전트가 사용할 AI 모델을 제어하기 위해 model 속성을 사용할 수 있습니다.
  6. 필요에 따라 특정 환경에서만 에이전트를 사용하려는 경우 target 속성을 vscode 또는 github-copilot 설정합니다. 속성을 생략하면 두 환경에서 에이전트를 사용할 수 있습니다.
  7. 에이전트의 프롬프트를 작성합니다. YAML 프런트매터 아래의 Markdown 콘텐츠에서 에이전트의 동작, 전문 지식 및 지침을 정의합니다. 프롬프트는 최대 30,000자일 수 있습니다.

예제 에이전트 프로필

다음 예제에서는 테스트를 작성하거나 프로젝트 구현을 계획하는 일반적인 작업에 대해 에이전트 프로필가 어떻게 나타날 수 있는지를 보여줍니다. 추가 영감을 얻으려면 맞춤화 라이브러리의 사용자 지정 에이전트 예제를 참조하세요. awesome-copilot 커뮤니티 컬렉션에서 보다 구체적인 예제를 찾을 수 있습니다.

테스트 전문가

이 예제에서는 속성을 생략 tools 하여 모든 도구를 사용하도록 설정합니다.

Text
---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---

You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:

- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested

Always include clear test descriptions and use appropriate testing patterns for the language and framework.

구현 플래너

이 예제에서는 도구의 하위 집합만 사용하도록 설정합니다.

Text
---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---

You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:

- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow

Always structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.


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

          사용자 지정 에이전트를 만든 후, Copilot 클라우드 에이전트를 사용할 수 있는 모든 곳에서 사용할 수 있습니다.
  • 기본 클라우드 에이전트 대신 사용자 지정 에이전트를 선택하려면, 에이전트 패널이나 에이전트 탭의 드롭다운 메뉴에서 Copilot 클라우드 에이전트에 작업을 지정할 때 사용하세요GitHub.com.
  • 문제에 Copilot 클라우드 에이전트를 할당할 때, 드롭다운 메뉴에서 사용자 지정 에이전트을 선택하면, 당신의 전문화된 설정으로 문제를 처리할 수 있습니다.
  •         GitHub Copilot 명령 줄 인터페이스 (CLI)을 사용할 때, 슬래시 명령 `/agent`를 사용하거나 프롬프트에서 에이전트를 참조하거나 명령줄 인수를 통해 특정 사용자 지정 에이전트을 선택하여 사용할 수 있습니다. 자세한 내용은 [AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli#use-custom-agents)을(를) 참조하세요.

끌어오기 요청을 열면, 끌어오기 요청 설명에 작업을 완료하는 데 사용된 사용자 지정 에이전트가 기록됩니다.

          Copilot 클라우드 에이전트 사용에 대한 자세한 내용은 [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr)을(를) 참조하세요.


          사용자 지정 에이전트를 IDE에서 사용하기

JetBrains IDE, Eclipse 및 Xcode를 포함하여 에이전트 프로필지원되는 IDE에서 직접 사용자 지정 Visual Studio Code 을 사용할 수도 있습니다. 채팅 창에서 에이전트 드롭다운 사용 간에 사용자 지정 에이전트 전환하여 계획, 코드 편집 또는 연구와 같은 다양한 작업에 대한 특수 구성에 액세스할 수 있습니다.

일부 속성은 GitHub.com 환경과 IDE 환경 간에 다르게 작동하거나 무시될 수 있습니다. 지원되는 속성에 대한 자세한 내용은 사용자 지정 에이전트 구성을 참조하세요.

자세한 내용은 사용자 지정 에이전트의 VS Code와 관련하여 VS Code 설명서에서 사용자 지정 에이전트을(를) VS Code 참조하세요.

다음 단계