Использование облачного агента Copilot на GitHub

Начинайте Copilot облачный агент сессии напрямую на GitHub, затем повторяйте результаты, не выходя из браузера.

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

Copilot облачный агент доступна для всех платных Copilot планов.

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

В этой статье

Introduction

Вы можете начинать Copilot облачный агент сессии с нескольких позиций на GitHub. После запуска сессии вы можете отслеживать её ход, направлять с помощью последующих подсказок и итерировать полученный pull request — и всё это без выхода из браузера.

Дополнительные сведения см. в Copilot облачный агентразделе О облачном агенте GitHub Copilot.

Начало сессии со вкладки или панели агентов

Вы можете начинать сессии со вкладки агентов и панели агентов. Единственное отличие — это точка входа: как только вы видите форму «Задача нового агента», шаги остаются прежними.

  1. Откройте панель или вкладку агентов:

    • Откройте вкладку в репозитории.
    • Перейдите на страницу агентов: перейдите к github.com/copilot/agents. Вы также можете получить здесь, открыв панель агентов, а затем щелкнув "Просмотреть все".
    • Откройте панель агентов: щелкните в панели навигации в правом верхнем углу GitHub.

  2. Используя выпадающее меню в поле запросов, выберите репозиторий, в котором хотите Copilot работать.

  3. Введите запрос, описывающий запрос. Вы также можете добавить визуальные вводы, такие как скриншоты или макеты интерфейса, вставляя, перетаскивая или загружая изображение. Поддерживаемые файлы: image/png, image/jpeg, image/gif, image/webp.

    Например: Implement a user friendly message for common errors.

    Если хотите Copilot открыть pull request, можете, например, спросить в своём prompt Open a pull request to implement a user friendly message for common errors.

  4. По желанию выберите базовую ветвь для Copilotизменений . Copilot создам новую ветку на базе этой ветки.

  5. По желанию, вы можете кликнуть , чтобы открыть выпадающее меню агента, если хотите назначить агента или Пользовательский агент агента со специализированным поведением и инструментами. Вы можете выбрать существующий Пользовательский агент из вашего репозитория, организации или предприятия. Вы также можете нажать «Создать агент», чтобы создать новый Профиль агента файл в выбранном репозитории и ветке. Дополнительные сведения см. в разделе Создание кастомных агентов для Copilot облачный агент.

    Примечание.

    Сторонние агенты доступны во всех платных Copilot планах.

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

  7. Нажмите или нажмите Enter.

Copilot начнёт новую сессию, которая появится в списке под окном с подсказками. Copilot Буду работать над задачей и отправлять любые изменения в коде.

Вы можете отслеживать Copilotработу и открывать pull request одним кликом из журналов сессии. Дополнительные сведения см. в разделе [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).

Запуск сессии с панели управления

Вы можете попросить Copilot начать работу в поле запросов на панели управления. Панель управления — это ваш персонализированный обзор вашей активности на GitHub, который вы видите при посещении https://github.com во время входа в систему.

  1. Перейдите на панель управления по координатам https://github.com.

  2. Нажмите кнопку «Задача».

  3. Используя выпадающее меню в поле запросов, выберите репозиторий, в котором хотите Copilot работать.

  4. Введите запрос, описывающий запрос.

    Например: Implement a user friendly message for common errors.

    Если хотите Copilot открыть pull request, можете, например, спросить в своём prompt Open a pull request to implement a user friendly message for common errors.

  5. По желанию выберите базовую ветку для Copilotpull request. Copilot создам новую ветку на базе этой ветки.

  6. По желанию, вы можете кликнуть , чтобы открыть выпадающее меню агента, если хотите назначить агента или Пользовательский агент агента со специализированным поведением и инструментами. Вы можете выбрать существующий Пользовательский агент из вашего репозитория, организации или предприятия. Вы также можете нажать «Создать агент», чтобы создать новый Профиль агента файл в выбранном репозитории и ветке. Дополнительные сведения см. в разделе Создание кастомных агентов для Copilot облачный агент.

    Примечание.

    Сторонние агенты доступны во всех платных Copilot планах.

  7. Нажмите «Отправить сейчас» или «Вернуть».

    Вас переведут на вкладку агентов, где Copilot начнётся новая сессия, которая появится в списке «Недавние сессии» под окном с подсказками. Copilot Буду работать над задачей и отправлять любые изменения в коде.

    Примечание.

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

