Создание пользовательских агентов для Агент кодирования Copilot

Вы можете создавать специализированных агентов с индивидуальными знаниями и опытом для конкретных задач разработки.

Кто может использовать эту функцию?

Агент кодирования Copilot доступен с планами GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Бизнес и GitHub Copilot Энтерпрайз. Агент доступен во всех репозиториях, хранящихся на GitHub, за исключением репозиториев, принадлежащих управляемые учетные записи пользователей и где он был явно отключен.
Sign up for Copilot

В этой статье

Пользовательские агенты позволяет адаптировать экспертизу Copilot для конкретных задач. Для концептуального обзора Пользовательские агенты см. AUTOTITLE.

Примечание.

Пользовательские агенты находятся в public preview для IDEs JetBrains, Eclipse и Xcode и могут измениться.

Создание профиля Пользовательский агент в репозитории на GitHub

  1. Перейдите на вкладку агентов по адресу https://github.com/copilot/agents.

  2. С помощью раскрывающегося меню в окне приглашения выберите репозиторий, в котором вы хотите создать профиль Пользовательский агент.

    Примечание.

    Владельцы организаций и предприятий могут создавать организационные и корпоративные данные Пользовательские агенты в репозитории .github-private, доступных во всех репозиториях их организации или предприятия. Дополнительные сведения см. в разделе [AUTOTITLE и Подготовка к использованию пользовательских агентов на предприятии](/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents).

  3. При необходимости выберите ветвь, в которой вы хотите создать Профиль агента. По умолчанию используется ветка main.

  4. Нажмите , затем нажмите Создать агента. Это откроет профиль агента шаблона под названием my-agent.agent.md в каталоге .github/agents вашего целевого репозитория.

  5. Если вы создаёте организационный или корпоративный уровень Пользовательский агент, удалите часть пути файла .github/, чтобы переместить шаблон в корневую директорию agents.

  6. Отредактируйте имя файла (текст перед .agent.md), выбрав уникальное, описательное имя, которое идентифицирует цель агента. Обратите внимание, что имя файла может содержать только следующие символы: ., -, _, a-z``A-Z``0-9, .

  7. Настройте Профиль агента, включая имя, описание, инструменты и подсказки. Для получения дополнительной информации о том, что может включать Профиль агента, см. Конфигурирование Профиль агента.

  8. Зафиксируйте файл в репозитории и объедините его в ветвь по умолчанию. Go back на вкладку агентов и обновите страницу при необходимости. Ваш Пользовательский агент теперь появится в выпадающем списке, когда вы нажмёте в окне подсказок.

Создание профиля Пользовательский агент в Visual Studio Code

  1. Откройте GitHub Copilot Чат в Visual Studio Code.
  2. В выпадающем меню агентов внизу чата нажмите Configure Custom Agents..., затем выберите Создать новые Пользовательский агент.
  3. Выберите место, где должен быть создан Профиль агента: * Workspace: Создайте профиль Пользовательский агент в папке .github/agents вашего рабочего пространства, чтобы использовать его только внутри этого рабочего пространства. * Профиль пользователя: Создайте профиль Пользовательский агент в текущей папке профиля пользователя, чтобы использовать его во всех ваших рабочих пространствах.
  4. Введите имя файла для Пользовательский агент. Это имя по умолчанию, которое отображается в выпадающем меню агентов.
  5. Настройте Профиль агента в новом файле .agent.md , включая описание, инструменты и подсказки. Для получения дополнительной информации о том, что может включать Профиль агента, см. Конфигурирование Профиль агента.
    • Вы можете использовать кнопку Configure Tools... внутри редактора, чтобы открыть диалог «Configure Tools», где можно просматривать и выбирать доступные инструменты, включая встроенные инструменты и инструменты с серверов MCP. Нажмите OK , чтобы добавить выбранные инструменты в Профиль агента.
    • Чтобы определить, какую AI-модель использует агент, добавьте model: свойство и выберите желаемую модель из выпадающего списка автозаполнения.

