О обзоре кода GitHub Copilot

Введение

Copilot code review Рецензирует код, написанный на любом языке, и даёт обратную связь. Он просматривает ваш код с разных сторон, чтобы выявлять проблемы и предлагать исправления. Вы можете применить предлагаемые изменения парой кликов.

В этой статье представлен обзор .Copilot code review Чтобы узнать, как запросить проверку кода от Copilot, смотрите Использование обзора кода GitHub Copilot.

Availability

Copilot code review поддерживается в:

• GitHub.com
• GitHub CLI
• GitHub Mobile
• VS Code
• Visual Studio
• Xcode
• Идентификаторы JetBrains
• Azure DevOps (Публичный предварительный просмотр)

Copilot code review Без Copilot лицензии

Члены организации без Copilot лицензии могут использовать Copilot code review на GitHub.com. Администратор предприятия или владелец организации должен включить его. Эта возможность доступна организациям, находящимся Copilot Business в планах Copilot Enterprise .

Возможность проверки кода для пользователей без лицензии

Чтобы разрешить членам организации без Copilot лицензии Copilot code reviewиспользовать это, необходимо включить две политики:

1. ** AI credits Платное использование**. Сначала включите эту политику. Это позволяет предприятию или организации взимать плату за Copilot code reviewAI credits использование.
2. Разрешить участникам без Copilot лицензии использовать Copilot code review в GitHub.com. Эта подполитика позволяет Copilot code review пользователям без лицензии.

Второй полис обладает следующими характеристиками:

• Он отключен по умолчанию.
• После установки этой политики на уровне предприятия она становится видимой, но не редактируемой на уровне организации.
• Политика очень строгая. Copilot code review доступен только в репозиториях в организации, где вы явно включили политику.

Как это работает для пользователей без лицензии

Когда обе политики активированы, пользователи без Copilot лицензии могут запросить проверку через Copilot code review свои pull-запросы в репозиториях организации.

В репозиториях, где включен автоматический просмотр кода, Copilot автоматически проверяют все pull requests. Это происходит независимо от того, есть ли у автора Copilot лицензия. Дополнительные сведения о настройке автоматической проверки кода см. в разделе Настройка автоматического проверки кода от GitHub Copilot.

Copilot code review для пользователей без лицензии недоступна в IDE.

Исключённые файлы

Некоторые типы файлов исключены из Copilot code review:

• Файлы управления зависимостями, такие как package.json и Gemfile.lock
• Файлы журналов
• SVG-файлы

Если вы включите эти типы файлов в pull request, Copilot code review файл не будет просматривать.

Дополнительные сведения см. в разделе Файлы, исключённые из GitHub Copilot code review.

Агентные возможности для Copilot code review

Copilot code review использует агентные возможности для расширения своей функциональности.

• Полный сбор контекста проекта. Это обеспечивает более конкретные, точные и контекстуально осознанные обзоры кода. Эта возможность анализирует весь ваш репозиторий для лучшего понимания контекста изменений кода.
• Возможность передавать предложения в Copilot cloud agent. Это автоматизирует создание нового pull-запроса на вашу ветку с применёнными предложенными исправлениями. Передача Copilot cloud agent предложений находится в публичном предварительном просмотре и может измениться.

Эти возможности включаются автоматически для всех планов, включающих Copilot code review. Дополнительные сведения о выборе уровней анализа Lite и Balanced см. далее в этой статье.

Если GitHub Actions он недоступен или если рабочие процессы действий Copilot code review не работают, отзывы всё равно будут генерироваться. Однако они не будут включать дополнительные функции, предоставляемые агентными возможностями.

Использование GitHub Actions раннеров для агентных возможностей при обзоре кода

Copilot code review использует GitHub Actions для запуска агентных возможностей, включая полный сбор контекста проекта и передачу предложений в Copilot cloud agent. По умолчанию Copilot code review использует стандартные GitHub-hosted runners. Вы также можете перейти на более крупные GitHubразмещённые бегунки для лучшей производительности или использовать самостоятельные бегунки.

Для использования агентских возможностей при проверке кода не обязательно GitHub Actions иметь в вашей организации или предприятии.

Если в вашей организации отключены GitHub-hosted runners, агентные возможности будут недоступны. В этом случае обзоры кода будут ограничены к более ограниченному обзору. Организации в такой ситуации могут использовать самостоятельные бегунки.

Для получения дополнительной информации о настройке раннеров смотрите Настройка раннеров для обзора кода GitHub Copilot.

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

Уровень работы по обзору

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

