{"meta":{"title":"Métricas de uso de Copilot a nivel de equipo","intro":"Construya métricas de uso de GitHub Copilot a nivel de equipo uniendo el informe diario de usuarios-equipos con el informe diario de métricas de uso por usuario.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/reference","title":"Referencia"},{"href":"/es/copilot/reference/copilot-usage-metrics","title":"Métricas de uso de Copilot"},{"href":"/es/copilot/reference/copilot-usage-metrics/team-level-metrics","title":"Métricas de nivel de equipo"}],"documentType":"article"},"body":"# Métricas de uso de Copilot a nivel de equipo\n\nConstruya métricas de uso de GitHub Copilot a nivel de equipo uniendo el informe diario de usuarios-equipos con el informe diario de métricas de uso por usuario.\n\nLas Copilot API de métricas de uso no publican un único informe de equipo agregado previamente. Las métricas de nivel de equipo se construyen mediante la unión al informe **de equipos de usuario** (que enumera las pertenencias a equipos de cada usuario durante un día determinado) con el informe de **métricas de uso por usuario** (que contiene la actividad de Copilot cada usuario para ese día). La agregación de las filas combinadas mediante `team_id` genera métricas de nivel de equipo.\n\nLa misma fórmula de unión permite cualquier segmentación en el nivel de equipo que necesite: por `(team, day)`, por `(team, day, language)`, por `(team, day, IDE)`, en ventanas móviles, etc.\n\n> \\[!NOTE]\n> Si solo necesitas una vista en la interfaz de usuario de la adopción a nivel de equipo, la asignación entre usuarios y equipos del panel de impacto ofrece de forma nativa datos de cohortes de adopción a nivel de equipo, sin que tengas que crear la unión de datos descrita en este artículo. Consulte [Visualización del panel de impacto de Copilot](/es/copilot/how-tos/administer-copilot/view-impact-dashboard). Utilice la combinación manual que se describe a continuación cuando necesite datos NDJSON sin procesar por equipo, por ejemplo, para informes de BI personalizados o métricas por equipo más allá de las cohortes de adopción.\n\n## Recuperando los informes\n\nLos dos informes a los que se hace referencia en esta guía se descargan en dos pasos. En primer lugar, llame al extremo REST correspondiente al día que desee. El punto de conexión devuelve direcciones URL firmadas con tiempo limitado desde las que puede descargar los archivos de informe. A continuación, descargue los archivos JSON (NDJSON) delimitados por la nueva línea a los que apuntan esas direcciones URL. Los equipos de usuarios y las filas por usuario se encuentran en esos archivos NDJSON; el punto de conexión REST no los devuelve alineados.\n\n| Informe                                        | Endpoint                                                                                |\n| :--------------------------------------------- | :-------------------------------------------------------------------------------------- |\n| Equipos de usuario de la organización          | `GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD`               |\n| Equipos de usuario de empresa                  | `GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD` |\n| Métricas de uso por usuario de la organización | `GET /orgs/{org}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD`                    |\n| Métricas de uso por usuario empresariales      | `GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD`      |\n\nCada punto de conexión devuelve una respuesta del formulario:\n\n```json\n{\n  \"download_links\": [\n    \"https://example.com/copilot-user-teams-report-1.ndjson\"\n  ],\n  \"report_day\": \"2026-05-07\"\n}\n```\n\nDescargue el archivo en cada dirección URL dentro de la ventana de expiración del vínculo para recuperar las filas para ese informe.\n\nPara obtener esquemas de solicitud y respuesta completos, requisitos de autenticación y puntos de conexión relacionados, consulte [Puntos de conexión de api REST para métricas de uso de Copilot](/es/rest/copilot/copilot-usage-metrics). Para obtener información general sobre cómo se definen los campos de métricas de uso individuales, consulte [Datos disponibles en métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n\nPara una ventana de varios días, llame a los puntos de conexión diarios una vez al día y agregue los resultados diarios. Consulte [Crear informes de equipo con ventana móvil](#building-rolling-window-team-reports) a continuación.\n\n## Informes implicados\n\nLas métricas de nivel de equipo proceden de unir dos familias de informes: los informes de equipos de usuario para la pertenencia al equipo y los informes de métricas de uso por usuario para la actividad.\n\n### Informes de equipos de usuario\n\nEstos informes enumeran las pertenencias a equipos de cada usuario en un día determinado.\n\n| Informe                                                                | Ámbito                                                                                                  | Campos clave |\n| :--------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------ | :----------- |\n| `organization_user_teams_1_day`                                        | Pertenencia al equipo de la organización durante el día. Incluye solo los equipos de la organización.   |              |\n| `user_id`, `user_login`, `day`, `organization_id`, , `team_id`, `slug` |                                                                                                         |              |\n| `enterprise_user_teams_1_day`                                          | Afiliación al equipo Enterprise por un día. Incluye tanto equipos corporativos como equipos de negocio. |              |\n| `user_id`, `user_login`, `day`, `enterprise_id`, , `team_id`, `slug`   |                                                                                                         |              |\n\nUn usuario que pertenece a varios equipos en el mismo día aparece en varias filas, una fila por `(user, team)` par.\n\n> \\[!IMPORTANT]\n> **Los equipos con menos de 5 usuarios sentados Copilot se excluyen de los informes de los equipos de usuario.**\n>\n> Implicaciones:\n>\n> * Un equipo con menos de 5 usuarios sentados en un día determinado no aparecerá en el informe de equipos de usuario de ese día, incluso si sus miembros tienen Copilot actividad. La actividad sigue en el informe de métricas de uso por usuario, pero no existe ninguna fila de equipo en el resultado de la combinación.\n> * Un equipo que cruza el umbral durante una ventana de varios días está presente en algunos días y está ausente en otros. Solo los días en que el equipo estaba por encima del umbral contribuyen a sus totales.\n> * Si vuelve a sumar las filas correspondientes al equipo para compararlas con el total de la empresa o de la organización, la suma será inferior al total de la entidad. La diferencia corresponde a la actividad de los usuarios que solo pertenecen a equipos por debajo del umbral: no tienen ninguna fila de equipo en el resultado de la unión, por lo que su actividad no queda representada en ninguna agregación por equipo.\n\n### Informes de métricas de uso por usuario\n\nEstos informes contienen la actividad de Copilot cada usuario durante un día determinado.\n\n| Informe                                                                                         | Ámbito                                                                                                                         | Campos clave |\n| :---------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- | :----------- |\n| `organization_users_1_day`                                                                      | Una fila por `(user_id, day, organization_id)` con la actividad Copilot del usuario dentro de esa organización durante el día. |              |\n| `user_id`, `day`, `organization_id``enterprise_id`contadores de actividad, matrices de desglose |                                                                                                                                |              |\n| `users_1_day`                                                                                   | Una fila por `(user_id, day, enterprise_id)` con la actividad Copilot del usuario dentro de esa organización durante el día.   |              |\n| `user_id`, `day`, , `enterprise_id`contadores de actividad, matrices de desglose                |                                                                                                                                |              |\n\nPara obtener la lista completa de campos disponibles en estos informes, consulte [Datos disponibles en métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n\n> \\[!WARNING]\n> No una los informes continuos de 28 días por usuario (`users_28_day`, `organization_users_28_day`) con el informe diario de equipos de usuario. El informe de equipos de usuario refleja la pertenencia a equipos en un solo día, por lo que, al unir 28 días de actividad con una instantánea de pertenencia de un solo día, se atribuyen los 28 días completos de actividad a los equipos a los que pertenezca el usuario el día en que se realiza la unión. Esto atribuye erróneamente la actividad a los equipos equivocados siempre que la pertenencia a los equipos haya cambiado durante ese periodo. Combine siempre la actividad diaria con los equipos de usuarios diarios y, a continuación, agregue según el intervalo deseado.\n\n### Informes de nivel de entidad\n\nLos informes de nivel de entidad (`enterprise_28_day`, `organization_28_day`, `enterprise_1_day`, `organization_1_day`) son totales agregados previamente para toda la empresa o organización. No incluyen `user_id` ni `team_id`, y no se pueden combinar con el informe de equipos de usuarios para obtener desgloses por equipo. Úselas directamente cuando quieras totales de empresa u organización; para los totales de nivel de equipo, use los equipos de usuario diarios + la combinación diaria por usuario-metrics que se describe a continuación.\n\n## Example\n\nEste ejemplo mínimo de un extremo a otro genera un día de métricas del equipo de la organización. Las filas NDJSON de ejemplo siguientes para cada informe de entrada son como las filas que encontraría en el archivo descargado de uno de los `download_links` de los informes (consulte [Captura de los informes](#fetching-the-reports) más arriba).\n\nDos usuarios han tenido Copilot actividad el 07/05/2026 en la organización `999`:\n\n* **Alice** (`user_id=1001`) pertenece a dos equipos ese día: `frontend` (`team_id=42`) y `backend` (`team_id=43`).\n* **Bob** (`user_id=1002`) solo pertenece a `frontend` (`team_id=42`).\n\n### Entrada: `organization_user_teams_1_day`\n\n```json\n{\"user_id\": 1001, \"user_login\": \"alice\", \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"team_id\": 42, \"slug\": \"frontend\"}\n{\"user_id\": 1001, \"user_login\": \"alice\", \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"team_id\": 43, \"slug\": \"backend\"}\n{\"user_id\": 1002, \"user_login\": \"bob\",   \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"team_id\": 42, \"slug\": \"frontend\"}\n```\n\nAlice aparece dos veces: una fila por equipo a la que pertenece.\n\n### Entrada: `organization_users_1_day`\n\n```json\n{\"user_id\": 1001, \"user_login\": \"alice\", \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"enterprise_id\": \"13213\",\n \"user_initiated_interaction_count\": 50, \"code_generation_activity_count\": 40, \"code_acceptance_activity_count\": 12,\n \"loc_suggested_to_add_sum\": 200, \"loc_added_sum\": 88, \"used_chat\": true,  \"used_agent\": true,  ...}\n{\"user_id\": 1002, \"user_login\": \"bob\",   \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"enterprise_id\": \"13213\",\n \"user_initiated_interaction_count\": 30, \"code_generation_activity_count\": 25, \"code_acceptance_activity_count\": 7,\n \"loc_suggested_to_add_sum\": 80,  \"loc_added_sum\": 24, \"used_chat\": true,  \"used_agent\": false, ...}\n```\n\nUna fila por `(user, day, organization)`. Los totales de actividad corresponden al día, sumados en el conjunto de todas las superficies.\n\n### Resultado combinado y agregado\n\nRealice una combinación interna de los dos informes en `(user_id, day, organization_id)`, luego agrupe por `team_id` y agregue. La `active_users` columna siguiente es una salida de agregación (`COUNT(DISTINCT user_id)`), no un campo en el informe por usuario; las columnas numéricas restantes son sumas de los campos de informe coincidentes.\n\n| team\\_id | campo de datos dinámico | active\\_users | code\\_acceptance\\_activity\\_count | loc\\_added\\_sum |\n| :------- | :---------------------- | :------------ | :-------------------------------- | :-------------- |\n| 42       | frontend                | 2             | 19                                | 112             |\n| 43       | back-end                | 1             | 12                                | 88              |\n\nDos filas de día de equipo, una por equipo. La `frontend` fila agrega tanto la actividad de Alice como la de Bob. La `backend` fila contiene solo la actividad de Alice.\n\nLa actividad de Alice contribuye a **ambos** equipos. Los 12 y 88 de su recuento de filas en `frontend` y otra vez en `backend`. Esto coincide con la intención de las métricas en el nivel de equipo: cada equipo ve la actividad de sus miembros, pero al volver a sumar las dos filas correspondientes a los equipos en un único total de la organización, se cuenta dos veces a Alice. Para los totales de la organización, consulte `organization_users_1_day` directamente sin la unión a los equipos de usuario.\n\n## Creación de métricas de nivel de equipo\n\nPara cualquier segmento de nivel de equipo, se aplican los mismos cuatro pasos.\n\n1. **Elija el par de informes.**\n\n   * Para los equipos de la organización, vincula `organization_user_teams_1_day` con `organization_users_1_day`. El identificador de entidad compartida es `organization_id`.\n   * Para equipos empresariales y de negocio, empareja `enterprise_user_teams_1_day` con `users_1_day`. El identificador de entidad compartida es `enterprise_id`.\n\n2. **Combine los dos informes mediante una combinación interna** en `(user_id, day, entity_id)`. Las tres claves deben coincidir. La unión es uno a varios en el lado del equipo; un usuario de varios equipos coincide con varias filas de equipos de usuario.\n\n3. **Filtrar por `day`** hasta el día que quieras. Ambos informes tienen el mismo `day` valor.\n\n4. **Agrupar por `team_id`** (y `slug` para el nombre para mostrar del equipo) y agregar. Uso:\n\n   * `COUNT(DISTINCT user_id)` para recuentos de usuarios distintos, como usuarios activos.\n   * `SUM(...)` para contadores de volumen como `code_generation_activity_count`, `loc_added_sum`y `user_initiated_interaction_count`.\n\nLa unión es una unión interna: un equipo aparece en el resultado de un día determinado solo si al menos uno de sus miembros tenía actividad ese día. Para enumerar los equipos que no tuvieron actividad ese día, realice una unión externa izquierda a partir del informe de equipos de usuario y considere los contadores nulos como cero.\n\n### Corte por lenguaje, IDE, característica o modelo\n\nLos desgloses por dimensión residen en campos de matriz en cada fila por usuario (`totals_by_ide`, `totals_by_language_feature`, `totals_by_language_model`, `totals_by_model_feature`). Para agrupar por una dimensión, expanda la matriz correspondiente como parte de la unión, agregue las columnas de la dimensión a la agrupación y agregue los contadores por elemento delimitados para esa dimensión.\n`language` y `ide` se encuentran en matrices independientes, por lo que una tabla cruzada de `(language × ide)` en el nivel de equipo requiere dos consultas que se combinan en la aplicación.\n\n### Generar informes de equipo en periodos acumulados\n\nPara generar un informe del equipo en periodos acumulados (por ejemplo, un consolidado de 28 días):\n\n1. Llame a los puntos de conexión diarios para cada día en la ventana.\n2. Únase al informe de métricas de uso por usuario de cada día (`organization_users_1_day` o `users_1_day`) con el informe de equipos de usuario (`organization_user_teams_1_day` o `enterprise_user_teams_1_day`) del mismo día en `(user_id, day, entity_id)`.\n3. Filtrar `day` en la ventana y quitar `day` de la agrupación.\n\nLos contadores de volumen son aditivos entre días; súmelos a lo largo de la ventana. Los recuentos de usuarios distintos se deben evaluar como `COUNT(DISTINCT user_id)` en las filas combinadas de la ventana completa; no se pueden sumar entre recuentos diarios.\n\nLa unión por día es lo que garantiza que la actividad de cada día se atribuye a los equipos que el usuario estaba en **ese día**. Sin ella, los cambios en la pertenencia a los equipos durante ese período atribuyen silenciosamente la actividad a los equipos equivocados.\n\n## Limitaciones y advertencias\n\n* **Los usuarios de varios equipos contribuyen a cada equipo al que pertenecen.** Tenga cuidado al volver a combinar las filas por equipo para obtener un total de la organización o de la empresa: los usuarios que pertenecen a varios equipos se contarán más de una vez. Utilice directamente el informe por usuario (sin combinarlo con los equipos de usuario) para los totales de la organización o de la empresa.\n* **Los equipos por debajo del umbral no aparecen en el informe de equipos de usuario.** Se excluyen los equipos con menos de 5 usuarios sentados Copilot en un día determinado, por lo que su actividad no se representa en los resultados de nivel de equipo aunque la actividad todavía esté en el informe por usuario.\n* **Los recuentos de usuarios distintos no se pueden sumar en días.** Al pasar por encima de una ventana de varios días, evalúe `COUNT(DISTINCT user_id)` sobre las filas combinadas de toda la ventana en lugar de sumar recuentos diarios.\n* **Se realiza un seguimiento de más superficies de características.** Los contadores de volumen (`code_generation_activity_count`, `code_acceptance_activity_count` y los contadores `loc_*`) agregan la actividad en varias interfaces Copilot: autocompletadas en línea del IDE, acciones del panel de chat y, en el caso de los contadores de líneas aceptadas, ediciones de Copilot agent. Para obtener detalles de la cobertura de superficie por contador, consulte [Datos disponibles en métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/copilot-usage-metrics). Si anteriormente consultó métricas similares en una interfaz que solo contabilizaba los autocompletados en línea de IDE, espere valores más altos en estos contadores y vuelva a establecer la línea base en lugar de comparar las métricas a ambos lados de la transición.\n* **Aproveche las nuevas dimensiones.** Los desgloses por IDE, por característica, por `(language, feature)`, por `(language, model)` y por `(model, feature)` están disponibles en cada fila de usuario, lo que permite generar informes en el nivel de equipo que las vistas anteriores de métricas de equipo no permitían.\n\n## Pasos siguientes\n\n* Para obtener el esquema completo y la referencia de campo para el informe de métricas de uso por usuario, consulte [Datos disponibles en métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n* Para obtener un ejemplo de cargas JSON de los puntos de conexión de métricas de uso, consulte [Esquema de ejemplo para métricas de uso de Copilot](/es/copilot/reference/copilot-usage-metrics/example-schema).\n* Para obtener instrucciones sobre la conciliación de métricas en el panel, las API y las exportaciones, consulte [Conciliación de métricas de uso de Copilot en paneles, API e informes](/es/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics)."}