Skip to main content

Ответственное использование кратких сводок pull request на GitHub Copilot

Научитесь использовать Краткое описание pull request Copilot ответственно, понимая его цели, возможности и ограничения.

Около Краткое описание pull request Copilot

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

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

Сводка можно создать в следующих местах:

  • В описании нового запроса на вытягивание, который вы создаете
  • В описании существующего запроса на вытягивание путем редактирования открывающего комментария
  • В комментариях к основной временной шкале запроса на вытягивание

Единственный поддерживаемый язык Краткое описание pull request Copilot — английский.

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

Создание ответов

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

Подход к конвейеру

Когда пользователь запрашивает сводку, запускается рабочий процесс. Рабочий процесс использует diffs кода для создания запроса, который запрашивает Copilot сводку pull request. Сводный запрос запускает процесс конвейера, который включает необработанные различия из суммаризируемых файлов в запросе и запросы Copilot на генерацию общего резюме для pull request.

Форматирование вывода

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

  • Абзац, написанный в прозе, предоставляющий обзор изменений в запросе на вытягивание.
  • Маркированный список ключевых изменений, связанный с соответствующими строками кода, в которых происходят эти изменения.

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

Вариант использования сводок запроса на вытягивание

Цель Краткое описание pull request Copilot — помочь автору быстро предоставлять контекст, когда он запрашивает человеческий обзор, требующий предоставления контекста внесённых изменений. Это может помочь повысить производительность разработчика, сокращая время, затраченное на открытие запроса на вытягивание.

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

Повышение производительности сводок запросов на вытягивание

Используйте Краткое описание pull request Copilot как инструмент, а не как замену

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

Предоставление отзыва

Примечание.

Возможность предоставления обратной связи GitHub о Краткое описание pull request Copilot зависит от параметров предприятия. Дополнительные сведения см. в разделе Управление политиками и функциями GitHub Copilot в вашем предприятии.

Если вы столкнулись с проблемами или ограничениями, Краткое описание pull request Copilotвы можете оставить обратную связь, нажав кнопку «Плохое резюме» (иконка «палец вниз»), которая отображается под текстовым полем после создания резюме и перед нажатием «Создать pull request » или «Обновить комментарий».

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

После того как вы оцените сводку как хорошую или плохую, вы можете предоставить письменные отзывы, щелкнув ссылку, отображаемую.

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

В настоящее время наша команда знает, что существуют ограничения для этой функции. Многие из них ожидаются при использовании нашего Copilot API; однако есть и некоторые, которые специфичны Краткое описание pull request Copilot , касающиеся ограниченного охвата, более длительного времени обработки и неточных ответов. Также обратите внимание, что пользователи должны ожидать, что термины, используемые в их PR, будут отображаться в сводке по искусственному интеллекту. Эта функция была подвержена RAI Red Teaming, и мы будем продолжать отслеживать эффективность и безопасность функции с течением времени. Для получения дополнительной информации смотрите Майкрософт AI Red Team building future of safer AI в блоге Майкрософт security.

Линии изменили границы

Файлы с более чем 400 совокупными добавлениями и удалениями исключены из суммирования.

Ограниченная область

Из-за емкости мы знаем, что более крупные запросы на вытягивание, ссылающиеся на 30 или более файлов, потребуют больше времени для тщательной обработки. В настоящее время у нас нет точного порогового значения, но наблюдалось, что первые 30 файлов учитываются, а затем все дополнительные файлы, опущенные из суммирования. Мы работаем над решением этого текущего ограничения области.

Время обработки

Как правило, мы ожидаем, что сводка будет возвращена в течение 40 секунд или меньше после того, как пользователь инициирует действие. Тем не менее, мы слышали, что это может занять до минуты, и в некоторых случаях несколько минут. Мы работаем над уменьшением времени обработки, и мы знаем, что пользователи могут не ждать завершения этого, прежде чем переходить к другим частям запроса на вытягивание.

Неточные ответы

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

Повторное создание сводок

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

Репликация содержимого запроса на вытягивание

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

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

  •         [
            GitHub Copilot Центр доверия](https://copilot.github.trust.page/)
    
  •         [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-pull-request-summaries/creating-a-pull-request-summary-with-github-copilot) в GitHub Enterprise Cloud документации.