• Lite: Стандартный обзор. Предоставляет быструю, целенаправленную обратную связь по распространённым проблемам, таким как ошибки, уязвимости безопасности и несоответствия стиля (по умолчанию).
• Сбалансированный: маршрутизирует запросы на вытягивание в модель более высокого уровня для более длительного анализа сложных логики, конфиденциального кода безопасности и изменений между службами. Балансированные проверки используют больше AI credits, и могут использовать незначительно больше GitHub Actions минут, чем отзывы Lite.

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

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

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

Оценка потребления

Обзор обычно потребляет около $ 0,05 USD до $ 1 AI credits USD стоимостью с "Lite" усилий, и $ 0,25 USD до $ 5 ДОЛЛАРОВ стоимостью AI credits с "Сбалансированными" усилиями.

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

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

Использование при обзоре кода

Каждый раз, когда Copilot просматривает pull request или код в вашем IDE, взаимодействие AI creditsзанимает . Сумма зависит от используемой модели и количества обработанных токенов.

Обзоры кода имеют два компонента затрат: AI credits для взаимодействия с моделью (сам обзор) и GitHub Actions протоколы для агентных возможностей (сбор контекста и использование инструмента). Для получения дополнительной информации об GitHub Actions использовании см. раздел «Использование GitHub Actions раннеров для агентных возможностей в обзоре кода».

Если репозиторий настроен на автоматический запрос проверки кода для Copilot всех новых pull request, потребление AI credits приписывается автору pull request. Если отзыв запрашивается вручную другим пользователем, потребление приписывается именно этому пользователю.

Если пулл-запрос создан GitHub Actions ботом или самим ним, использование будет применяться к:

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

Что происходит, когда достигнут бюджет

Для и Copilot Business, доступ к Copilot Enterprise обзору кода регулируется бюджетным контролем. Если пользователь достигает своего пользовательского бюджета или если лимит расходов предприятия или центра затрат исчерпан, обзоры кода блокируются вместе с другими AI creditsрасходными функциями. См . раздел AUTOTITLE.

Пользователи без Copilot лицензии или плана, включающих Copilot code review

Пользователи без доступа Copilot code review не имеют ежемесячного пособия AI credits . Это включает пользователей без Copilot лицензии и пользователей плана Copilot Free , который не включает Copilot code review.

Когда Copilot code review это включено для этих пользователей, всё AI credits , что они потребляют, оплачивается напрямую компании или предприятию как оплаченное дополнительное использование. Это касается как вручную запрашиваемых проверок, так и автоматических проверок кода.

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

Использование модели

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

MCP-серверы и навыки агентов для обзора кода

Copilot code review можно использовать навыки агента уровня репозитория и MCP-серверы, когда они актуальны для проверки.

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

Навыки агента

Если в вашем репозитории есть навыки агента, Copilot code review можно автоматически использовать релевантные навыки при рассмотрении pull request, Copilot выходя за рамки встроенного анализа.

При проверке запроса Copilot на вытягивание считывает пользовательские инструкции репозитория, инструкции агента и навыки агента из головной ветви (ветвь с изменениями), а не базовую ветвь. Например, при слиянии my-feature-branch``mainс ними Copilot используются инструкции и навыки my-feature-branch, позволяющие протестировать изменения в одном запросе на вытягивание, не объединяя их в первую очередь.

Для подробностей настройки смотрите АВТОТИТР.

Серверы MCP

Copilot code review можете использовать MCP-серверы для прямого извлечения контекста в обзор с сторонних платформ и внутренних систем, которые использует ваша команда, включая отслеживание проблем, документацию, каталоги сервисов и инструменты для инцидентов.

По умолчанию MCP-серверы GitHub и Playwright MCP-серверы включены.

Вы можете настроить MCP-серверы в настройках репозитория. Конфигурация MCP репозитория на GitHub применимо к обеим Copilot cloud agent параметрам и Copilot code review. Изменения в настройках репозитория MCP влияют на обе функции. Для подробностей настройки смотрите АВТОТИТР.

В настройках репозитория Разрешить Copilot использовать MCP-инструменты при просмотре pull request по умолчанию включена. Отключите эту начёт, если хотите, чтобы MCP-серверы были доступны только для Copilot cloud agent, а не для Copilot code review. Для пошаговых инструкций см. АВТОТИТР.

Проверка Copilot проверки кода

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

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

Улучшение Copilotзнаний о репозитории

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

Пользовательские инструкции

Это короткие операторы на естественном языке, которые вы пишете и храните в виде одного или нескольких файлов в репозитории. Если вы владелец организации, GitHubвы также можете задавать индивидуальные инструкции в настройках вашей организации. Дополнительные сведения см. в разделе О кастомизации ответов GitHub Copilot.

Выбор пользовательских инструкций, AGENTS.md и навыков

