# Обмен данными о влиянии GitHub Copilot

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

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

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

## Prerequisites

Copilot Соберите данные об использовании, записи расходов, меры по результатам проектирования и отзывы разработчиков. Обратитесь к сотрудникам, ответственным за метрики и выставление счетов, если у вас нет доступа к этим источникам.

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

* [Просмотр панели мониторинга метрик использования Copilot](/ru/copilot/how-tos/administer-copilot/view-usage-and-adoption)
* [Управление расходами вашей компании на GitHub Copilot](/ru/copilot/how-tos/manage-and-track-spending/manage-company-spending)

Выберите меры результатов, соответствующие целям развертывания перед подготовкой отчета. См [. раздел AUTOTITLE](/ru/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/achieve-company-goals).

## Шаг 1. Определение решения

Запишите решение, которое вы хотите, чтобы отчет поддержал и кто сделает это. Например, решите, следует ли продлить лицензии, развернуть развертывание или инвестировать в обучение.

Выберите доказательства, которые отвечают на вопросы создателя решений:

* Для исполнительного обзора подключите внедрение к инженерным целям, которые имеют значение для руководства. Суммирование хода выполнения, затрат и оставшихся рисков.
* Для продления объясните устойчивое использование и наблюдаемое значение вместе с расходами. Определите пробелы в внедрении и план их решения.
* Чтобы запросить инвестиции, объясните, какие команды или рабочие процессы будут поддерживать далее. Окажите предлагаемый бюджет, ожидаемые результаты и как вы будете оценивать инвестиции.

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

## Шаг 2. Установка сравнения

Сделайте область отчета явной, чтобы читатели могли понять, что изменилось.

1. Запишите включенные организации, команды и репозитории.
2. Укажите даты отчетности и базовые показатели, которые вы сравниваете. Используйте сопоставимые периоды и объясните все различия в их длине.
3. Запишите население за каждой мерой. Например, различает назначенные лицензии, активных пользователей и респондентов опроса.
4. Обратите внимание на изменения в персонале, сложности проекта, расписания выпуска или методики проектирования, которые могут повлиять на результаты.

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

Не предполагайте, что итоги панели мониторинга и API взаимозаменяемы. Перед объединением их окон отчетов и групп населения проверьте их. См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics).

## Шаг 3. Сбор доказательств

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

Создайте отчет из следующих типов доказательств:

* **Внедрение:** Используйте тенденции активных пользователей, устойчивые способы использования и внедрения, чтобы объяснить, кто использует Copilot и как изменяется использование.
* **Стоимость:** Используйте записи расходов, чтобы описать затраты на лицензии и дополнительные расходы на использование. Отчет AI credits о потреблении отдельно от выставленных расходов. Включите затраты на обучение или администрирование в оценку инвестиций и оценки меток.
* **Создание кода:** Используйте тенденции создания кода и линий кода для описания действий. Не рассматривайте более созданный код как подтверждение повышения производительности, повышения качества или отправленного значения.
* **Доставка:** Сравните пропускную способность запроса на вытягивание и время слияния с выбранными целями доставки.
* **Качество:** Включите соответствующее покрытие тестов, дефекты, результаты безопасности или инциденты, чтобы ускорить доставку не оценивается в изоляции.
* **Отзывы разработчика:** Сводные сведения о том, где разработчики сообщают полезную помощь, дополнительную работу проверки или барьеры рабочего процесса. Включите количество респондентов и объясните, как вы собрали свои отзывы.

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

## Шаг 4. Разделение наблюдений с выводами

Для каждого поиска напишите то, что вы заметили, прежде чем объяснить, что вы думаете, это означает. Например, "Teams с более глубоким внедрением объединяет больше запросов на вытягивание на пользователя" описывает связь. "Copilot сделал эти команды более продуктивным" утверждает причину, что сравнение только не устанавливает.

Рекомендации по интерпретации сравнения панелей мониторинга и оценки см. в разделе [Интерпретация метрик использования и внедрения для GitHub Copilot](/ru/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics).

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

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

## Шаг 5. Написание повествования

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

1. **Осудите решение и цель.** Объясните, что вы хотите утвердить и какую инженерную проблему она решает.

2. **Обобщайте доказательства.** Описать внедрение, расходы и результаты, наиболее важные для этой цели.

3. **Объясните ограничения.** Состояние того, что неясно, что еще изменилось, и что доказательства не могут установить.

4. **Рекомендуется действие.** Объясните, почему доказательства поддерживают это действие, а не более широкую приверженность.

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

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

Например, гипотетический владелец развертывания может сообщить:

> Мы рекомендуем расширить развертывание до одной дополнительной команды 15 разработчиков, с предлагаемым бюджетом $ 2000 для лицензий, использования и обучения в октябре. Наша цель заключается в сокращении времени запроса на вытягивание для слияния без снижения качества.
>
> В сентябре 40 из 50 лицензированных разработчиков использовались Copilotпо сравнению с 30 из 50 в августе, наш базовый месяц. Время запроса на вытягивание медиана для слияния сократилось с трех дней до двух с половиной дней. В опросе группы 28 из 35 респондентов сообщили о помощи в написании тестов, но покрытие тестов не изменилось.
>
> Расходы остались в бюджете развертывания. Мы не можем атрибутировать изменение доставки в Copilot одиночку, так как команда также изменила свой процесс проверки.
>
> Владелец развертывания добавит учебный курс тестирования и обзор внедрения, расходов, покрытия и отзыв разработчика в конце октября. Дальнейшее расширение будет зависеть от медиана времени, чтобы объединиться в течение двух или более двух с половиной дней, тестирования увеличения покрытия и расходов, остающихся в бюджете.

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