{"meta":{"title":"Создание кастомных агентов для Copilot cloud agent","intro":"Вы можете создавать специализированных агентов с индивидуальными знаниями и опытом для конкретных задач разработки.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/how-tos","title":"Инструкции"},{"href":"/ru/copilot/how-tos/copilot-on-github","title":"Copilot на GitHub"},{"href":"/ru/copilot/how-tos/copilot-on-github/customize-copilot","title":"Кастомизация Copilot"},{"href":"/ru/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent","title":"Кастомизация cloud agent"},{"href":"/ru/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см. [О пользовательских агентах](/ru/copilot/concepts/agents/cloud-agent/about-custom-agents).\n\n> \\[!NOTE]\n> Custom agents находятся в Публичный предварительный просмотр для IDEs JetBrains, Eclipse и Xcode и могут измениться.\n\n## Создание custom agent профиля в репозитории на GitHub\n\n1. Перейдите на вкладку агентов по адресу [https://github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text).\n\n2. Используя выпадающее меню в окне запросов, выберите репозиторий, в котором хотите создать custom agent профиль.\n\n   > \\[!NOTE]\n   > Владельцы организаций могут создавать на уровне custom agents`.github` организации в репозитории организации, `.github-private` доступные во всех репозиториях внутри организации. Владельцы предприятий могут создавать корпоративный custom agents уровень в `.github-private` репозитории организации, назначенной в корпоративных средах, доступной во всех организациях предприятия. Дополнительные сведения см. в разделе \\[AUTOTITLE и [Подготовка к использованию пользовательских агентов в организации](/ru/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents)]\\(/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).\n\n3. По желанию выберите ветку, которую хотите создать agent profile вход. По умолчанию используется ветка main.\n\n4. Нажмите <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"Select a custom agent\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg>, затем **выберите<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"Plus button\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg> Создать агента**. Это откроет профиль агента шаблона под названием `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. Зафиксируйте файл в репозитории и объедините его в ветвь по умолчанию. Go back на вкладку агентов и обновите страницу при необходимости. Теперь вы custom agent появитесь в выпадающем списке, когда вы кликнете <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"copilot\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg> в поле с подсказкой.\n\n## Настройка agent profile\n\nAn agent profile — это файл Markdown с YAML-фронтматией, который указывает custom agentимя, описание, доступные инструменты и конфигурации MCP-серверов. Настройка an agent profile включает определение идентичности агента, его возможностей, доступа к инструменту и поведенческих инструкций.\n\nДля подробной информации о конфигурации YAML-свойств, инструментов, настройки MCP-сервера, псевдонимов инструментов и способах custom agents обработки см. [Настройка пользовательских агентов](/ru/copilot/reference/custom-agents-configuration).\n\nЧтобы настроить ваш agent profile:\n\n1. По желанию напишите a `name` для вашего custom agent. Если этот параметр не установлен, по умолчанию будет использоваться имя файла (без суффикса `.md` or `.agent.md` ).\n2. Напишите краткое `description` описание (обязательно) с объяснением того, чем занимается ваш агент, а также его конкретные возможности или опыт в предметной области.\n3. В свойстве `tools` определите, какие инструменты может использовать агент. Это список имён инструментов или псевдонимов, включая инструменты с MCP-серверов, настроенных в настройках репозитория или agent profile (например, `tools: [\"read\", \"edit\", \"search\", \"some-mcp-server/tool-1\"]`). Если вы исключите это свойство, агент получит access ко всем доступным инструментам. См. раздел «Инструменты» в [AUTOTITLE.](/ru/copilot/reference/custom-agents-configuration#tools)\n4. Опционально, в `mcp-servers` этом свойстве можно настроить MCP-серверы, доступные только этому агенту, чтобы расширить его возможности. См. раздел «Детали конфигурации сервера MCP» в [AUTOTITLE.](/ru/copilot/reference/custom-agents-configuration#mcp-server-configuration-details)\n5. Если вы создаёте и используете agent profile встроенные VS CodeIDE JetBrains, Eclipse или Xcode, вы также можете использовать это `model` свойство, чтобы управлять, какую AI-модель должен использовать агент.\n6. По желанию установите свойство `target` на `vscode` или `github-copilot`, если хотите использовать агента только в определённой среде. Агент будет доступен в обеих средах, если вы опустите свойство.\n7. Напишите подсказку агента. Определите поведение, опыт и инструкции агента в содержимом Markdown под внешним элементом YAML. Запрос может составлять максимум 30 000 символов.\n\n## Пример agent profiles\n\nВ следующих примерах показано, как может выглядеть agent profile для общих задач написания тестов или планирования реализации проекта. Для получения дополнительного вдохновения см. примеры [Custom agents](/ru/copilot/tutorials/customization-library/custom-agents) в библиотеке настройки. Вы также можете найти более конкретные примеры в коллекции сообщества [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\nПосле того как вы создали custom agent, вы можете использовать его где Copilot cloud agent угодно.\n\n* При запросе Copilot cloud agent с включённой GitHub.comзадачей используйте выпадающее меню в панели агентов или вкладке агентов, чтобы выбрать свой custom agent вместо стандартного cloud agent.\n* При назначении Copilot cloud agent задачи вы можете выбрать Your custom agent в выпадающем меню, чтобы решить проблему с вашей специализированной конфигурацией.\n* При использовании GitHub Copilot CLI, вы можете выбрать определённый custom agent пункт, используя `/agent` команду слэш или ссылаясь на агента в строке или через аргумент командной строки. Дополнительные сведения см. в разделе [Использование GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/use-copilot-cli/overview#use-custom-agents).\n\nКогда Copilot открываются pull requests, в описании pull request-запросов указывается, какой custom agent именно был использован для завершения работы.\n\nДополнительные сведения об использовании Copilot cloud agentсм. в разделе [Начало сессий GitHub Copilot](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions).\n\n## Дальнейшие действия\n\n* Для практического обучения по созданию первого custom agentтекста см. [АВТОТИТР](/ru/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent).\n* Для получения подробной информации о конфигурации см. [AUTOTITLE.](/ru/copilot/reference/custom-agents-configuration)\n* Для получения информации об использовании облачных агентов, включая ваш custom agents, для запуска Copilot сессий смотрите [Начало сессий GitHub Copilot](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)."}