{"meta":{"title":"사용자 지정 에이전트 정보","intro":"Custom agents 필요에 맞게 조정된 지원을 향상시킵니다 Copilot .","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/concepts","title":"개념"},{"href":"/ko/copilot/concepts/agents","title":"배포"},{"href":"/ko/copilot/concepts/agents/cloud-agent","title":"Cloud agent"},{"href":"/ko/copilot/concepts/agents/cloud-agent/about-custom-agents","title":"사용자 지정 에이전트"}],"documentType":"article"},"body":"# 사용자 지정 에이전트 정보\n\nCustom agents 필요에 맞게 조정된 지원을 향상시킵니다 Copilot .\n\n## custom agents 정보\n\nCustom agents 은 고유한 워크플로, 코딩 규칙 및 사용 사례에 맞게 조정할 수 있는 에이전트의 Copilot 특수 버전입니다. 표준을 따르고, 올바른 도구를 사용하고, 팀별 사례를 구현하는 맞춤형 팀원처럼 작동합니다. 동일한 지침과 컨텍스트를 반복적으로 제공하는 대신 이러한 에이전트를 한 번 정의합니다.\n\nYou define custom agents 를 agent profiles 라는 Markdown 파일을 사용하여 정의합니다. 이러한 파일은 프롬프트, 도구 및 MCP 서버를 지정합니다. 이렇게 하면 규칙, 프레임워크 및 원하는 결과를 직접 인코딩할 Copilot수 있습니다.\n\nagent profile는 custom agent의 동작을 정의합니다. 작업 또는 문제에 에이전트를 할당하면 custom agent가 인스턴스화됩니다.\n\n## Agent profile 형식\n\nAgent profiles 는 YAML 프런트매터가 있는 Markdown 파일입니다. 가장 간단한 형식으로 다음을 포함합니다.\n\n* **이름** (선택 사항): 에 대한 custom agent표시 이름입니다. 생략하면 에이전트의 파일 이름이 식별자 및 기본 표시 이름으로 사용됩니다.\n* **설명**: 에이전트의 용도 및 기능을 설명합니다.\n* **프롬프트**: 에이전트의 동작 및 전문 지식을 정의하는 사용자 지정 지침입니다.\n* **도구** (선택 사항): 에이전트가 액세스할 수 있는 특정 도구입니다. 기본적으로 에이전트는 기본 제공 도구 및 MCP 서버 도구를 포함하여 사용 가능한 모든 도구에 액세스할 수 있습니다.\n\nAgent profiles 는 `mcp-servers` 속성을 사용하여 MCP 서버 구성을 포함할 수 있습니다.\n\n### 예제 agent profile\n\n이 예제는 이름, 설명 및 프롬프트가 구성된 기본 agent profile 예제입니다.\n\n```text\n---\nname: readme-creator\ndescription: Agent specializing in creating and improving README files\n---\n\nYou 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.\n\nFocus on the following instructions:\n- Create and update README.md files with clear project descriptions\n- Structure README sections logically: overview, installation, usage, contributing\n- Write scannable content with proper headings and formatting\n- Add appropriate badges, links, and navigation elements\n- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository\n- Make links descriptive and add alt text to images\n```\n\n## 구성할 수 있는 위치 custom agents\n\n다음과 같은 다양한 수준에서 정의 agent profiles 할 수 있습니다.\n\n* **리포지토리 수준**: 프로젝트별 에이전트를 위해 리포지토리에서 `.github/agents/CUSTOM-AGENT-NAME.md` 생성합니다.\n* **조직 수준**: 조직 내의 광범위한 가용성을 위해 조직 `/agents/CUSTOM-AGENT-NAME.md` 또는 `.github` 리포지토리에서 만듭니 `.github-private` 다.\n* **엔터프라이즈 수준**: 엔터프라이즈 소유자가 엔터프라이즈의 모든 리포지토리에서 가용성을 위해 엔터프라이즈 설정에서 지정한 조직의 리포지토리에서 만듭니 `/agents/CUSTOM-AGENT-NAME.md``.github-private` 다.\n\n자세한 내용은 [조직에서 사용자 지정 에이전트 사용 준비](/ko/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents) 및 [엔터프라이즈에서 사용자 지정 에이전트 사용 준비](/ko/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents)을(를) 참조하세요.\n\n## custom agents를 사용할 수 있는 곳\n\n> \\[!NOTE]\n> Custom agents은(는) JetBrains IDE, Eclipse 및 Xcode의 경우 공개 미리 보기에 있으며 변경될 수 있습니다.\n\ncustom agents을(를) 생성하면 다음 사항들을 사용할 수 있게 됩니다.\n\n* GitHub.com의 \\*\\*\\*\\*: 에이전트 탭 및 패널, 문제 할당, 끌어오기 요청\n* Copilot cloud agent: \\*\\*\\*\\*, JetBrains IDEs, Eclipse, Xcode의 Visual Studio Code\n* **GitHub Copilot CLI**\n\nagent profiles을(를) Visual Studio Code, JetBrains IDE, Eclipse 및 Xcode에서 직접 사용할 수 있습니다. 일부 속성은 다르게 작동하거나 환경 간에 무시될 수 있습니다.\n\n사용 방법에 대한 자세한 내용은 custom agents의 Visual Studio Code에서 [Custom agentsVS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents)를 참조하세요.\n\n## 다음 단계\n\n직접 custom agents만들려면 다음을 참조하세요.\n\n* [에 대한 사용자 지정 에이전트 만들기 Copilot cloud agent](/ko/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)\n* [사용자 지정 에이전트 만들기 및 사용 GitHub Copilot CLI](/ko/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)\n* [Copilot 사용자 지정 참고 자료](/ko/copilot/reference/customization-cheat-sheet)"}