О пользовательских агентах

Custom agents Улучшайте Copilot с помощью поддержки, адаптированной к вашим потребностям.

В этой статье

Около custom agents

Custom agents Это специализированные версии Copilot агента, которые вы можете адаптировать под свои уникальные рабочие процессы, нормы кода и сценарии использования. Они действуют как индивидуальные коллеги, которые следуют вашим стандартам, используют правильные инструменты и применяют специфические для команды практики. Вы определяете эти агенты один раз, вместо того чтобы постоянно предоставлять одни и те же инструкции и контекст.

Вы определяете custom agents использование файлов Markdown под названием agent profiles. Эти файлы указывают подсказки, инструменты и MCP-серверы. Это позволяет напрямую кодировать ваши конвенции, фреймворки и желаемые результаты в Copilot.

Определяет agent profilecustom agentповедение '. Когда вы назначаете агента задачу или проблему, он инстанцирует custom agent.

Agent profile формат

Agent profiles — это файлы Markdown с YAML-фронтматтером. В самом простом виде они включают в себя:

  • Имя (по желанию): Отображаемое имя для custom agent. Если оно опущено, имя файла агента используется в качестве идентификатора и отображаемого имени по умолчанию.
  • Описание: Объясняет назначение и возможности агента.
  • Подсказка: Пользовательские инструкции, определяющие поведение и экспертизу агента.
  • Tools (опционально): Конкретные инструменты, которые агент может access. По умолчанию агенты имеют доступ ко всем доступным инструментам, включая встроенные инструменты и MCP-серверные инструменты.

Agent profiles также может включать конфигурации MCP-сервера с использованием этого mcp-servers свойства.

Пример agent profile

Этот пример — базовый agent profile вариант с настраиванием названия, описания и запроса.

---
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

Где можно настроить custom agents

Вы можете определить agent profiles на разных уровнях:

  • уровень репозитория: Создайте .github/agents/CUSTOM-AGENT-NAME.md в своём репозитории для project-специфических агентов.
  • Организационный уровень: Создавайте /agents/CUSTOM-AGENT-NAME.md материалы в .github организации или .github-private в репозитории для более широкой доступности внутри организации.
  • Корпоративный уровень: Создайте /agents/CUSTOM-AGENT-NAME.md в .github-private репозитории организации, которое владелец предприятия определил в корпоративных настройках для доступности во всех репозиториях предприятия.

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

Где можно использовать custom agents

Примечание.

Custom agents находятся в Публичный предварительный просмотр для IDEs JetBrains, Eclipse и Xcode и могут измениться.

После создания custom agentsони становятся доступны для:

  • Copilot cloud agent на GitHub.com: вкладка и панель агентов, назначение выдачи и pull requests
  • Copilot cloud agent в IDE: Visual Studio Code, JetBrains IDE, Eclipse и Xcode
  • GitHub Copilot CLI

Вы можете использовать agent profiles напрямую в Visual Studio CodeIDE JetBrains, Eclipse и Xcode. Некоторые свойства могут функционировать иначе или игнорировать между окружениями.

Для получения дополнительной информации об custom agents использовании в Visual Studio Codeсм. Custom agents в VS Code.

Дальнейшие действия

Чтобы создать свою собственную custom agents, см.: