{"meta":{"title":"에 대한 사용자 지정 에이전트 만들기 Copilot cloud agent","intro":"특정 개발 작업에 대한 맞춤형 전문 지식을 갖춘 전문 에이전트를 만들 수 있습니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/copilot-on-github","title":"Copilot 에 GitHub"},{"href":"/ko/copilot/how-tos/copilot-on-github/customize-copilot","title":"사용자 지정 Copilot"},{"href":"/ko/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent","title":"맞춤 설정 cloud agent"},{"href":"/ko/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents","title":"사용자 지정 에이전트 만들기"}],"documentType":"article"},"body":"# 에 대한 사용자 지정 에이전트 만들기 Copilot cloud agent\n\n특정 개발 작업에 대한 맞춤형 전문 지식을 갖춘 전문 에이전트를 만들 수 있습니다.\n\nCustom agents 를 사용하면 Copilot의 전문성을 특정 작업에 맞게 조정할 수 있습니다. 개념적 개요는 custom agents[사용자 지정 에이전트 정보](/ko/copilot/concepts/agents/cloud-agent/about-custom-agents)을 참조하세요.\n\n> \\[!NOTE]\n> Custom agents은(는) JetBrains IDE, Eclipse 및 Xcode의 경우 공개 미리 보기에 있으며 변경될 수 있습니다.\n\n## 리포지토리에서 custom agent 프로필을 GitHub 생성하기\n\n1. [\n https://github.com/copilot/agents\n ](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text) 에이전트 탭으로 이동합니다.\n\n2. 프롬프트 상자의 드롭다운 메뉴를 사용하여 custom agent 프로필을 만들 리포지토리를 선택합니다.\n\n > \\[!NOTE]\n > 조직 소유자는 조직의 `.github` 또는 `.github-private` 리포지토리에서 조직 내 모든 리포지토리에서 사용할 수 있는 조직 수준의 custom agents를 만들 수 있습니다. 엔터프라이즈 소유자는 엔터프라이즈 설정에서 지정된 조직의 `.github-private` 리포지토리에서 엔터프라이즈 수준의 custom agents를 만들 수 있으며, 이는 엔터프라이즈의 모든 조직에서 사용할 수 있습니다. 자세한 내용은 [조직에서 사용자 지정 에이전트 사용 준비](/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\n3. 옵션으로, agent profile를 만들려는 분기를 선택합니다. 기본값은 메인 브랜치입니다.\n\n4. 를 클릭한 다음 **에이전트 만들기를 클릭합니다**. 그러면 대상 리포지토리의 `my-agent.agent.md` 디렉터리에서 `.github/agents`이라는 템플릿 에이전트 프로필이 열립니다.\n\n5. 조직 또는 엔터프라이즈 수준 custom agent을(를) 만드는 경우, 템플릿을 루트 `.github/` 디렉터리로 이동하려면 파일 경로의 `agents` 부분을 삭제합니다.\n\n6. 에이전트의 용도를 식별하는 고유한 설명이 포함된 이름을 선택하여 파일 이름(이전 `.agent.md`텍스트)을 편집합니다. 파일 이름에는 다음 문자`.`만 포함될 수 있습니다. , , `-``_`, `a-z``A-Z``0-9`.\n\n7. agent profile이름, 설명, 도구 및 프롬프트를 포함하여 구성합니다. 자세한 내용은 agent profile가 포함할 수 있는 항목에 대해 [구성을 agent profile](#configuring-an-agent-profile) 참조하세요.\n\n8. 파일을 리포지토리에 커밋하고 기본 분기에 병합합니다. 에이전트 탭으로 돌아가세요. 필요한 경우 페이지를 새로 고치세요.\n custom agent 프롬프트 상자를 클릭하면 드롭다운에 표시됩니다.\n\n## agent profile 구성하기\n\nagent profile 은 이름, 설명, 사용 가능한 도구 및 MCP 서버 구성을 지정custom agent하는 YAML 프런트매터가 있는 Markdown 파일입니다. 구성에는 agent profile 에이전트의 ID, 기능, 도구 액세스 및 동작 지침을 정의하는 작업이 포함됩니다.\n\nYAML 속성, 도구, MCP 서버 설정, 도구 별칭 및 처리 방법에 custom agents 대한 자세한 구성 정보는 [사용자 지정 에이전트 구성](/ko/copilot/reference/custom-agents-configuration)을 참조하세요.\n\n구성을 하려면 다음을 수행하세요.agent profile\n\n1. 필요에 따라 `name`에 대한 custom agent를 작성하세요. 설정되지 않은 경우 이름은 기본적으로 파일 이름(또는 `.md` 접미사 없음`.agent.md`)으로 설정됩니다.\n2. 에이전트가 수행하는 작업과 특정 기능 또는 도메인 전문 지식을 설명하는 간단한 `description` (필수) 작성\n3. 속성에서 `tools` 에이전트가 사용할 수 있는 도구를 정의합니다. 리포지토리 설정 또는 agent profile에 구성된 MCP 서버의 도구(예: `tools: [\"read\", \"edit\", \"search\", \"some-mcp-server/tool-1\"]`)를 포함하는 도구 이름 및 별칭 목록입니다. 이 속성을 생략하면 에이전트가 사용 가능한 모든 도구에 액세스할 수 있습니다.\n [사용자 지정 에이전트 구성](/ko/copilot/reference/custom-agents-configuration#tools)에서 \"도구\"를 참조하세요.\n4. 필요에 따라 속성에서 `mcp-servers` 이 에이전트에서만 사용할 수 있는 MCP 서버를 구성하여 기능을 확장할 수 있습니다.\n [사용자 지정 에이전트 구성](/ko/copilot/reference/custom-agents-configuration#mcp-server-configuration-details)에서 \"MCP 서버 구성 세부 정보\"를 참조하세요.\n5. JetBrains IDE, Eclipse 또는 Xcode에서 agent profile를 만들고 사용하는 경우, 에이전트가 사용할 AI 모델을 제어하기 위해 VS Code 속성을 사용할 수 있습니다.\n6. 필요에 따라 특정 환경에서만 에이전트를 사용하려면 `target` 속성을 `vscode` 또는 `github-copilot`로 설정하세요. 속성을 생략하면 두 환경에서 에이전트를 사용할 수 있습니다.\n7. 에이전트의 프롬프트를 작성합니다. YAML 프런트매터 아래의 Markdown 콘텐츠에서 에이전트의 동작, 전문 지식 및 지침을 정의합니다. 프롬프트는 최대 30,000자일 수 있습니다.\n\n## 예제 agent profiles\n\n다음 예제에서는 테스트를 작성하거나 프로젝트 구현을 계획하는 일반적인 작업에 대해 agent profile가 어떻게 나타날 수 있는지를 보여줍니다. 추가 영감을 얻으려면 맞춤화 라이브러리의 [Custom agents](/ko/copilot/tutorials/customization-library/custom-agents) 예제를 참조하세요.\n[awesome-copilot](https://github.com/github/awesome-copilot/tree/main/agents) 커뮤니티 컬렉션에서 보다 구체적인 예제를 찾을 수 있습니다.\n\n### 테스트 전문가\n\n이 예제에서는 속성을 생략 `tools` 하여 모든 도구를 사용하도록 설정합니다.\n\n```text copy\n---\nname: test-specialist\ndescription: Focuses on test coverage, quality, and testing best practices without modifying production code\n---\n\nYou are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:\n\n- Analyze existing tests and identify coverage gaps\n- Write unit tests, integration tests, and end-to-end tests following best practices\n- Review test quality and suggest improvements for maintainability\n- Ensure tests are isolated, deterministic, and well-documented\n- Focus only on test files and avoid modifying production code unless specifically requested\n\nAlways include clear test descriptions and use appropriate testing patterns for the language and framework.\n```\n\n### 구현 플래너\n\n이 예제에서는 도구의 하위 집합만 사용하도록 설정합니다.\n\n```text copy\n---\nname: implementation-planner\ndescription: Creates detailed implementation plans and technical specifications in markdown format\ntools: [\"read\", \"search\", \"edit\"]\n---\n\nYou are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:\n\n- Analyze requirements and break them down into actionable tasks\n- Create detailed technical specifications and architecture documentation\n- Generate implementation plans with clear steps, dependencies, and timelines\n- Document API designs, data models, and system interactions\n- Create markdown files with structured plans that development teams can follow\n\nAlways 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.\n```\n\n## custom agents 사용하기\n\ncustom agent를 만든 후, Copilot cloud agent를 사용할 수 있는 모든 곳에서 사용할 수 있습니다.\n\n* Copilot cloud agent에 GitHub.com 관련 작업을 지시할 때는, 에이전트 패널이나 에이전트 탭의 드롭다운 메뉴를 사용하여 기본값인 custom agent 대신 cloud agent를 선택하십시오.\n* 문제에 Copilot cloud agent를 할당할 때, 드롭다운 메뉴에서 custom agent을 선택하면, 당신의 전문화된 설정으로 문제를 처리할 수 있습니다.\n* GitHub Copilot CLI을 사용할 때, 슬래시 명령 custom agent를 사용하거나 프롬프트에서 에이전트를 참조하거나 명령줄 인수를 통해 특정 `/agent`을 선택하여 사용할 수 있습니다. 자세한 내용은 [GitHub Copilot CLI 사용](/ko/copilot/how-tos/copilot-cli/use-copilot-cli/overview#use-custom-agents)을(를) 참조하세요.\n\nCopilot가 풀 리퀘스트를 생성할 때, 해당 작업을 완료하는 데 어떤 custom agent가 사용되었는지를 풀 리퀘스트 설명에 명시할 것입니다.\n\nCopilot cloud agent 사용에 대한 자세한 내용은 [GitHub Copilot 세션 시작](/ko/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)을(를) 참조하세요.\n\n## 다음 단계\n\n* 첫 번째 custom agent를 위한 실습은 [첫 번째 사용자 지정 에이전트](/ko/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent)을 참조하세요.\n* 자세한 구성 정보는 [사용자 지정 에이전트 구성](/ko/copilot/reference/custom-agents-configuration)을 참조하세요.\n* 클라우드 에이전트, 포함하여 custom agents, 사용하여 세션을 시작하는 방법에 대한 자세한 내용은 [GitHub Copilot 세션 시작](/ko/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)를 참조하세요."}