Skip to main content

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

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

О Пользовательские агенты

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

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

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

формат данных variables.copilot.agent_profile_caps %}

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

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

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

Пример Профиль агента

Этот пример представляет собой базовый Профиль агента с настроенным именем, описанием и запросом.

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

Где можно настроить Пользовательские агенты

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

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

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

Где можно использовать Пользовательские агенты

Примечание.

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

После создания Пользовательские агенты они становятся доступны для:

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

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

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

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

Чтобы создать собственный Пользовательские агенты, см.:

  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents)
    
  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)
    
  •         [AUTOTITLE](/copilot/reference/customization-cheat-sheet)