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

Введение

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

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

Availability

          Обзор кода Copilot поддерживается в:

• GitHub.com

• GitHub CLI

• GitHub Mobile

• VS Code

• Visual Studio

• Xcode

• Идентификаторы JetBrains

          Обзор кода Copilot является премиум-функцией, доступной в таких планах:
  

• Copilot Pro

• Copilot Pro+

• Copilot Business

• Copilot Enterprise

Смотрите Copilot планы.

Если вы получаете Copilot от организации, ваша организация должна включить эту Обзор кода Copilot опцию в настройках Copilot политики. Это относится к отзывам на GitHub.com или в GitHub Mobile. См . раздел AUTOTITLE.

          Обзор кода Copilot Без Copilot лицензии

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

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

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

1.        **Платное использование с премиум-запросом**. Сначала включите эту политику. Это позволяет предприятию или организации взимать плату за Обзор кода Copilot использование премиум-запросов.
   

2.        **Разрешить участникам без Copilot лицензии использовать Обзор кода Copilot в GitHub.com**. Эта подполитика позволяет Обзор кода Copilot пользователям без лицензии.
   

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

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

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

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

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

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

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

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

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

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

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

Агентные возможности для Обзор кода Copilot

          Обзор кода Copilot обладает возможностями, которые находятся в public preview состоянии и могут измениться. 

          [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) применимы к использованию функций предварительного просмотра.

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

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

Эти возможности включаются автоматически для Copilot Pro планов Copilot Pro+ .

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

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

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

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

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

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

Ежемесячная квота проверки кода

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

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

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

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

Что происходит, когда вы достигнете своей нормы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

          Copilot Memory (public preview)

Если у вас есть план или Copilot ProCopilot Pro+ , вы можете включить 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.
  

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

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

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

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

Получение подробной обратной связи о качестве кода для всего репозитория

          Обзор кода GitHub Copilot Проверяет ваш код в pull requests и даёт обратную связь. Если хотите получить практическую обратную связь о надёжности и поддерживаемости всего вашего репозитория, включите GitHub Code Quality. См [. раздел AUTOTITLE](/code-security/code-quality/concepts/about-code-quality).

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

•         [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review)