Начиная с Copilot Chat

  1. Откройте Чат GitHub Copilot .GitHub.com

  2. Напишите /task запрос Copilot на создание pull-запроса и расскажите, что хотите Copilot изменить.

    Например: /task Create a pull request to put backticks around file names and variables in output.

  3. По желанию выберите базовую ветку для Copilotpull request. Copilot создаёт новую ветку на основе этой ветки, а затем отправляет изменения в pull-запрос, ориентированный на эту ветку.

  4. По желанию, вы можете кликнуть , чтобы открыть выпадающее меню агента, если хотите назначить агента или Пользовательский агент агента со специализированным поведением и инструментами. Вы можете выбрать существующий Пользовательский агент из вашего репозитория, организации или предприятия. Вы также можете нажать «Создать агент», чтобы создать новый Профиль агента файл в выбранном репозитории и ветке. Дополнительные сведения см. в разделе Создание кастомных агентов для Copilot облачный агент.

    Примечание.

    Сторонние агенты доступны во всех платных Copilot планах.

  5. Нажмите или нажмите Enter.

Copilot начнёт новую сессию, которая появится в списке под окном с подсказками. Copilot Будет работать над задачей и внести изменения в её pull-запрос, а после завершения добавлю вас в качестве рецензента, что вызовет уведомление.

Назначение проблемы Copilot

Вы можете попросить Copilot начать работу над проблемой, назначив её на Copilot. Copilot Начнём работать над задачей, создам pull request, а затем запросить у вас повторение, когда всё будет готово.

Примечание.

Эта функция уже присутствует Публичный предварительный просмотр и может измениться.

  1. На GitHubперейдите на главную страницу репозитория.

  2. В поле имени репозитория щелкните Issues.

    Снимок экрана: главная страница репозитория. На горизонтальной панели навигации вкладка с меткой "Проблемы" выделена темно-оранжевым цветом.

  3. Откройте задачу, которую хотите назначить на Copilot.

  4. В меню справа нажмите Кому назначено.

    Снимок экрана: правая боковая панель проблемы. Заголовок, помеченный как "Назначаемые", описывается в темно-оранжевый цвет.

  5. Нажмите Copilot из списка назначенных.

    Снимок экрана: окно "Назначаемы" в проблеме. Copilot доступен в списке.

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

    Скриншот диалога «Assign to Copilot», показывающий опции для целевого репозитория, начальной ветки, Пользовательский агент и дополнительные инструкции.

  6. В поле Optional prompt вы можете добавить конкретные рекомендации по Copilot. Добавьте контекст, ограничения или конкретные требования, которые помогут Copilot понять и выполнить задачу.

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

    В дополнение к деталям, которые вы здесь предоставите, Copilot буду использовать любые пользовательские инструкции, настроенные для целевого репозитория. См . раздел AUTOTITLE.

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

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

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

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

    Совет

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

  8. По желанию, вы можете кликнуть , чтобы открыть выпадающее меню агента, если хотите назначить агента или Пользовательский агент агента со специализированным поведением и инструментами. Вы можете выбрать существующий Пользовательский агент из вашего репозитория, организации или предприятия. Вы также можете нажать «Создать агент», чтобы создать новый Профиль агента файл в выбранном репозитории и ветке. Дополнительные сведения см. в разделе Создание кастомных агентов для Copilot облачный агент.

    Примечание.

    Сторонние агенты доступны во всех платных Copilot планах.

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

Вы также можете назначить задачи Copilot из других источников по адресу GitHub.com:

  • Из списка выпусков на странице Issues репозитория****.
  • При просмотре проблемы в GitHubПроекты.

Засеяване нового репозитория

