О автоматизациях Copilot

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

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

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

В этой статье

Overview

С automationsпомощью , можно настроить Copilot облачный агент автоматический запуск — либо по расписанию, либо в ответ на событие в репозитории. Automations Могут действовать внутри репозитория, где они настроены, например, открыть pull request или промаркировать проблему.

При ручном запуске Copilot облачный агент сессии вы даёте Copilot задачу каждый раз, когда хотите выполнить работу. С automations, вы определяете задачу один раз и Copilot запускаете её автоматически, когда срабатывает Автоматизациятриггер '.

Например, вы можете использовать automations :

  • Сортируйте входящие выпуски: автоматически отмечайте новые выпуски как баг, улучшение или что-то подобное в зависимости от их содержания.
  • Каждую ночь исправляйте неудачные тесты: каждую ночь проверяйте на ветке на неудачные тесты main , пытайтесь исправить и открывайте черновой pull request.
  • Готовьте еженедельные заметки к релизу: чертежи заметки и открывайте pull request по расписанию.

Когда вы создаёте Автоматизация, вы определяете:

  • Имя, которое идентифицирует Автоматизация.
  • Задание, описывающее задачу, которую вы хотите Copilot выполнить.
  • Один или несколько триггеров определяют, когда забегают Автоматизация .
  • МодельCopilot использует.
  • ИнструментыCopilot могут использовать, которые управляют, какие действия они могут выполнять в вашем репозитории.

Для инструкций по созданию и управлению automationsсм. Создание автоматизаций с помощью облачного агента Copilot.

Доступность и разрешения

Чтобы automations быть доступным в репозитории, все следующие условия должны быть верны:

  • Репозиторий должен быть приватным или внутренним. Automations недоступны в публичных репозиториях.
  • Copilot облачный агент должно быть включено для репозитория. Если у вас есть Copilot Business или Копилот Энтерпрайз, администратор должен включить эту Copilot облачный агент политику. См . раздел AUTOTITLE.
  • Организация должна разрешить оба Copilot облачный агент варианта и automations в репозитории (оба по умолчанию включены). См . раздел AUTOTITLE.

Automationsдоступны с GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot MaxGitHub Copilot для бизнеса, и GitHub Copilot Enterprise планами.

Любой пользователь с доступом к записи в репозиторий может создавать в automations этом репозитории.

Вы можете создавать и управлять automations из:

  • Вкладка «Агенты» в репозитории на GitHub, в панелиAutomations.
  • Вкладка Automations в GitHub приложение Copilot.

Триггеры

An Автоматизация убегает, когда срабатывает один из его триггеров. Доступны следующие триггеры:

  • По расписанию: Автоматизация забеги с регулярным интервалом — ежечасно, ежедневно или еженедельно.
  • Когда возникает проблема: он Автоматизация запускается каждый раз, когда он открывается в репозитории.
  • Когда открывается pull request: он Автоматизация запускается каждый раз, когда он открывается в репозитории.
  • Когда pull request синхронизирован: он Автоматизация запускается каждый раз, когда новые коммиты отправляются в pull-запрос в репозитории.

Вы можете настроить фильтры для триггеров, основанных на событиях:

  • Если возникает проблема, добавьте фильтр поисковых запросов.
  • Для открытия pull-запроса и синхронизации добавьте фильтр поисковых запросов и фильтр для файлов, изменённых в pull-request.

Чтобы снизить риск внедрения запросов, automations игнорируйте события, вызываемые пользователями, которые по умолчанию не имеют доступа к репозиторию для записи. Это помогает предотвратить действия со стороны недоверенных пользователей — например, открытия проблемы со стороны внешнего участника Copilot . Вы можете согласиться на проведение таких мероприятий, если это необходимо. Для получения дополнительной информации см. раздел «Безопасность и безопасность».

Инструменты и действия

Инструменты, которые вы выбираете при создании, Автоматизация определяют, что Copilot можно делать при запускеАвтоматизация.

Например, вы можете разрешить Copilot push изменения, обновлять метки проблем или создавать pull request.

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

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

А может действовать только в одном репозитории, на которое Автоматизация оно ограничено.

Конфигурация, унаследованная из репозитория

Automations Используйте Copilot облачный агент конфигурацию для репозитория, к которому они распределяются, включая:

Automations хранятся отдельно от содержимого вашего репозитория. Они не фиксированы на Git, поэтому не версируются вместе с вашим кодом и не управляются через pull requests.

Видимость

An Автоматизацияявляется частным для пользователя, который его создал. Другие люди, включая администраторов репозиториев, не видят ваш automations.

Однако Copilot облачный агентсессии , которые он запускает Автоматизация , видны другим людям с доступом к репозиторию, как и любая другая Copilot облачный агент сессия. Любой, кто видит эти сессии, может увидеть подсказку, журналы сессий и любые pull requests или другие Copilot изменения, которые они создают.

Поскольку сессии и их логи видны другим, не следует напрямую включать секреты или другую конфиденциальную информацию в Автоматизациязапрос на . Чтобы дать Copilot доступ к чувствительным значениям, используйте секреты репозиториев. См . раздел AUTOTITLE.

Billing

Каждый раз, когда An Автоматизация запускается, она запускает Copilot облачный агент сессию, использующую GitHub Actions минуты и GitHub AI Credits. Это использование выставляет счет пользователю, создавшему Автоматизация. Дополнительные сведения см. в разделе Лицензии GitHub Copilot.

Безопасность и сохранность

Automations Они работают Copilot без того, чтобы кто-то инициировал каждую задачу, поэтому они связаны с дополнительными рисками. GitHub предоставляет встроенные меры защиты для снижения этих рисков.

  • Атрибуция. Открытые pull requests и код, отправленный , Автоматизация приписываются пользователю, создавшему Автоматизация. Как и с pull-request, которые пользователь создаёт самостоятельно, они не могут их одобрить, что сохраняет ожидаемые контроли проверки.
  • Инструменты с наименьшими привилегиями. Вы выбираете, какие инструменты можно Автоматизация использовать, поэтому ограничиваете это только действиями, требуемыми для задачи.
  • Ненадёжный вклад. По умолчанию automations игнорируйте события, вызываемые пользователями без доступа к записи в репозиторий, чтобы снизить риск внедрения запросов от недоверенных пользователей.
  • Рабочий процесс запускается. Как и во всех Copilot облачный агент работах, GitHub Actions рабочие процессы не запускаются по pull-запросу, пока пользователь с правом записи не одобрит их. Это снижает риск автоматического запуска Автоматизация процессов с помощью pull-запроса.

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

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