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

Введение

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

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

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

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

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

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

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

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

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

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

   •      **Пользователь** (`~/.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 в интерактивный режим и выберите из списка доступных Пользовательские агенты. Затем введите запрос, который будет передан выбранному агенту.

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

  Скажите 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/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference)
  

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