# Метрики строк кода

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

Строки метрик Кода (LoC) обеспечивают направление измерения Copilotвыходных данных путем квалифицирования предлагаемых, добавленных или удаленных в ходе завершения, чата и функций агента.

## Где появляются метрики LoC

Вы можете столкнуться с метриками LoC в:

* **Панель генерации кода (на уровне предприятия и организации)** — визуализирует активность пользователей и агентов на основе LoC. См [. раздел AUTOTITLE](/ru/copilot/how-tos/administer-copilot/view-code-generation).
* **Экспорты и API (корпоративный, организационный и пользовательский уровень)** — открывают поля LoC, такие как `loc_suggested_to_add_sum`, `loc_added_sum`, и `loc_deleted_sum`. См [. раздел AUTOTITLE](/ru/rest/copilot/copilot-usage-metrics).
* **Справочник по данным, доступным в Copilot метриках использования,** содержит список всех полей панели мониторинга и API, производных от LoC. См [. раздел AUTOTITLE](/ru/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).

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

## Рассмотрение метрик LoC

Метрики LoC могут различаться в зависимости от среды IDE и версий. Имейте в виду следующие соображения:

* **Охват:** Не все интегрированные среды разработки и пользователи будут выдавать данные телеметрии LoC до тех пор, пока не обновятся до требуемых версий. Отчеты включают поля and`last_known_ide_version`, `last_known_plugin_version` чтобы вы могли отслеживать покрытие в масштабах всего предприятия.
* **Стабильности:** По мере Copilot развития определения телеметрии могут изменяться. Ожидайте небольших сдвигов в данных по мере повышения точности с течением времени.

## Требования к версии

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

| Интегрированная среда разработки (IDE)                                                                             | Функция                                              | Минимальная версия IDE | Версия с минимальным Copilot Chat расширением |
| :----------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- | :--------------------- | :-------------------------------------------- |
| Затмение                                                                                                           | <ul><li>`code_completion`</li></ul>                  | 4.31                   | 0.9.3.202507240902                            |
|                                                                                                                    | <ul><li>                                             |                        |                                               |
| `chat_panel` (Спросить, Отредактировать, Спланировать, Агент)</li></ul>                                            | 4.31                                                 | 0.11.0.202508291001    |                                               |
|                                                                                                                    | <ul><li>`agent_edit`</li></ul>                       | 4.31                   | 0.10.0.202508110512                           |
| IntelliJ/JetBrains                                                                                                 | <ul><li>`code_completion`</li><li>                   |                        |                                               |
| `chat_panel` (Спросить, Отредактировать, Спланировать, Агент)</li><li>`chat_inline`</li><li>`agent_edit`</li></ul> | 2024.2.6                                             | 1.5.52-241             |                                               |
| Visual Studio                                                                                                      | <ul><li>`code_completion`</li><li>                   |                        |                                               |
| `chat_panel` (Спросить, Отредактировать, Спланировать, Агент)</li></ul>                                            | 17.14.13                                             | 18.0.471.29466         |                                               |
|                                                                                                                    | <ul><li>`chat_inline`</li><li>`agent_edit`</li></ul> | 17.14.14               | 18.0.471.29466                                |
| VS Code                                                                                                            | <ul><li>`code_completion`</li></ul>                  | 1.104.0                | 0.31.0                                        |
|                                                                                                                    | <ul><li>                                             |                        |                                               |
| `chat_panel` (Спросить, Отредактировать, Спланировать, Агент)</li></ul>                                            | 1.102.0                                              | 0.29.0                 |                                               |
|                                                                                                                    | <ul><li>`chat_inline`</li></ul>                      | 1.103.2                | 0.30.3                                        |
|                                                                                                                    | <ul><li>`agent_edit`</li></ul>                       | 1.103.0                | 0.30.0                                        |
| XCode                                                                                                              | <ul><li>`code_completion`</li></ul>                  | 14.3.1                 | 0.40.0                                        |
|                                                                                                                    | <ul><li>                                             |                        |                                               |
| `chat_panel` (Спросить, Отредактировать, Спланировать, Агент)</li></ul>                                            | 15,0                                                 | 0.43.0                 |                                               |
|                                                                                                                    | <ul><li>`agent_edit`</li></ul>                       | 15.2                   | 0.41.0                                        |

## Как режим агента влияет на метрики LoC

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

| Поведение                     | Как это отражается на метриках LoC                                                                                                        |
| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
| Предложения кода агента       | Считается моментом `loc_suggested_to_add_sum` , когда видимые блоки кода отображаются в панели чата.                                      |
| Редактирование файлов агентом | Учитывается как `loc_added_sum``loc_deleted_sum` и под `agent_edit` баком функций. Эти изменения не включаются в рекомендуемые метрики.   |
| Многофайловые операции        | Каждое редактирование файла вносит свой вклад в общее количество добавленных и удаленных строк, даже если оно запускается одним запросом. |

Пример выходных данных для деятельности LoC, связанной с агентом:

```json
"totals_by_language_feature": [
  {
    "language": "unknown",
    "feature": "chat_panel_agent_mode",
    "code_generation_activity_count": 12,
    "code_acceptance_activity_count": 0,
    "loc_suggested_to_add_sum": 86, // code block suggestions in chat panel in agent mode
    "loc_suggested_to_delete_sum": 0,
    "loc_added_sum": 5, // only includes code block copy or apply in chat panel, not agent edits
    "loc_deleted_sum": 0
  },
  {
    "language": "unknown",
    "feature": "agent_edit",
    "code_generation_activity_count": 345,
    "code_acceptance_activity_count": 0,
    "loc_suggested_to_add_sum": 0,
    "loc_suggested_to_delete_sum": 0,
    "loc_added_sum": 2342, // agent and edit mode edits in files
    "loc_deleted_sum": 947
  }
]
```

При редактировании одного агента вы можете увидеть такие метрики, как:

```json
"user_initiated_interaction_count": 0,
"code_generation_activity_count": 1,
"code_acceptance_activity_count": 0
```