Copilot code review может опираться на несколько источников настройки, и каждая из них служит для разных целей. Используйте .github/copilot-instructions.md правила на уровне репозитория, относящиеся к Copilotфайлам*.instructions.md, .github/instructions/ зависящим от пути, в соответствии с правилами, которые применяются только к определенным файлам или каталогам, используются AGENTS.md для постоянного использования правил, которые вы хотите предоставить общий доступ к средствам и агентам ИИ, а также использовать навыки для рабочих процессов, выполняемых Copilot по требованию. В следующей таблице приведены сведения об использовании каждого из них и способах предоставления правил.

Использование	copilot-instructions.md	Путь для конкретного пути *.instructions.md	AGENTS.md	Skills
лучше всего подходит для	Правила постоянного хранения для репозитория Copilot	Правила always-on для определенных путей, типов файлов или каталогов	Правила always-on, общие для агентов ИИ	Рабочие процессы проверки для конкретных задач
Хранится в	.github/copilot-instructions.md	.github/instructions/**/*.instructions.md	Корневой каталог репозитория (AGENTS.md)	.github/skills/...
Examples	Стандарты программирования, стандартные архитектуры, ожидания тестирования
content/** написание правил, src/** соглашений по программированию, руководство по языку	Соглашения общего репозитория, которые должны применяться за пределами Copilot	Проверки, выпуски, миграции, анализ
Активация	Automatic	Автоматически, когда измененные файлы соответствуют области инструкций	Автоматически (чтение из корневого каталога репозитория)	Автоматически при необходимости (например, навыки, ориентированные code-reviewна просмотр), или по требованию
Объем	Широкий и Copilotконкретный репозиторий	Вложенные пути и Copilotвложенные пути репозитория	Кросс-инструмент / агент-agnostic	Вызывается для каждой задачи
Правило	"Copilot, всегда знают это для этого репозитория"	"Copilot, всегда знать это при работе с этими путями"	"Любой агент, всегда знаю это"	"Сделайте это при необходимости"

Дополнительные сведения см. в разделе [AUTOTITLE и Добавление навыков агента для GitHub Copilot](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).

Copilot Memory (Публичный предварительный просмотр)

Если у вас есть Copilot Pro, Copilot Pro+или Copilot Max план, вы можете включить Copilot Memory. Это позволяет Copilot хранить полезные детали, которые они узнали о репозитории. Copilot Затем можно использовать эту информацию при просмотре pull requests в этом репозитории. Дополнительные сведения см. в разделе О памяти GitHub Copilot.

О автоматических проверка запроса на вытягивание

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

• Отдельные пользователи плана Copilot Pro OR Copilot Pro+ могут настроить Copilot автоматический просмотр всех созданных ими pull request.
• Владельцы репозиториев могут настроить Copilot автоматический просмотр всех pull-запросов в репозитории, созданных людьми с доступом к Copilot.
• Владельцы организаций могут настроить Copilot автоматический просмотр всех pull-запросов в некоторых или всех репозиториях организации, где пользователь создаёт Copilot pull request.

Если ваша организация включена Copilot code review без Copilot лицензии, автоматические проверки также применяются к запросам на вытягивание, созданные членами организации без лицензии. Это относится к репозиториям, охватываемым политикой, в которой включены автоматические проверки. Дополнительные сведения см Copilot code review . без Copilot лицензии.

Активация автоматического проверка запроса на вытягивание

Триггеры автоматического кода зависят от настроек конфигурации.

• Базовая обстановка:
  • Когда вы создаёте pull request как «Open» pull request.
  • Первый раз, когда вы переключаете pull-запрос «Draft» на «Open».
• Обзор новых выпусков:
  • Каждый раз, когда вы запускаете новый коммит в pull request.
• Просмотр черновиков pull requests:
  • Pull requests автоматически проверяются, пока они ещё черновики, прежде чем вы переключаете их в «Открытый».

Полные инструкции смотрите в разделе AUTOTITLE.

Получение подробных отзывов о качестве кода в репозитории

GitHub Copilot code review проверяет изменения в запросе на вытягивание и предлагает исправления. Чтобы добавить систематические отзывы о надежности и надежности кода, запросах на вытягивание и в ветви по умолчанию включите GitHub Code Quality.

GitHub Code Quality дополняется Copilot code review путем добавления:

• Анализ на основе правил на основе CodeQL запросов на вытягивание и в ветви по умолчанию.
• Метрики покрытия тестов для запросов на вытягивание, поэтому вы можете узнать, поддерживает ли изменение или снижает охват.
• Одно щелчок, исправление с питанием, Copilot включая делегирование исправленияCopilot cloud agent.
• Необязательное слияние с наборами правил, поэтому запросы на вытягивание с неразрешенными результатами на основе правил (или отсутствующие пороговое значение покрытия) можно заблокировать от объединения.

Дополнительные сведения см. в разделе Качество кода GitHub.

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

• Использование обзора кода GitHub Copilot