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

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

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

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

이 기사에서

          사용자 지정 에이전트 를 사용하면 Copilot의 전문성을 특정 작업에 맞게 조정할 수 있습니다. 개념적 개요는 사용자 지정 에이전트[AUTOTITLE](/copilot/concepts/agents/cloud-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. 조직 또는 엔터프라이즈 수준 사용자 지정 에이전트을(를) 만드는 경우, 템플릿을 루트 .github/ 디렉터리로 이동하려면 파일 경로의 agents 부분을 삭제합니다.

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

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

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

          에이전트 프로필 구성하기

에이전트 프로필 은 이름, 설명, 사용 가능한 도구 및 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 모델을 제어하기 위해 VS Code 속성을 사용할 수 있습니다.
  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을 선택하여 사용할 수 있습니다. 자세한 내용은 GitHub Copilot CLI 사용을(를) 참조하세요.

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

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

다음 단계