# Datos disponibles en métricas de uso de Copilot

Copilot Los datos de métricas de uso están disponibles a través del panel y las API, mediante un conjunto coherente de campos para representar la actividad de adopción, uso y generación de código.

El Copilot panel de métricas de uso y las API muestran y exportan datos mediante un conjunto coherente de campos. En esta referencia se enumeran todas las métricas disponibles y se describe cómo interpretar sus valores tanto en los objetos visuales de panel como en las exportaciones de API o NDJSON.

* Los Copilot paneles de métricas de uso están disponibles en el nivel **empresarial** y **de organización** .
* Las Copilot API de métricas de uso devuelven informes en el ámbito de la **empresa** o la **organización**, con niveles de granularidad agregados, a **nivel de repositorio** y a **nivel de usuario individual**. Las formas varían según el ámbito y la granularidad.
* Las métricas de nivel de equipo no se agregan previamente; puede construirlos uniendo el informe de equipos de usuario con el informe de métricas de uso por usuario. Consulte [Métricas de uso de Copilot a nivel de equipo](/es/copilot/reference/copilot-usage-metrics/team-level-metrics).
* Los informes por repositorio contienen un registro por repositorio con actividad de solicitudes de extracción del día solicitado. Consulte [Campos de nivel de repositorio (solo API)](#repository-level-fields-api-only) más adelante en este artículo.

Para obtener instrucciones sobre cómo leer e interpretar estas métricas, consulte [métricas de uso de GitHub Copilot](/es/copilot/concepts/copilot-usage-metrics/copilot-metrics).

## Copilot métricas del panel de uso

Estas métricas aparecen directamente en el panel de Copilot uso. Estos gráficos **no** incluyen el uso de Copilot CLI.

| Métrica                                            | Description                                                                                         |
| :------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |
| Adopción de agente                                 | Porcentaje de Copilotusuarios activos con licencia que probaron un agente en el mes natural actual. |
| Promedio de solicitudes de chat por usuario activo | Número medio de solicitudes de chat por usuario activo.                                             |
| Finalizaciones de código (sugeridas o aceptadas)   | Número total de sugerencias de código en línea mostradas y aceptadas.                               |
| Tasa de aceptación de finalización de código       | Porcentaje de sugerencias aceptadas por los usuarios.                                               |
| Usuarios activos diarios                           | Número de usuarios únicos que usaron Copilot en un día determinado.                                 |
| Usuarios activos semanales                         | Número de usuarios únicos que usaron Copilot durante un período de siete días.                      |
| Total de usuarios activos                          | Usuarios con licencia activos en el mes natural actual.                                             |
| Uso de idiomas                                     | Distribución de lenguajes de programación usados con Copilot.                                       |
| Uso de idioma por día                              | Desglose diario de los idiomas usados.                                                              |
| Uso del modelo                                     | Distribución de modelos de inteligencia artificial usados para chat.                                |
| Uso del modelo por día                             | Desglose diario del uso del modelo de chat.                                                         |
| Uso del modelo por modo de chat                    | Uso del modelo por la función Copilot (preguntar, editar, planificar, agente).                      |
| Uso del modelo por lenguaje                        | Distribución de lenguajes desglosados por modelo.                                                   |
| Modelo de chat más usado                           | El modelo de chat más usado en los últimos 28 días.                                                 |
| Solicitudes por modo de chat                       | Número de solicitudes de chat por modo (preguntar, editar, planear, agente).                        |

## Métricas del panel de impacto

Estas métricas aparecen en el panel de impacto, que agrupa a los usuarios en cohortes de adopción y relaciona esa adopción con los resultados de las pull requests. Para obtener instrucciones sobre cómo interpretar las cohortes de adopción, consulte [métricas de uso de GitHub Copilot](/es/copilot/concepts/copilot-usage-metrics/copilot-metrics#understanding-adoption-cohorts).

| Métrica                              | Description                                                                                                                                                                                                                                                               |
| :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tendencias de interacción            | El modo en que la combinación de cohortes de adopción de la organización y el rendimiento de las solicitudes de incorporación de cambios (total de solicitudes de incorporación de cambios combinadas al mes) han cambiado durante los últimos seis meses.                |
| Distribución de cohortes de adopción | Proporción de usuarios con licencia agrupados por fase de adopción (usuarios pasivos, fase 1, fase 2, fase 3) durante el período. Los usuarios pasivos corresponden al `No Cohort` valor de la API.                                                                       |
| Multiplicador de adopción            | Compara a los usuarios activos (fase 1, 2 o 3) con los usuarios pasivos en cuanto al código entregado (pull requests fusionadas por usuario al mes) y al tiempo de fusión de las pull requests, para mostrar el impacto relativo de una adopción más profunda de Copilot. |
| Recommendations                      | Acciones sugeridas, como configurar Copilot cloud agent o habilitar Copilot code review, en función de la distribución actual de cohortes de la organización.                                                                                                             |

## Métricas del panel de generación de código

Estas métricas aparecen en el panel de generación de código y proporcionan un desglose de cómo se genera el código en toda la actividad iniciada por el usuario y iniciada por el agente. Todos los valores se derivan de líneas de código (LoC) agregadas o eliminadas en el IDE.

| Métrica                                               | Description                                                                                                                                            |
| :---------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Líneas de código modificadas con IA                   | Total de líneas de código agregadas y eliminadas en todos los modos de los últimos 28 días.                                                            |
| Contribución del agente                               | Porcentaje de líneas de código agregadas y eliminadas por agentes (incluidos los modos de edición, agente y personalizado) en los últimos 28 días.     |
| Promedio de líneas eliminadas por agente              | Número medio de líneas eliminadas automáticamente por los agentes en nombre de los usuarios activos durante el mes natural actual.                     |
| Total diario de líneas agregadas y eliminadas         | Número total de líneas agregadas y eliminadas del código base en todos los modos de cada día.                                                          |
| Cambios de código iniciados por el usuario            | Líneas sugeridas o agregadas manualmente por los usuarios mediante finalizaciones de código y acciones del panel de chat (insertar, copiar o aplicar). |
| Cambios de código iniciados por el agente             | Líneas añadidas o eliminadas automáticamente del código base por los agentes en nombre de los usuarios en los modos editar, agente y personalizado.    |
| Cambios de código iniciados por el usuario por modelo | Líneas de código iniciadas por el usuario, agrupadas por modelo usadas en el IDE.                                                                      |
| Cambios de código por modelo iniciados por agente     | Líneas de código iniciadas por el agente, agrupadas por el modelo que realizan las acciones del agente.                                                |
| Cambios de código iniciados por el usuario por idioma | Líneas de código iniciadas por el usuario, agrupadas por lenguaje de programación.                                                                     |
| Cambios de código iniciados por agente por idioma     | Líneas de código iniciadas por el agente, agrupadas por lenguaje de programación.                                                                      |

## Campos de API y exportación

Estos campos aparecen en los informes de NDJSON exportados y en las Copilot API de métricas de uso. La mayoría de las tablas siguientes enumeran el nombre del campo, su tipo JSON, si el valor puede ser NULL y una descripción.

Los informes se incluyen en diferentes formas en función de su ámbito y granularidad, por lo que los campos disponibles en un registro dependen de qué informe procede:

* **Los informes por usuario** (`*-users-1-day` y `*-users-28-day`) contienen un registro por usuario, incluidos `user_id`, `user_login`, `ai_credits_used`, los `used_*` indicadores y `ai_adoption_phase`. No contienen recuentos de usuarios activos, `pull_requests`o `totals_by_ai_adoption_phase`.
* **Los informes agregados** (`enterprise-1-day` y `org-1-day`) contienen un registro agregado por empresa u organización, incluidos los recuentos de usuarios activos, `pull_requests`y `totals_by_ai_adoption_phase`. No contienen `user_id`, `user_login`ni los `used_*` indicadores.
* **Los informes de 28 días** (`enterprise-28-day` y `org-28-day`) encapsulan una matriz de registros agregados diarios en un `day_totals` campo, con la ventana de informes en el nivel superior.
* **Los informes de equipos** de usuario (`*-user-teams-1-day`) asignan usuarios a los equipos a los que pertenecen, por lo que puede construir métricas de nivel de equipo.
* **Los informes de nivel de repositorio** (`*-repos-1-day`) contienen un registro por repositorio con actividad de solicitud de incorporación de cambios durante el día, incluidas las solicitudes de incorporación de cambios creadas por Copilot cloud agent y revisadas por Copilot code review.

Los informes de ámbito de la organización también incluyen `organization_id` junto con `enterprise_id`. Para obtener esquemas de ejemplo de los datos devueltos por las API, consulte [Esquema de ejemplo para métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/example-schema).

La columna **Tipo** usa tipos de esquema JSON: `string`, `integer`, `number`, `boolean`, `array`y `object`. La columna **Nullable** indica si el valor de un campo puede ser `null` o estar ausente de un registro en el que, de otro modo, estaría presente. Las matrices de desglose de actividad siempre están presentes, pero pueden estar vacías (`[]`). Las matrices opcionales se marcan como que aceptan valores NULL y pueden estar ausentes.

### Campos de identificación y partición de informes

Estos campos identifican el ámbito, la fecha y, en el caso de las exportaciones, la partición de cada registro. El conjunto exacto presente depende de la forma del informe.

| Campo                      | Tipo      | Anulable | Description                                                                                                                                                                               |
| :------------------------- | :-------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `day`                      | `string`  | No       | Día del calendario que representa este registro, en `YYYY-MM-DD` formato. En los informes de 28 días, `day` aparece dentro de cada `day_totals` entrada en lugar de en el nivel superior. |
| `enterprise_id`            | `string`  | No       | Identificador único de la empresa. Incluidos en los informes de ámbito empresarial y de organización.                                                                                     |
| `organization_id`          | `string`  | Sí       | ID único de la organización. Solo se incluye en los informes de ámbito de la organización; se omite de los informes de ámbito empresarial.                                                |
| `etl_id` / `day_partition` | `string`  | No       | Campos de partición utilizados para tareas de mantenimiento. Incluido en los archivos NDJSON exportados y devueltos por las API de métricas de uso.                                       |
| `entity_id_partition`      | `integer` | No       | Partición de entidad utilizada para tareas de mantenimiento. Incluido en los archivos NDJSON exportados y devueltos por las API de métricas de uso.                                       |

### Campos de informe por usuario

Los informes por usuario contienen un registro por usuario durante el período de informe. El informe de 28 días por usuario también incluye `report_start_day` y `report_end_day` para marcar la ventana de informes.

| Campo                                                                                                                                                                                                                                   | Tipo      | Anulable | Description                                                                                                                                                                                                                                                                                        |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                                                                                                                                                                                                                               | `integer` | No       | Identificador único para el usuario.                                                                                                                                                                                                                                                               |
| `user_login`                                                                                                                                                                                                                            | `string`  | No       |                                                                                                                                                                                                                                                                                                    |
| GitHub nombre de usuario para el usuario.                                                                                                                                                                                               |           |          |                                                                                                                                                                                                                                                                                                    |
| `ai_credits_used`                                                                                                                                                                                                                       | `number`  | No       | Total de créditos de inteligencia artificial consumidos por el usuario en el período de informe. Este campo solo se incluye en los informes por usuario y no se desglosa por característica, modelo o superficie. Esta métrica es para el análisis de consumo, no para los totales de facturación. |
| `user_initiated_interaction_count`                                                                                                                                                                                                      | `integer` | No       | Número de mensajes explícitos enviados a Copilot.<br><br>Solo cuenta los mensajes o indicaciones enviadas activamente al modelo.                                                                                                                                                                   |
| **No incluye** abrir el panel de chat, cambiar modos (por ejemplo, preguntar, editar, planear o actuar como agente), usar métodos abreviados de teclado para abrir la interfaz de usuario en línea o realizar cambios de configuración. |           |          |                                                                                                                                                                                                                                                                                                    |
| `code_generation_activity_count`                                                                                                                                                                                                        | `integer` | No       | Número de eventos de salida distintos Copilot generados. <br><br>                                                                                                                                                                                                                                  |
| **Incluye:** Todo el contenido generado, incluidos comentarios y docstrings. <br>                                                                                                                                                       |           |          |                                                                                                                                                                                                                                                                                                    |
| **Varios bloques:** Cada bloque de código distinto de un único aviso de usuario cuenta como una generación independiente. <br>                                                                                                          |           |          |                                                                                                                                                                                                                                                                                                    |
| **Nota:** Esta métrica no es directamente comparable a `user_initiated_interaction_count`, ya que una solicitud puede generar varias generaciones.                                                                                      |           |          |                                                                                                                                                                                                                                                                                                    |
| `code_acceptance_activity_count`                                                                                                                                                                                                        | `integer` | No       | Número de sugerencias o bloques de código aceptados por los usuarios. <br><br>                                                                                                                                                                                                                     |
| **Cuentas:** Todas las acciones integradas de aceptación, como "aplicar al archivo", "insertar en cursor", "insertar en terminal" y usar el botón **Copiar**. <br>                                                                      |           |          |                                                                                                                                                                                                                                                                                                    |
| **No cuenta:** Acciones manuales del Portapapeles del sistema operativo (por ejemplo, <kbd>Ctrl</kbd>+<kbd>C</kbd>). <br>                                                                                                               |           |          |                                                                                                                                                                                                                                                                                                    |
| **Granularidad:** Cada acción de aceptación incrementa el contador una vez, independientemente del número de bloques de código generados por la indicación inicial.                                                                     |           |          |                                                                                                                                                                                                                                                                                                    |
| `loc_suggested_to_add_sum`                                                                                                                                                                                                              | `integer` | No       | Líneas de código que Copilot sugirió añadir (autocompletado, chat en línea, panel de chat, etc.; **excluye** las ediciones de los agentes).                                                                                                                                                        |
| `loc_suggested_to_delete_sum`                                                                                                                                                                                                           | `integer` | No       | Líneas de código Copilot sugeridas para eliminar (compatibilidad futura planeada).                                                                                                                                                                                                                 |
| `loc_added_sum`                                                                                                                                                                                                                         | `integer` | No       | Líneas de código agregadas realmente al editor (finalizaciones aceptadas, bloques de código aplicados, agente y modo de edición).                                                                                                                                                                  |
| `loc_deleted_sum`                                                                                                                                                                                                                       | `integer` | No       | Líneas de código eliminadas del editor (actualmente de las ediciones del agente).                                                                                                                                                                                                                  |
| `used_agent`                                                                                                                                                                                                                            | `boolean` | No       | Indica si el usuario usó el modo de agente en el IDE ese día. No incluye la actividad Copilot code review, que se captura por separado en `used_copilot_code_review_active` y `used_copilot_code_review_passive`.                                                                                  |
| `used_chat`                                                                                                                                                                                                                             | `boolean` | No       | Indica si el usuario ha usado el chat del IDE ese día.                                                                                                                                                                                                                                             |
| `used_cli`                                                                                                                                                                                                                              | `boolean` | No       | Indica si el usuario usó Copilot CLI ese día.                                                                                                                                                                                                                                                      |
| `used_copilot_app`                                                                                                                                                                                                                      | `boolean` | No       | Si el usuario usó el Copilot app ese día.                                                                                                                                                                                                                                                          |
| `used_copilot_coding_agent`                                                                                                                                                                                                             | `boolean` | No       | Si el usuario usó Copilot cloud agent (anteriormente Copilot agente de codificación) ese día.                                                                                                                                                                                                      |
| `used_copilot_cloud_agent`                                                                                                                                                                                                              | `boolean` | No       | Indica si el usuario usó Copilot cloud agent ese día. Lleva el mismo valor que `used_copilot_coding_agent`; ambos nombres se conservan para la compatibilidad con versiones anteriores.                                                                                                            |
| `used_copilot_code_review_active`                                                                                                                                                                                                       | `boolean` | Sí       | Si el usuario se ha comprometido activamente con Copilot code review ese día. Un usuario se considera activo si solicitó manualmente una Copilot revisión o aplicó una Copilot sugerencia de revisión. Null cuando no hay ninguna Copilot code review señal para el usuario ese día.               |
| `used_copilot_code_review_passive`                                                                                                                                                                                                      | `boolean` | Sí       | Si al usuario se le asignó automáticamente Copilot para revisar su solicitud de incorporación de cambios ese día, sin participar activamente en la revisión. Null cuando no hay ninguna Copilot code review señal para el usuario ese día.                                                         |
| `ai_adoption_phase`                                                                                                                                                                                                                     | `object`  | No       | La fase de adopción de la IA del usuario para ese día. Siempre presente; por defecto, se establece en la fase Sin cohorte. Consulte [campos de la fase de adopción de IA](#ai-adoption-phase-fields).                                                                                              |
| `totals_by_cli`                                                                                                                                                                                                                         | `object`  | Sí       | Métricas específicas de la CLI para el usuario. Se omite cuando el usuario no tenía ningún Copilot CLI uso ese día. Consulte [Copilot CLI los campos de métricas](#copilot-cli-metrics-fields).                                                                                                    |
| `totals_by_copilot_app`                                                                                                                                                                                                                 | `object`  | Sí       |                                                                                                                                                                                                                                                                                                    |
| Copilot app métricas para el usuario. Se omite cuando el usuario no tenía ningún Copilot app uso ese día. Consulte [Copilot app los campos de métricas](#copilot-app-metrics-fields).                                                   |           |          |                                                                                                                                                                                                                                                                                                    |
| `totals_by_3rd_party_agent`                                                                                                                                                                                                             | `array`   | Sí       | Métricas de uso por agente para reconocido agent apps. Se omite cuando el usuario no tenía ninguna actividad reconocida agent app durante el período de informe. Consulte [Agent apps los campos de métricas](#agent-apps-metrics-fields).                                                         |
| `totals_by_ide`                                                                                                                                                                                                                         | `array`   | No       | Desglose por IDE de la actividad del usuario. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                                                                            |
| `totals_by_feature`                                                                                                                                                                                                                     | `array`   | No       | Desglose por característica de la actividad del usuario. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                                                                 |
| `totals_by_language_feature`                                                                                                                                                                                                            | `array`   | No       | Desglose que combina las dimensiones de lenguaje y características. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                                                      |
| `totals_by_language_model`                                                                                                                                                                                                              | `array`   | No       | Desglose de la combinación de dimensiones de lenguaje y modelo para la actividad de chat. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                                |
| `totals_by_model_feature`                                                                                                                                                                                                               | `array`   | No       | Desglose que combina las dimensiones de modelo y características de la actividad de chat. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                                |

### Campos de informe de empresa y organización agregados

Los informes agregados contienen un registro por empresa u organización, que resume todos los usuarios durante el día. Los recuentos de usuarios activos incluyen usuarios identificados a través de la telemetría del lado cliente y del lado servidor. Los usuarios identificados únicamente mediante la telemetría del servidor se contabilizan en los totales de usuarios activos, pero es posible que no aparezcan en las matrices de desglose por dimensión (`totals_by_ide`, `totals_by_feature` y similares). En las tablas siguientes se enumeran los recuentos de usuarios activos y, a continuación, los totales de actividad y los desgloses.

Recuentos de usuarios activos:

| Campo                                       | Tipo      | Anulable | Description                                                                                                                                                                                                                                                                                          |
| :------------------------------------------ | :-------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `daily_active_users`                        | `integer` | No       | Número de usuarios únicos que usaron Copilot en un día determinado.                                                                                                                                                                                                                                  |
| `weekly_active_users`                       | `integer` | No       | Número de usuarios únicos que usaron Copilot durante una ventana final de siete días.                                                                                                                                                                                                                |
| `monthly_active_users`                      | `integer` | No       | Número de usuarios únicos que usaron Copilot durante una ventana final de 28 días.                                                                                                                                                                                                                   |
| `monthly_active_chat_users`                 | `integer` | No       | Número de usuarios únicos que usaron chat durante una ventana final de 28 días.                                                                                                                                                                                                                      |
| `monthly_active_agent_users`                | `integer` | No       | Número de usuarios únicos que usaron el modo de agente durante una ventana final de 28 días.                                                                                                                                                                                                         |
| `daily_active_copilot_cloud_agent_users`    | `integer` | No       | Número de usuarios únicos que usaron Copilot cloud agent en un día determinado.                                                                                                                                                                                                                      |
| `weekly_active_copilot_cloud_agent_users`   | `integer` | No       | Número de usuarios únicos que usaron Copilot cloud agent durante una ventana final de siete días.                                                                                                                                                                                                    |
| `monthly_active_copilot_cloud_agent_users`  | `integer` | No       | Número de usuarios únicos que usaron Copilot cloud agent durante una ventana final de 28 días.                                                                                                                                                                                                       |
| `daily_active_copilot_code_review_users`    | `integer` | No       | Número de usuarios únicos que usaron Copilot code review activamente en un día determinado. El uso activo significa solicitar manualmente una revisión o aplicar una sugerencia. Cuando un usuario tiene señales activas y pasivas en el mismo período, solo se cuentan como activas.                |
| `weekly_active_copilot_code_review_users`   | `integer` | No       | Número de usuarios únicos que usaron Copilot code review activamente durante una ventana final de siete días. Cuando un usuario tiene señales activas y pasivas en el mismo período, solo se cuentan como activas.                                                                                   |
| `monthly_active_copilot_code_review_users`  | `integer` | No       | Número de usuarios únicos que usaron Copilot code review activamente durante una ventana final de 28 días. Cuando un usuario tiene señales activas y pasivas en el mismo período, solo se cuentan como activas.                                                                                      |
| `daily_passive_copilot_code_review_users`   | `integer` | No       | Número de usuarios únicos a quienes se les asignó automáticamente Copilot code review para revisar la solicitud de incorporación de cambios en un día determinado, sin participación activa.                                                                                                         |
| `weekly_passive_copilot_code_review_users`  | `integer` | No       | Número de usuarios únicos a los que se les asignó automáticamente la Copilot code review para revisar su solicitud de incorporación de cambios durante una ventana de siete días consecutivos, sin interacción activa.                                                                               |
| `monthly_passive_copilot_code_review_users` | `integer` | No       | Número de usuarios únicos a los que se les asignó automáticamente la Copilot code review para revisar su solicitud de incorporación de cambios durante una ventana de 28 días consecutivos, sin interacción activa.                                                                                  |
| `daily_active_cli_users`                    | `integer` | Sí       | Número de usuarios únicos que usaron Copilot CLI en un día determinado. Este recuento es **independiente** de los recuentos de usuarios activos del IDE y **no** se incluye en las definiciones de usuario activo basadas en IDE. Se omite para empresas u organizaciones sin uso de la CLI ese día. |
| `daily_active_copilot_app_users`            | `integer` | Sí       | Número de usuarios únicos que utilizaron Copilot app en un día determinado. Null cuando la empresa u organización no tiene actividad Copilot app ese día.                                                                                                                                            |

Totales y desgloses de actividad:

| Campo                              | Tipo      | Anulable | Description                                                                                                                                                                                                                                                |
| :--------------------------------- | :-------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_initiated_interaction_count` | `integer` | No       | Número total de solicitudes explícitas enviadas a Copilot todos los usuarios durante el día.                                                                                                                                                               |
| `code_generation_activity_count`   | `integer` | No       | Número total de distintos eventos de salida Copilot generados entre todos los usuarios durante el día.                                                                                                                                                     |
| `code_acceptance_activity_count`   | `integer` | No       | Número total de sugerencias o bloques de código aceptados en todos los usuarios durante el día.                                                                                                                                                            |
| `loc_suggested_to_add_sum`         | `integer` | No       | Líneas de código agregadas sugeridas para agregar durante el día. La misma definición que el campo por usuario.                                                                                                                                            |
| `loc_suggested_to_delete_sum`      | `integer` | No       | Líneas de código agregadas sugeridas para eliminar durante el día. La misma definición que el campo por usuario.                                                                                                                                           |
| `loc_added_sum`                    | `integer` | No       | Líneas de código agregadas durante el día. La misma definición que el campo por usuario.                                                                                                                                                                   |
| `loc_deleted_sum`                  | `integer` | No       | Líneas de código agregadas eliminadas durante el día. La misma definición que el campo por usuario.                                                                                                                                                        |
| `totals_by_ide`                    | `array`   | No       | Desglose de la actividad agregada por IDE. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                                       |
| `totals_by_feature`                | `array`   | No       | Desglose agregado de la actividad por funcionalidad. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                             |
| `totals_by_language_feature`       | `array`   | No       | Desglose agregado de la actividad por idioma y función. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                          |
| `totals_by_language_model`         | `array`   | No       | Desglose agregado de la actividad por idioma y modelo. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                                           |
| `totals_by_model_feature`          | `array`   | No       | Desglose agregado de la actividad del modelo y de las características. Consulte [Objetos de desglose de actividad](#activity-breakdown-objects).                                                                                                           |
| `totals_by_cli`                    | `object`  | Sí       | Métricas agregadas Copilot CLI para el día. Se omite cuando no hay ningún uso de la CLI ese día. A diferencia del formulario por usuario, no incluye `last_known_cli_version`. Consulte [Copilot CLI los campos de métricas](#copilot-cli-metrics-fields). |
| `totals_by_copilot_app`            | `object`  | Sí       | Métricas agregadas Copilot app para el día. Null cuando la empresa u organización no tiene actividad Copilot app ese día. Consulte [Copilot app los campos de métricas](#copilot-app-metrics-fields).                                                      |
| `totals_by_3rd_party_agent`        | `array`   | Sí       | Métricas de uso agregadas por agente para elementos reconocidosagent apps. Se omite cuando la empresa o la organización no tenían actividad reconocida agent app ese día. Consulte [Agent apps los campos de métricas](#agent-apps-metrics-fields).        |
| `totals_by_ai_adoption_phase`      | `array`   | Sí       | Agregados por fase de los usuarios y su actividad media. Se omite cuando no hay datos en fase de adopción disponibles. Consulte [campos de la fase de adopción de IA](#ai-adoption-phase-fields).                                                          |
| `pull_requests`                    | `object`  | No       | Actividad diaria de solicitudes de incorporación de cambios para la empresa u organización. Consulte [los campos de actividad de la pull request](#pull-request-activity-fields).                                                                          |

### Campos de informe de 28 días

Los informes de 28 días (`enterprise-28-day` y `org-28-day`) son envoltorios: contienen el periodo de referencia en el nivel superior y una matriz de registros agregados diarios.

| Campo              | Tipo     | Anulable | Description                                                                                                                                                                                                                                |
| :----------------- | :------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `report_start_day` | `string` | No       | Primer día natural del periodo de informe de 28 días, con el formato `YYYY-MM-DD`.                                                                                                                                                         |
| `report_end_day`   | `string` | No       | Último día natural del periodo de generación de informes de 28 días, en formato `YYYY-MM-DD`.                                                                                                                                              |
| `created_at`       | `string` | No       | Marca de tiempo (ISO 8601) cuando se generó el informe.                                                                                                                                                                                    |
| `day_totals`       | `array`  | No       | Matriz de registros agregados diarios. Cada entrada tiene los mismos campos que un informe agregado de 1 día. Consulte [Campos agregados del informe de empresa y de organización](#aggregated-enterprise-and-organization-report-fields). |

### Campos de equipos de usuarios

Estos campos aparecen en el informe diario de equipos de usuario (disponible a través de la API REST en los ámbitos de la organización y de la empresa) y se usan para construir métricas de nivel de equipo mediante la combinación con el informe de métricas de uso por usuario. Para obtener la receta de combinación completa y las direcciones URL del punto de conexión, consulte [Métricas de uso de Copilot a nivel de equipo](/es/copilot/reference/copilot-usage-metrics/team-level-metrics).

Los equipos con menos de 5 usuarios con puesto Copilot en un día determinado se excluyen del informe de equipos de usuario.

| Campo                                     | Tipo      | Anulable | Description                                                                                                                                                                    |
| :---------------------------------------- | :-------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`                                 | `integer` | No       | Identificador único para el usuario.                                                                                                                                           |
| `user_login`                              | `string`  | No       |                                                                                                                                                                                |
| GitHub nombre de usuario para el usuario. |           |          |                                                                                                                                                                                |
| `day`                                     | `string`  | No       | Día del calendario que este registro representa.                                                                                                                               |
| `organization_id`                         | `string`  | No       | Identificador único de la organización a la que pertenece el equipo. Solo ámbito de la organización.                                                                           |
| `enterprise_id`                           | `string`  | No       | Identificador único de la empresa a la que pertenece el equipo. Solo para empresas. El informe de ámbito empresarial incluye tanto equipos de empresa como equipos de negocio. |
| `team_id`                                 | `integer` | No       | Identificador único del equipo al que pertenece el usuario.                                                                                                                    |
| `slug`                                    | `string`  | No       | Identificador apto para URL del equipo.                                                                                                                                        |

### Campos de nivel de repositorio (solo API)

Los informes a nivel de repositorio muestran la actividad diaria de creación, revisión, fusión y sugerencias de solicitudes de incorporación de cambios de los repositorios de una organización o empresa, incluidas las solicitudes de incorporación de cambios creadas por Copilot cloud agent y revisadas por Copilot code review. Cada fila representa un repositorio que tenía actividad de solicitud de incorporación de cambios en el día solicitado; los repositorios sin actividad se omiten. Estos informes se centran en la actividad del ciclo de vida de las solicitudes de incorporación de cambios y pueden contener datos incluso cuando las métricas de uso del IDE no están presentes.

Estos campos los devuelve el informe diario a nivel de repositorio (`repos-1-day`), disponible a través de la API REST en los ámbitos de la organización y de la empresa. Para ver las direcciones URL del punto de conexión, el sobre de respuesta, los permisos y el flujo de trabajo de descarga, consulte [Puntos de conexión de api REST para métricas de uso de Copilot](/es/rest/copilot/copilot-usage-metrics). Para ver filas de ejemplo, consulte [Esquema de ejemplo para métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/example-schema#repository-level-schema-example).

| Campo             | Tipo      | Anulable | Description                                                                                                                                                                                                                             |
| :---------------- | :-------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `day`             | `string`  | No       | Día del calendario que representa este registro, en `YYYY-MM-DD` formato.                                                                                                                                                               |
| `enterprise_id`   | `string`  | No       | Identificador único de la empresa. Rellenado en informes de ámbito empresarial y en informes de ámbito de organización para organizaciones que pertenecen a una empresa. Vacío para las organizaciones que no pertenecen a una empresa. |
| `organization_id` | `string`  | No       | Identificador único de la organización que posee el repositorio. Incluidos en informes de ámbito empresarial y de organización.                                                                                                         |
| `repo_id`         | `integer` | No       | Identificador único del repositorio.                                                                                                                                                                                                    |
| `repo_owner_name` | `string`  | No       | Inicio de sesión del propietario del repositorio.                                                                                                                                                                                       |
| `repo_name`       | `string`  | No       | Nombre del repositorio.                                                                                                                                                                                                                 |
| `repo_visibility` | `string`  | No       | Visibilidad del repositorio. Los valores posibles son `PRIVATE`, `INTERNAL` y `PUBLIC`.                                                                                                                                                 |
| `pull_requests`   | `object`  | No       | Actividad diaria de solicitudes de extracción del repositorio. Consulte [los campos de actividad de la pull request](#pull-request-activity-fields).                                                                                    |

### Objetos de desglose de actividad

Los `totals_by_*` campos son matrices de objetos de desglose. La matriz siempre está presente, pero puede estar vacía. Dentro de cada objeto, los campos métricos (`*_count` y `loc_*_sum`) siguen las mismas definiciones que los campos por usuario del nivel superior, y los campos de dimensión contienen los valores documentados en [Valores de la dimensión de desglose](#breakdown-dimension-values).

| Objeto                         | Campos de dimensión                                                                            | Description                                                                                                                         |
| :----------------------------- | :--------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| `totals_by_ide[]`              | `ide`                                                                                          | Desglose por IDE. En los informes por usuario, cada entrada también incluye `last_known_ide_version` y `last_known_plugin_version`. |
| `totals_by_feature[]`          | `feature`                                                                                      | Desglose por Copilot característica (por ejemplo, chat en línea o panel de chat).                                                   |
| `totals_by_language_feature[]` |                                                                                                |                                                                                                                                     |
| `language`, `feature`          | Desglose por idioma y función. No incluye `user_initiated_interaction_count`.                  |                                                                                                                                     |
| `totals_by_language_model[]`   |                                                                                                |                                                                                                                                     |
| `language`, `model`            | Desglose que combina idioma y modelo, para la actividad de chat (no para las finalizaciones).  |                                                                                                                                     |
| `totals_by_model_feature[]`    |                                                                                                |                                                                                                                                     |
| `model`, `feature`             | Desglose que combina modelo y función, para la actividad de chat (no para las finalizaciones). |                                                                                                                                     |

En los informes por usuario, cada `totals_by_ide[]` entrada también informa de las versiones del IDE y Copilot Chat de extensión detectadas más recientemente para el usuario.

| Campo                                      | Tipo     | Anulable | Description                                                                                                                                                                                            |
| :----------------------------------------- | :------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `last_known_ide_version`                   | `object` | Sí       | La versión más reciente del IDE detectada para el usuario, identificada como `{ ide_version, sampled_at }`. Se omite en las filas de desglose agregadas, como el grupo otros de IDE con límite máximo. |
| `last_known_ide_version.ide_version`       | `string` | No       | Cadena de versión del IDE. Se muestra cuando `last_known_ide_version` está presente.                                                                                                                   |
| `last_known_ide_version.sampled_at`        | `string` | Sí       | Marca de tiempo (ISO 8601) en la que se tomó la muestra de la versión.                                                                                                                                 |
| `last_known_plugin_version`                | `object` | Sí       | La extensión Copilot más reciente detectada para el usuario, como `{ plugin, plugin_version, sampled_at }`. Se omite para las filas de desglose agregadas.                                             |
| `last_known_plugin_version.plugin`         | `string` | No       | Nombre de extensión (por ejemplo, `copilot` o `copilot-chat`). Se muestra cuando `last_known_plugin_version` está presente.                                                                            |
| `last_known_plugin_version.plugin_version` | `string` | No       | Cadena de la versión de la extensión. Se muestra cuando `last_known_plugin_version` está presente.                                                                                                     |
| `last_known_plugin_version.sampled_at`     | `string` | Sí       | Marca de tiempo (ISO 8601) en la que se tomó la muestra de la versión.                                                                                                                                 |

### Copilot CLI campos métricos

El objeto `totals_by_cli` contiene los siguientes campos anidados cuando hay uso de Copilot CLI; el objeto se omite cuando no se usa la CLI. El uso de la CLI es independiente de las métricas del IDE; **no** se refleja en campos como `totals_by_ide` o `totals_by_feature`. El `last_known_cli_version` objeto solo aparece en informes por usuario.

| Campo                                                                                                 | Tipo      | Anulable | Description                                                                                                                                                                                       |
| :---------------------------------------------------------------------------------------------------- | :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `totals_by_cli.session_count`                                                                         | `integer` | No       | Número de sesiones distintas de la CLI iniciadas en este día.                                                                                                                                     |
| `totals_by_cli.request_count`                                                                         | `integer` | No       | Número total de solicitudes hechas a Copilot por la CLI en este día, incluidas las solicitudes iniciadas por el usuario y las llamadas automatizadas de seguimiento por parte del agente.         |
| `totals_by_cli.prompt_count`                                                                          | `integer` | No       | Número total de solicitudes de usuario, comandos o consultas ejecutadas dentro de una sesión.                                                                                                     |
| `totals_by_cli.token_usage.output_tokens_sum`                                                         | `integer` | No       | Número total de tokens de salida generados en todas las solicitudes de la CLI en este día.                                                                                                        |
| `totals_by_cli.token_usage.prompt_tokens_sum`                                                         | `integer` | No       | Número total de tokens de aviso enviados en todas las solicitudes de la interfaz de línea de comandos en el día de hoy.                                                                           |
| `totals_by_cli.token_usage.avg_tokens_per_request`                                                    | `number`  | Sí       | Número medio de tokens de **salida** y **solicitud** por solicitud de la CLI, calculado como `(output_tokens_sum + prompt_tokens_sum) ÷ request_count`. Null cuando no había solicitudes ese día. |
| `totals_by_cli.last_known_cli_version`                                                                | `object`  | No       | La versión Copilot CLI más reciente detectada para el usuario ese día, como `{ cli_version, sampled_at }`. Solo informes por usuario.                                                             |
| `totals_by_cli.last_known_cli_version.cli_version`                                                    | `string`  | No       |                                                                                                                                                                                                   |
| Copilot CLI cadena de versión. El valor predeterminado es `unknown` si no se detectó ninguna versión. |           |          |                                                                                                                                                                                                   |
| `totals_by_cli.last_known_cli_version.sampled_at`                                                     | `string`  | Sí       | Marca de tiempo (ISO 8601) en la que se tomó la muestra de la versión.                                                                                                                            |

### Copilot app campos métricos

El objeto `totals_by_copilot_app` contiene los siguientes campos anidados cuando existe uso de Copilot app. Aparece en informes por usuario y en informes empresariales agregados; se omite o es null cuando el usuario o la empresa no tenían actividad Copilot app ese día. A diferencia de `totals_by_cli`, la actividad de codificación de Copilot app también se refleja en `totals_by_feature`, `totals_by_model_feature`, `totals_by_language_feature` y `totals_by_language_model` con el valor de característica `copilot_app`, así como en la actividad de código de nivel superior y en las métricas de líneas de código. No hay ningún `last_known_app_version` campo.

| Campo                                                      | Tipo      | Anulable | Description                                                                                                                                                                                                             |
| :--------------------------------------------------------- | :-------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `totals_by_copilot_app.session_count`                      | `integer` | No       | Número de sesiones distintas Copilot app iniciadas en este día.                                                                                                                                                         |
| `totals_by_copilot_app.request_count`                      | `integer` | No       | Número total de peticiones realizadas a Copilot a través de Copilot app en este día, incluidas tanto las indicaciones iniciadas por el usuario como las llamadas de seguimiento automatizadas realizadas por el agente. |
| `totals_by_copilot_app.prompt_count`                       | `integer` | No       | Número total de solicitudes de usuario, comandos o consultas ejecutadas dentro de una sesión.                                                                                                                           |
| `totals_by_copilot_app.token_usage.output_tokens_sum`      | `integer` | No       | Número total de tokens de salida generados en todas las solicitudes Copilot app durante este día.                                                                                                                       |
| `totals_by_copilot_app.token_usage.prompt_tokens_sum`      | `integer` | No       | Número total de tokens de solicitud enviados en todas las Copilot app solicitudes de este día.                                                                                                                          |
| `totals_by_copilot_app.token_usage.avg_tokens_per_request` | `number`  | Sí       | Promedio de tokens de salida y de entrada por Copilot app petición, calculado como `(output_tokens_sum + prompt_tokens_sum) ÷ request_count`. Null cuando no había solicitudes ese día.                                 |

### Agent apps campos métricos

> \[!NOTE]
> Agent apps are currently in versión preliminar pública and subject to change.

La `totals_by_3rd_party_agent` matriz contiene una entrada para cada uno de los reconocidos agent app usados durante el período de informe. Las entradas se agrupan por `agent_id`, y las integraciones que se asignen al mismo agente se combinan. Use `agent_id` como clave de agrupación estable y `agent_name` para mostrar. La matriz se omite cuando no hay ninguna actividad reconocida agent app disponible durante el período de informe.

Estas métricas proceden de la actividad de trabajo del lado servidor. El campo anidado `user_initiated_interaction_count` counts agent app contabiliza los inicios de trabajos y es distinto del campo de nivel superior con el mismo nombre, que contabiliza las solicitudes explícitas de otra telemetría compatible.

| Campo                                                          | Tipo      | Anulable | Description                                                                                                                                                                                                                              |
| :------------------------------------------------------------- | :-------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `totals_by_3rd_party_agent[].agent_name`                       | `string`  | No       | Nombre para mostrar de agent app. El nombre puede cambiar, por lo que se usa `agent_id` para la agrupación.                                                                                                                              |
| `totals_by_3rd_party_agent[].agent_id`                         | `string`  | No       | Identificador estable para el agent app.                                                                                                                                                                                                 |
| `totals_by_3rd_party_agent[].user_initiated_interaction_count` | `integer` | No       | Número de trabajos iniciados por el usuario para el agent app durante el periodo del informe. Cada inicio de trabajo incrementa el recuento una vez.                                                                                     |
| `totals_by_3rd_party_agent[].session_count`                    | `integer` | No       | Suma de recuentos de sesiones distintos y no vacíos para las integraciones asignadas al agente durante el período de informe. Solo se incluye en los informes de empresa y organización agregados; se omite de los informes por usuario. |

### Campos de actividad de la pull request

> \[!IMPORTANT]
> Los informes a nivel de organización y empresa pueden mostrar totales diferentes debido a diferencias en la deduplicación de usuarios y el momento de atribución. Para obtener instrucciones sobre cómo interpretar las métricas de pull requests en diferentes ámbitos, consulte [métricas de uso de GitHub Copilot](/es/copilot/concepts/copilot-usage-metrics/copilot-metrics#interpreting-pull-request-lifecycle-metrics-across-scopes).

El `pull_requests` objeto aparece en informes de empresa y organización agregados y en informes de nivel de repositorio. Registra la creación, revisión y fusión diarias de solicitudes de extracción, así como la actividad relacionada con sugerencias, incluida la actividad realizada por Copilot cloud agent y Copilot code review.

| Campo                                                    | Tipo      | Anulable | Description                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| :------------------------------------------------------- | :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `pull_requests.total_created`                            | `integer` | No       | Número total de pull requests creados en este día. <br/><br/>La creación es un evento único. Cada solicitud de incorporación de cambios solo se cuenta en el día en que se crea.                                                                                                                                                                                                                                                            |
| `pull_requests.total_reviewed`                           | `integer` | No       | Número total de solicitudes de incorporación de cambios revisadas en un día específico. <br/><br/>La misma solicitud de incorporación de cambios puede contarse en varios días si recibe revisiones durante diferentes jornadas. En un solo día, cada solicitud de incorporación de cambios se cuenta una vez, incluso si se producen varias acciones de revisión.                                                                          |
| `pull_requests.total_merged`                             | `integer` | No       | Número total de pull requests fusionadas en este día específico. <br/><br/>La combinación es un evento único. Cada pull request se cuenta únicamente el día que se fusiona.                                                                                                                                                                                                                                                                 |
| `pull_requests.median_minutes_to_merge`                  | `number`  | Sí       | Tiempo medio, en minutos, entre la creación de la solicitud de incorporación de cambios y la combinación de las solicitudes de incorporación de cambios combinadas en este día específico. <br/><br/>La mediana se usa para reducir el impacto de los valores atípicos de las solicitudes de incorporación de cambios que tardan mucho tiempo en completarse. Nulo cuando no se fusionaron solicitudes de incorporación de cambios ese día. |
| `pull_requests.total_suggestions`                        | `integer` | No       | Número total de sugerencias de revisión de solicitudes de incorporación de cambios generadas en este día específico, independientemente del autor.                                                                                                                                                                                                                                                                                          |
| `pull_requests.total_applied_suggestions`                | `integer` | No       | Número total de sugerencias de revisión de solicitudes de incorporación de cambios que se aplicaron en este día específico, independientemente del autor.                                                                                                                                                                                                                                                                                   |
| `pull_requests.total_created_by_copilot`                 | `integer` | No       | Número de solicitudes de incorporación de cambios creadas por Copilot cloud agent en este día concreto.                                                                                                                                                                                                                                                                                                                                     |
| `pull_requests.total_reviewed_by_copilot`                | `integer` | No       | Número de pull requests revisados por Copilot code review en este día específico. <br/><br/>Una solicitud de incorporación de cambios puede contarse en varios días si Copilot code review la revisa en días distintos.                                                                                                                                                                                                                     |
| `pull_requests.total_merged_created_by_copilot`          | `integer` | No       | Número de solicitudes de incorporación de cambios creadas por Copilot cloud agent que se combinaron en este día específico. Cada pull request se cuenta únicamente el día que se fusiona.                                                                                                                                                                                                                                                   |
| `pull_requests.total_merged_reviewed_by_copilot`         | `integer` | No       | Número de solicitudes de incorporación de cambios que combinó y revisó Copilot code review durante el período del informe.                                                                                                                                                                                                                                                                                                                  |
| `pull_requests.median_minutes_to_merge_copilot_authored` | `number`  | Sí       | Tiempo medio, en minutos, entre la creación y la combinación de solicitudes de incorporación de cambios creadas por Copilot cloud agent y combinadas en este día específico. Nulo cuando no se fusionaron dichas solicitudes de incorporación de cambios ese día.                                                                                                                                                                           |
| `pull_requests.median_minutes_to_merge_copilot_reviewed` | `number`  | Sí       | Tiempo medio, en minutos, entre la creación y fusión de pull requests, calculado solo para los pull requests revisados por Copilot code review. Nulo cuando no se fusionaron dichas solicitudes de incorporación de cambios ese día.                                                                                                                                                                                                        |
| `pull_requests.total_copilot_suggestions`                | `integer` | No       | Número de sugerencias de la revisión de solicitudes de incorporación de cambios generadas por Copilot code review en este día específico.                                                                                                                                                                                                                                                                                                   |
| `pull_requests.total_copilot_applied_suggestions`        | `integer` | No       | Número de sugerencias de la revisión de solicitudes de incorporación de cambios generadas por Copilot code review que se aplicaron en este día específico.                                                                                                                                                                                                                                                                                  |
| `pull_requests.copilot_suggestions_by_comment_type`      | `array`   | No       | Recuentos agregados de Copilot code review sugerencias, desglosados por el tipo de comentario asignado (por ejemplo, `security` o `bug_risk`). Cada entrada incluye `comment_type`, `total_copilot_suggestions`y `total_copilot_applied_suggestions`. Siempre está presente, pero puede estar vacío.                                                                                                                                        |

### Campos de la fase de adopción de IA

Copilot agrupa a los usuarios en fases de adopción de IA según su actividad. La información de fase aparece en dos lugares: el objeto por usuario `ai_adoption_phase` y la matriz agregada `totals_by_ai_adoption_phase` . Para conocer los valores de la fase, consulte [Valores de la dimensión de desglose](#breakdown-dimension-values).

#### Lógica de clasificación

Un usuario se clasifica en una fase en función de las Copilot funciones con las que **interactúa**. Un usuario está comprometido con una característica cuando la usa en al menos **dos días distintos dentro de la ventana final de 28 días**. La participación se evalúa a partir de las señales de actividad a nivel de funcionalidad de la tabla siguiente, no directamente a partir de los campos de un solo día `used_*`[por usuario](#per-user-report-fields) ni de `code_acceptance_activity_count`. Las fases se evalúan desde la parte superior hacia abajo y se asigna a un usuario la fase más alta para la que califican.

| Phase                                                                 | Criterios de participación                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| :-------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Sin cohorte (mostrado como "usuarios pasivos" en el panel de impacto) | El usuario no está usando ninguna función que reúna los requisitos para una fase. Esto no significa que el usuario esté inactivo. Un usuario de este grupo puede seguir usando Copilot regularmente y consumiendo solicitudes prémium, pero no ha usado ninguna función que cumpla los requisitos durante al menos dos días distintos dentro del período móvil de 28 días. El caso más común es el uso conversacional de Copilot Chat o del modo agente, registrado como `chat_panel_agent_mode`, que nunca produce actividad de `code_completion` ni de `agent_edit`. Copiar código fuera de una respuesta de chat tampoco genera ninguna señal. |
| Fase 1: Código primero                                                | Ha interactuado con autocompletados de código en línea (el valor `code_completion` de la dimensión `feature`) o con ediciones del agente realizadas directamente en archivos (el valor `agent_edit` de la dimensión `feature`).                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Fase 2: Agente primero                                                | Interactuó con exactamente una superficie de agente basada en GitHub: Copilot CLI (el valor `copilot_cli` de la dimensión `feature`), Copilot cloud agent (`used_copilot_cloud_agent`) o Copilot code review (`used_copilot_code_review_active` o `used_copilot_code_review_passive`). Activos y pasivos Copilot code review se contabilizan juntos como una sola superficie.                                                                                                                                                                                                                                                                     |
| Fase 3: Multiagente                                                   | Interactuó con Copilot app (el valor `copilot_app` de la dimensión `feature`) o interactuó con dos o más de las superficies del agente enumeradas para la Fase 2.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

Un usuario solo necesita interactuar con las señales específicas de una fase para llegar a esa fase. Un usuario no necesita cumplir por sí solo los criterios de la Fase 1 para llegar a la Fase 2 o la Fase 3, aunque en la práctica el uso de interfaces de agente suele coincidir con completaciones o ediciones del agente.

De las interfaces del agente, solo las interfaces propias enumeradas en la tabla afectan a la fase de adopción de la IA de un usuario. La actividad de agent apps, creado por socios, no afecta a la fase. La misma lógica de clasificación se aplica a los informes de empresa y organización, incluidos los informes de 1 día y 28 días.

> \[!NOTE]
> Dado que la clasificación se basa en la interacción a nivel de funcionalidad, cierta actividad no afecta por sí sola a la fase de un usuario. El uso del chat ide (`used_chat`) o el modo de agente (`used_agent`) no califica a un usuario para la fase 1 a menos que genere `code_completion` o `agent_edit` actividad.
>
> Por ejemplo, hacer una pregunta en modo agente sin permitir que Copilot edite tus archivos registra la actividad de `chat_panel_agent_mode`, no de `agent_edit`. Un usuario cuyo uso se limita por completo a conversaciones de este tipo permanece en el grupo No Cohort, aunque use Copilot de forma activa y pueda seguir generando solicitudes prémium. Del mismo modo, `code_acceptance_activity_count` incluye aceptaciones en el chat, como "aplicar al archivo" y el botón **Copiar**, que no son actividad integrada `code_completion`, por lo que no se utiliza para la clasificación. Para obtener más información sobre la `feature` dimensión, vea [Desglose de los valores de dimensión](#breakdown-dimension-values).

La asignación de fase se vuelve a calcular cada día mediante la ventana final de 28 días, por lo que la fase de un usuario puede cambiar de un día a otro a medida que se desplaza su actividad dentro de la ventana. Este es el comportamiento esperado y no indica un error de datos.

El objeto por usuario `ai_adoption_phase` contiene:

| Campo                            | Tipo      | Anulable | Description                                                          |
| :------------------------------- | :-------- | :------- | :------------------------------------------------------------------- |
| `ai_adoption_phase.phase_number` | `integer` | No       | Identificador de fase numérica (por ejemplo, `0` para "No cohorte"). |
| `ai_adoption_phase.phase`        | `string`  | No       | Nombre de la fase legible para humanos.                              |
| `ai_adoption_phase.version`      | `string`  | No       | Versión del modelo de fase de adopción usado (por ejemplo, `v1`).    |

Cada entrada de la matriz agregada `totals_by_ai_adoption_phase` contiene:

| Campo                                       | Tipo      | Anulable | Description                                                                                                                                                                                                          |
| :------------------------------------------ | :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `phase`                                     | `string`  | No       | Nombre de la fase legible para humanos.                                                                                                                                                                              |
| `phase_number`                              | `integer` | No       | Identificador de fase numérica.                                                                                                                                                                                      |
| `total_engaged_users`                       | `integer` | No       | Número de usuarios agrupados en esta fase durante el período.                                                                                                                                                        |
| `avg_user_initiated_interactions`           | `number`  | No       | Promedio de interacciones iniciadas por el usuario en esta fase.                                                                                                                                                     |
| `avg_code_generation_activities`            | `number`  | No       | Actividades de generación de código promedio por usuario en esta fase.                                                                                                                                               |
| `avg_code_acceptance_activities`            | `number`  | No       | Actividades de aceptación de código promedio por usuario en esta fase.                                                                                                                                               |
| `avg_loc_added`                             | `number`  | No       | Líneas medias de código agregadas por usuario en esta fase.                                                                                                                                                          |
| `avg_loc_deleted`                           | `number`  | No       | Líneas medias de código eliminadas por usuario en esta fase.                                                                                                                                                         |
| `avg_pull_requests_reviewed`                | `number`  | No       | Promedio de pull requests revisadas por usuario en esta fase.                                                                                                                                                        |
| `avg_pull_requests_created`                 | `number`  | No       | Promedio de pull requests creadas por cada usuario en esta fase.                                                                                                                                                     |
| `avg_pull_requests_merged`                  | `number`  | No       | Promedio de solicitudes de extracción fusionadas por usuario en esta fase.                                                                                                                                           |
| `total_pull_requests_merged`                | `integer` | No       | Total de solicitudes de extracción fusionadas por los usuarios en esta fase. Se aplica a los informes agregados del día de la organización y los del día de empresa.                                                 |
| `avg_pull_requests_median_minutes_to_merge` | `number`  | No       | Promedio de la mediana de minutos por usuario necesarios para fusionar en esta fase.                                                                                                                                 |
| `avg_pull_requests_minutes_to_review`       | `number`  | No       | Tiempo mediano en minutos desde la creación de la solicitud de extracción hasta la primera revisión, limitado a las solicitudes de extracción fusionadas y atribuido al día de fusión de la solicitud de extracción. |
| `avg_pull_requests_review_cycles`           | `number`  | No       | Número mediano de envíos para revisión (ciclos de revisión) por pull request, limitado a pull requests fusionadas y atribuido al día de fusión del pull request.                                                     |

### Desglose de los valores de dimensión

Los objetos de desglose anteriores usan campos de dimensión cuyos valores proceden de conjuntos fijos. Estos son **valores** de campo, no campos independientes. Por ejemplo, `agent_edit` y los `chat_panel_*_mode` valores son valores del `feature` campo, no campos de nivel superior.

La `feature` dimensión identifica la Copilot característica o el modo al que se atribuye una actividad:

| Valor                                                                                                                                                                  | Description                                                                                                                                                                        |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code_completion`                                                                                                                                                      | Autocompletado de código en línea.                                                                                                                                                 |
| `chat_inline`                                                                                                                                                          | Chat integrado en el editor.                                                                                                                                                       |
| `chat_panel_ask_mode`                                                                                                                                                  | Interacciones del panel de chat con el modo de pregunta seleccionado.                                                                                                              |
| `chat_panel_edit_mode`                                                                                                                                                 | Interacciones del panel de chat con el modo de edición seleccionado.                                                                                                               |
| `chat_panel_agent_mode`                                                                                                                                                | Interacciones del panel de chat con el modo de agente seleccionado.                                                                                                                |
| `chat_panel_plan_mode`                                                                                                                                                 | Interacciones del panel de chat con el modo de plan seleccionado.                                                                                                                  |
| `chat_panel_custom_mode`                                                                                                                                               | Interacciones del panel de chat con un agente personalizado seleccionado.                                                                                                          |
| `chat_panel_unknown_mode`                                                                                                                                              | Interacciones del panel de chat en las que se desconoce el modo.                                                                                                                   |
| `agent_edit`                                                                                                                                                           | Líneas añadidas y eliminadas cuando Copilot (en modo agente y edición) escribe cambios directamente en tus archivos en el IDE. Cuenta también ediciones de agentes personalizados. |
| `agent_edit` no se incluye en las métricas basadas en sugerencias y es posible que no rellene campos de estilo de sugerencia, como `user_initiated_interaction_count`. |                                                                                                                                                                                    |
| `copilot_cli`                                                                                                                                                          | Actividad atribuida a Copilot CLI.                                                                                                                                                 |
| `copilot_app`                                                                                                                                                          | Actividad asignada a la Copilot aplicación.                                                                                                                                        |
| `others`                                                                                                                                                               | Cualquier característica no cubierta por los valores anteriores.                                                                                                                   |

La `ide` dimensión identifica el IDE en el que se produjo una actividad. Esta no es una lista exhaustiva, pero algunos ejemplos de valores observados incluyen `vscode`, , `visualstudio``intellij``eclipse``xcode``neovim`, `vim`, , y .`emacs``zed`

La `model` dimensión identifica el modelo de IA que se usa para la actividad de chat. Los valores incluyen identificadores de modelo específicos (por ejemplo, `gpt-5.4` o `claude-sonnet-4.6`), `auto`, `unknown`y `others`. El valor `auto` representa la actividad en la que se utilizó auto model selection y la solicitud no se atribuyó a un modelo específico.

La dimensión `phase` identifica la fase de adopción de IA en la que se agrupa al usuario: `No Cohort`, `Phase 1`, `Phase 2` o `Phase 3`.