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

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

В этой статье

Введение

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

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

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

Дополнительные сведения см. в разделе О пользовательских агентах.

Создание Пользовательский агент

Каждый Пользовательский агент определяется файлом Markdown с .agent.md расширением. Вы можете создать эти файлы самостоятельно или добавить их внутри CLI, как описано в следующих шагах.

  1. В интерактивном режиме введите /agent.

  2. Выберите «Создать нового агента » из списка опций.

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

    •      **Проект** (`.github/agents/`)

    •      **Пользователь** (`~/.config/copilot/agents/`)

    Примечание.

    Если у вас есть Пользовательские агенты с одинаковым именем в обоих местах, будет использоваться тот, что в вашем домашнем каталоге, а не тот, что в репозитории.

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

           **Вариант 1: использовать Copilot**

    Введите данные агента, которого хотите создать. Опишите экспертизу агента и когда его следует использовать. Copilot возьмёт введённое вами описание и использует его для создания профиля агента.

    Например, можно ввести следующее:

    I am a security expert. I check code files thoroughly for potential security issues. Use me whenever a security review/check/audit is requested for one or more code files, or when the word "seccheck" is used in a prompt in reference to code files.

I will identify potential problems, such as code that:

- Exposes secrets or credentials
- Allows cross-site scripting
- Allows SQL injection
- Contains vulnerable dependencies
- Allows authentication to be bypassed

If any problems are identified, create a single GitHub issue in this repository on GitHub.com with details of problems, giving full details of each issue, including, but not limited to, risk level and recommended fix.

    После завершения формирования начального профиля агента Copilot отображаются следующие опции:

    • Продолжить
    • Просмотр содержимого
    • Повторите попытку
    • Quit

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

    Чтобы завершить процесс создания, выберите «Продолжить».

           **Вариант 2: Создать профиль агента вручную**

    Когда вы решите создать файл агента самостоятельно, вас проведут через ряд запросов, чтобы заполнить необходимую информацию для создания профиля агента.

    1. Введите имя агента. Имя, которое вы вводите, — это имя, которое отображается при перечислении доступных агентов. Версия этого файла будет использоваться как имя файла агента — например, если вы введёте «Security expert», файл агента будет называться security-expert.agent.md.

      Совет

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

    2. Введите описание, в котором указано, какой экспертизой обладает этот агент и когда его следует использовать.

    3. Введите инструкции о том, как должен вести себя агент, включая конкретные рекомендации, действия или ограничения, которым следует следовать.

  5. Выберите инструменты, к которым ваш Пользовательский агент должен иметь доступ.

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

  6. Перезагрузите CLI, чтобы загрузить новый Пользовательский агент.

Используя Пользовательский агент

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

  •         **Команда Slash**

    Войдите /agent в интерактивный режим и выберите из списка доступных Пользовательские агенты. Затем введите запрос, который будет передан выбранному агенту.

    Примечание.

    Стандартные агенты CLI не включены в этот список. Для получения дополнительной информации о стандартных агентах см. Использование интерфейса командной строки GitHub Copilot.

  •         **Явная инструкция**

    Скажите Copilot использовать конкретный агент. Рассмотрим пример.

    Use the security-auditor agent on all files in the /src/app directory

  •         **По выводу**

    Используйте подсказку, которая запускает использование конкретного агента на основе описания в файле агента. Рассмотрим пример.

    Check all TypeScript files in or under the src directory for potential security problems

    или (где «seccheck» определяется как триггерное слово в профиле агента):

    seccheck /src/app/validator.go

    Copilot автоматически определит агента, которого вы хотите использовать.

  •         **Программно**

    Укажите Пользовательский агент, которое хотите использовать в командной строке. Рассмотрим пример.

    copilot --agent security-auditor --prompt "Check /src/app/validator.go"

    Где security-auditor — имя файла профиля Пользовательский агент без .agent.md расширения. Обычно, но не обязательно, это совпадает с name значением в профиле агента.

Дополнительные материалы

  •         [AUTOTITLE](/copilot/concepts/agents/copilot-cli/comparing-cli-features)

  •         [AUTOTITLE](/copilot/reference/custom-agents-configuration)

  •         [AUTOTITLE](/copilot/tutorials/customization-library/custom-agents) — тщательно подобранная коллекция примеров