Чтобы обновить Профиль агента, выберите Configure Custom Agents из выпадающего списка агентов, а затем нажмите на агент из списка, чтобы изменить его. Для получения дополнительной информации о Пользовательские агенты в VS Code см. Пользовательские агенты в VS Code.

Создание профиля Пользовательский агент в IDE JetBrains

  1. Откройте окно GitHub Copilot Чат в вашем IDE JetBrains.
  2. В выпадающем меню агентов внизу чата нажмите Configure Agents..., затем в окне настроек под разделом «Chat Agents» нажмите Workspace.
  3. Введите имя файла для Пользовательский агент. Это имя по умолчанию, которое отображается в выпадающем меню агентов.
  4. Настройте Профиль агента в недавно созданном файле .agent.md в каталоге .github/agents, включая описание, инструменты и запросы. Для получения дополнительной информации о том, что может включать Профиль агента, см. Конфигурирование Профиль агента.
    • Вы можете использовать кнопку Configure Tools... внутри редактора, чтобы открыть диалог инструментов, где можно просматривать и выбирать доступные инструменты, включая встроенные инструменты и инструменты с серверов MCP. Нажмите «Применить», чтобы добавить выбранные инструменты в Профиль агента.
    • Чтобы определить, какую AI-модель использует агент, добавьте model: свойство и выберите желаемую модель из выпадающего списка автозаполнения.

Чтобы обновить Профиль агента, выберите Configure Custom Agents из выпадающего меню агентов и нажмите рядом с нужным агентом.

Создание профиля Пользовательский агент в Eclipse

  1. Откройте окно GitHub Copilot Чат в Eclipse.
  2. Из выпадающего меню агентов внизу чата нажмите Configure Agents..., затем Add....
  3. Введите имя файла для Пользовательский агент. Это имя по умолчанию, которое отображается в выпадающем меню агентов.
  4. Настройте Профиль агента в недавно созданном файле .agent.md в каталоге .github/agents, включая описание, инструменты и запросы. Для получения дополнительной информации о том, что может включать Профиль агента, см. Конфигурирование Профиль агента.
    • Вы можете использовать кнопку Configure Tools... внутри редактора, чтобы открыть диалог «Configure Tools», где можно просматривать и выбирать доступные инструменты, включая встроенные инструменты и инструменты с серверов MCP. Нажмите «Применить», чтобы добавить выбранные инструменты в Профиль агента.
    • Чтобы определить, какую AI-модель использует агент, добавьте model: свойство и выберите желаемую модель из выпадающего списка автозаполнения.

Чтобы обновить Профиль агента, выберите Configure Agents... в выпадающем меню агентов, затем выберите нужный агент и нажмите Edit.

Создание профиля Пользовательский агент в Xcode

  1. Откройте окно GitHub Copilot Чат в Xcode.
  2. В выпадающем меню агентов внизу чата нажмите Создать агента.
  3. Введите имя файла для Пользовательский агент. Это имя по умолчанию, которое отображается в выпадающем меню агентов.
  4. Настройте Профиль агента в недавно созданном файле .agent.md в каталоге .github/agents, включая описание, инструменты и запросы. Для получения дополнительной информации о том, что может включать Профиль агента, см. Конфигурирование Профиль агента.
    • Вы можете использовать кнопку «Customize Agent » в редакторе файлов, чтобы открыть диалоговый диалог, где выбрать AI-модель для агента, выбрать доступные инструменты (включая встроенные и MCP-серверные) и настроить handoffs свойство перехода между Пользовательские агенты. Нажмите «Применить», чтобы добавить выбранные опции в Профиль агента.

Чтобы обновить Профиль агента, из выпадающего меню агентов нажмите на иконку карандаша рядом с нужным агентом.

Настройка Профиль агента

