사용자 지정 에이전트 에 대하여
사용자 지정 에이전트는 Copilot 에이전트의 특화된 버전으로, 귀하의 고유한 워크플로, 코딩 규칙, 사용 사례에 맞게 맞춤 설정할 수 있습니다. 표준을 따르고, 올바른 도구를 사용하고, 팀별 사례를 구현하는 맞춤형 팀원처럼 작동합니다. 동일한 지침과 컨텍스트를 반복적으로 제공하는 대신 이러한 에이전트를 한 번 정의합니다.
에이전트 프로필라는 Markdown 파일을 사용하여 사용자 지정 에이전트를 정의합니다. 이러한 파일은 프롬프트, 도구 및 MCP 서버를 지정합니다. 이렇게 하면 규칙, 프레임워크 및 원하는 결과를 Copilot로 직접 인코딩할 수 있습니다.
에이전트 프로필는 사용자 지정 에이전트의 동작을 정의합니다. 태스크 또는 문제에 에이전트를 할당하면 사용자 지정 에이전트가 인스턴스화됩니다.
에이전트 프로필 형식
에이전트 프로필는 YAML 프론트매터가 있는 Markdown 파일입니다. 가장 간단한 형식으로 다음을 포함합니다.
-
**이름**: 사용자 지정 에이전트의 고유 식별자입니다. -
**설명**: 에이전트의 용도 및 기능을 설명합니다. -
**프롬프트**: 에이전트의 동작 및 전문 지식을 정의하는 사용자 지정 지침입니다. -
** 도구**(선택 사항): 에이전트가 access 수 있는 특정 도구입니다. 기본적으로 에이전트는 기본 제공 도구 및 MCP 서버 도구를 포함하여 사용 가능한 모든 도구를 access 수 있습니다.
MCP 서버 구성은 에이전트 프로필에 mcp-server 속성을 통해 포함시킬 수 있습니다.
예제 에이전트 프로필
이 예제는 이름, 설명 및 프롬프트가 구성된 기본 에이전트 프로필입니다.
---
name: readme-creator
description: Agent specializing in creating and improving README files
---
You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.
Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images
사용자 지정 에이전트을(를) 구성할 수 있는 위치
다른 수준에서 에이전트 프로필를 정의할 수 있습니다.
-
**리포지토리 수준**: 프로젝트별 에이전트를 위한 리포지토리에 `.github/agents/CUSTOM-AGENT-NAME.md`을 만듭니다. -
** 구성 또는 엔터프라이즈 수준**: 더 광범위한 가용성을 위해 `/agents/CUSTOM-AGENT-NAME.md` 리포지토리에 `.github-private` 만듭니다.
자세한 내용은 조직에서 사용자 지정 에이전트 사용 준비 및 엔터프라이즈에서 사용자 지정 에이전트 사용 준비을(를) 참조하세요.
사용자 지정 에이전트를 사용 가능한 위치
참고
사용자 지정 에이전트은(는) JetBrains IDE, Eclipse 및 Xcode의 경우 공개 미리 보기에 있으며 변경될 수 있습니다.
사용자 지정 에이전트을(를) 만들면 다음과 같이 사용할 수 있게 됩니다.
-
**Copilot 코딩 도우미를 GitHub.com에서 사용할 경우**: 에이전트 탭과 패널, 이슈 할당, 그리고 풀 리퀘스트에서 가능합니다. -
**Copilot 코딩 도우미 IDE에서**: Visual Studio Code, JetBrains IDE, Eclipse 및 Xcode -
**GitHub Copilot 명령 줄 인터페이스 (CLI)**
에이전트 프로필를 Visual Studio Code, JetBrains IDE, Eclipse 및 Xcode에서 직접 사용할 수 있습니다. 일부 속성은 다르게 작동하거나 환경 간에 무시될 수 있습니다.
Visual Studio Code에서 사용자 지정 에이전트를 사용하는 방법에 대한 자세한 내용을 보려면 VS Code의 사용자 지정 에이전트를 참조하세요.
다음 단계
나만의 사용자 지정 에이전트를 만들려면 다음을 참조하세요.
-
[AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents) -
[AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)