При создании нового репозитория вы можете попросить Copilot заседать новый репозиторий, введя запрос.

  1. В правом верхнем углу любой страницы выберите , а затем нажмите кнопку "Создать репозиторий".

    Снимок экрана: раскрывающееся меню GitHub с параметрами создания новых элементов. Пункт меню "Новый репозиторий" описан в темно-оранжевый.

  2. Используйте раскрывающееся меню "Владелец"**, **чтобы выбрать учетную запись, которую вы хотите владеть репозиторием.

    Снимок экрана: меню владельца для нового репозитория GitHub. В меню показаны два параметра, октокат и github.

  3. В поле Prompt введите запрос, описывающий, что вы хотите Copilot построить.

    Например, Create a Rust CLI for converting CSV spreadsheets to Markdown1. Щелкните Создать репозиторий.

Copilot сразу же откроет черновой pull request. Copilot Будет работать над задачей и внести изменения в её pull-запрос, а после завершения добавлю вас в качестве рецензента, что вызовет уведомление.

Исправление GitHub Actions неудачного запуска рабочего процесса

Примечание.

Эта функция доступна Copilot Business только для пользователей.Копилот Энтерпрайз

Когда GitHub Actions запуск рабочего процесса на ветке pull request-запросов не выходит, вы можете попросить Copilot проверить и исправить этот сбой.

  1. На , перейдите GitHubна страницу задания, выполненного неудачным рабочим процессом.

  2. Нажмите кнопку «Исправить с помощью Copilot ».

Copilot Начнём новую сессию, выясню причину сбоя и отправлю исправление в вашу ветку.

Продолжение работы над pull request

Вы можете упомянуть @copilot в комментариях к любому pull-request, чтобы попросить Copilot внести изменения. Это работает с пулл-заявками, созданными Copilot вами или другими.

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

Проверяйте комментарии по пакету, а не отправляйте их по отдельности. При отправке комментария к pull-requestу (не обзора или обзора) через GitHub веб-интерфейс выберите модель с помощью picker-модели. Copilot по умолчанию использует модель исходного pull request.

Copilot Отвечает только на комментарии людей, имеющих доступ к репозиторию для записи.

Когда Copilot начинается новая сессия в ответ на ваш комментарий, в комментарии появляется реакция с эмодзи глаз (👀). В таймлайне pull request появляется событие «Copilot has started work».

Скриншот таймлайна pull request с комментарием к обзору, реакцией глаз и событием «Copilot начал работу».

Copilot Запоминает контекст предыдущих сессий по тому же pull-запросу, поэтому последующие запросы быстрее и надёжнее. Если pull request был создан , Пользовательский агентупоминание @copilot продолжается с использованием того же агента.

Разрешение конфликтов слияния

Вы можете попросить Copilot разрешение конфликтов слияния в пулл-запросе двумя способами:

  • Использование кнопки «Fix with » (Fix with Copilot» — если pull request вызывает конфликты слияния, нажмите кнопку Fix with Copilot , которая появляется в поле слияния.
  • Использование @copilot упоминания: упомяните @copilot в комментарии к pull request и попросите его исправить конфликты — например, «@copilot разрешить конфликты слияния в этом PR».

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

Управление GitHub Actions запусками рабочих процессов

По умолчанию GitHub Actions рабочие процессы не запускаются автоматически при Copilot внесении изменений в pull-запрос.

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

Чтобы разрешить GitHub Actions запуск рабочих процессов, нажмите кнопку «Одобрить» и запустить рабочие процессы в окне слияния pull-запроса.

Скриншот окна слияния в pull-запросе от Copilot с кнопкой «Approve and Run workflows».

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

Обратная связь по Copilotработе '

Используйте кнопки обратной связи на Copilotpull-запросах и комментариях для оценки результата. Ваша обратная связь помогает улучшить Copilotкачество.

  1. При pull request-запросе или комментарии Copilotот , нажмите на кнопку «thumbs up» (👍) или «thumbs down (👎).
  2. Если нажать кнопку «палец вниз», по желанию выбрать причину и оставить комментарий, затем нажмите «Отправить отзыв».

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