Профиль агента — это файл Markdown с YAML-фронтматтером, который указывает имя, описание, доступные инструменты и конфигурации MCP-сервера Пользовательский агент. Настройка Профиль агентаданных } включает определение идентичности агента, его возможностей, access инструмента и поведенческих инструкций.

Подробную информацию о свойствах YAML, инструментах, настройке сервера MCP, псевдонимах инструментов и способах обработки Пользовательские агенты см. в разделе AUTOTITLE.

Чтобы настроить Профиль агента:

  1. При необходимости напишите a name для вашего Пользовательский агент. Если этот параметр не установлен, по умолчанию будет использоваться имя файла (без суффикса .md or .agent.md ).
  2. Напишите краткое description описание (обязательно) с объяснением того, чем занимается ваш агент, а также его конкретные возможности или опыт в предметной области.
  3. В свойстве tools определите, какие инструменты может использовать агент. Это список имен или псевдонимов инструментов, включая инструменты с серверов MCP, настроенных в настройках репозитория или Профиль агента (например, tools: ["read", "edit", "search", "some-mcp-server/tool-1"]). Если вы исключите это свойство, агент получит access ко всем доступным инструментам. См. раздел «Инструменты» в AUTOTITLE.
  4. Опционально, в mcp-servers этом свойстве можно настроить MCP-серверы, доступные только этому агенту, чтобы расширить его возможности. См. раздел «Детали конфигурации сервера MCP» в AUTOTITLE.
  5. Если вы создаёте и используете Профиль агента в VS Code, JetBrains IDE, Eclipse или Xcode, вы также можете использовать это model свойство для контроля AI-модели, которую должен использовать агент.
  6. По желанию установите свойство target на vscode или github-copilot, если хотите использовать агента только в определённой среде. Агент будет доступен в обеих средах, если вы опустите свойство.
  7. Напишите подсказку агента. Определите поведение, опыт и инструкции агента в содержимом Markdown под внешним элементом YAML. Запрос может составлять максимум 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, используйте выпадающее меню на панели агентов или вкладке агентов, чтобы выбрать свой variables.copilot.copilot_custom_agent_short %данных } вместо агента кодирования по умолчанию.
  • При назначении Агент кодирования Copilot проблеме, вы можете выбрать Пользовательский агент из выпадающего меню, чтобы решить проблему с вашей специализированной конфигурацией.
  • При использовании GitHub Copilot CLI вы можете выбрать определённый Пользовательский агент, используя /agent команду slash или ссылаясь на агента в строке или через аргумент командной строки. Дополнительные сведения см. в разделе Использование GitHub Copilot CLI.

Когда Copilot открывает запросы на вытягивание, он отметит, какой Пользовательский агент был использован для завершения работы в описании запроса на вытягивание.

Для получения дополнительной информации об использовании Агент кодирования Copilot, см. AUTOTITLE.

Использование Пользовательские агенты в вашем IDE

Вы также можете использовать свой собственный Профили агентов напрямую в поддерживаемых IDE, включая Visual Studio Code, IDE JetBrains, Eclipse и Xcode. Вы можете переключаться между Пользовательские агенты через выпадающее меню агента в окне чата, что позволяет access специализированные конфигурации для различных задач, таких как планирование, редактирование кода или исследования.

Обратите внимание, что некоторые свойства могут функционировать иначе или игнорировать между окружениями GitHub.com и IDE. Дополнительные сведения о поддерживаемых свойствах см. в разделе AUTOTITLE.

Для получения дополнительной информации о Пользовательские агенты в VS Code конкретно см. Пользовательские агенты в VS Code в документации VS Code.

Дальнейшие шаги

  • Для практического руководства по созданию вашего первого Пользовательский агент, смотрите AUTOTITLE.
  • Для получения подробной информации о конфигурации см. AUTOTITLE.
  • Сведения об использовании агентов кодирования, включая ваш Пользовательские агенты, для создания запросов на вытягивание, см. в разделе AUTOTITLE.