Las 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.
La misma fórmula de unión permite cualquier segmentación a nivel de equipo que necesite: por (team, day), por (team, day, language), por (team, day, IDE), en ventanas móviles, etc.
Recuperando los informes
Los 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 a los que apuntan esas direcciones URL. El equipo de usuario y las filas por usuario están en esos archivos JSON; el punto de conexión rest no los devuelve en línea.
| Informe | Endpoint |
|---|---|
| Equipos de usuario de la organización | GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD |
| Equipos de usuario de empresa | GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD |
| Métricas de uso por usuario de la organización | GET /orgs/{org}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD |
| Métricas de uso por usuario empresariales | GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD |
Cada punto de conexión devuelve una respuesta del formulario:
{
"download_links": [
"https://example.com/copilot-user-teams-report-1.json"
],
"report_day": "2026-05-07"
}
Descargue el archivo en cada dirección URL dentro de la ventana de expiración del vínculo para recuperar las filas de ese informe.
Para 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. 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.
Para 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 a continuación.
Informes implicados
Las 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.
Informes de equipos de usuario
Estos informes enumeran las pertenencias a equipos de cada usuario en un día determinado.
| Informe | Ámbito | Campos clave |
|---|---|---|
organization_user_teams_1_day | Pertenencia al equipo de la organización durante el día. Incluye solo los equipos de la organización. | |
user_id, user_login, day, organization_id, , team_id, slug | ||
enterprise_user_teams_1_day | Afiliación al equipo Enterprise por un día. Incluye tanto equipos corporativos como equipos de negocio. | |
user_id, user_login, day, enterprise_id, , team_id, slug |
Un usuario que pertenece a varios equipos en el mismo día aparece en varias filas, una fila por (user, team) par.
Importante
Los equipos con menos de 5 usuarios sentados Copilot se excluyen de los informes de los equipos de usuario.
Implicaciones:
- 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.
- 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.
- 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 correspondiente al equipo en el resultado de la unión, por lo que su actividad no queda representada en ninguna agregación por equipo.
Informes de métricas de uso por usuario
Estos informes contienen la actividad de Copilot cada usuario durante un día determinado.
| Informe | Ámbito | Campos clave |
|---|---|---|
organization_users_1_day | Una fila por (user_id, day, organization_id) con la actividad del usuario dentro de Copilot esa organización durante el día. | |
user_id, day, organization_id``enterprise_idcontadores de actividad, matrices de desglose | ||
users_1_day | Una fila por (user_id, day, enterprise_id) con la actividad del usuario dentro de Copilot esa empresa durante el día. | |
user_id, day, , enterprise_idcontadores de actividad, matrices de desglose |
Para obtener la lista completa de campos disponibles en estos informes, consulte Datos disponibles en métricas de uso de Copilot.
Advertencia
No una los informes graduales 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.
Informes de nivel de entidad
Los 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.
Example
Este ejemplo mínimo de un extremo a otro genera un día de métricas del equipo de la organización. El JSON que se muestra a continuación para cada informe de entrada es un ejemplo de las filas que encontraría en el archivo descargado de uno de los informes download_links (consulte Captura de los informes anteriores).
Dos usuarios han tenido Copilot actividad el 07/05/2026 en la organización 999:
- Alice (
user_id=1001) pertenece a dos equipos ese día:frontend(team_id=42) ybackend(team_id=43). - Bob (
user_id=1002) solo pertenece afrontend(team_id=42).
Entrada: organization_user_teams_1_day
{"user_id": 1001, "user_login": "alice", "day": "2026-05-07", "organization_id": "999", "team_id": 42, "slug": "frontend"}
{"user_id": 1001, "user_login": "alice", "day": "2026-05-07", "organization_id": "999", "team_id": 43, "slug": "backend"}
{"user_id": 1002, "user_login": "bob", "day": "2026-05-07", "organization_id": "999", "team_id": 42, "slug": "frontend"}
Alice aparece dos veces: una fila por equipo a la que pertenece.
Entrada: organization_users_1_day
{"user_id": 1001, "user_login": "alice", "day": "2026-05-07", "organization_id": "999", "enterprise_id": "13213",
"user_initiated_interaction_count": 50, "code_generation_activity_count": 40, "code_acceptance_activity_count": 12,
"loc_suggested_to_add_sum": 200, "loc_added_sum": 88, "used_chat": true, "used_agent": true, ...}
{"user_id": 1002, "user_login": "bob", "day": "2026-05-07", "organization_id": "999", "enterprise_id": "13213",
"user_initiated_interaction_count": 30, "code_generation_activity_count": 25, "code_acceptance_activity_count": 7,
"loc_suggested_to_add_sum": 80, "loc_added_sum": 24, "used_chat": true, "used_agent": false, ...}
Una fila por (user, day, organization). Los totales de actividad corresponden al día, sumados en el conjunto de todas las superficies.
Resultado combinado y agregado
Realice 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.
| team_id | slug | active_users | code_acceptance_activity_count | loc_added_sum |
|---|---|---|---|---|
| 42 | frontend | 2 | 19 | 112 |
| 43 | backend | 1 | 12 | 88 |
Dos 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.
La 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 a 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.
Creación de métricas de nivel de equipo
Para cualquier segmento de nivel de equipo, se aplican los mismos cuatro pasos.
-
Elija el par de informes.
- Para los equipos de la organización, vincula
organization_user_teams_1_dayconorganization_users_1_day. El identificador de entidad compartida esorganization_id. - Para equipos empresariales y de negocio, empareja
enterprise_user_teams_1_dayconusers_1_day. El identificador de entidad compartida esenterprise_id.
- Para los equipos de la organización, vincula
-
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. -
Filtrar por
dayhasta el día que quieras. Ambos informes tienen el mismodayvalor. -
Agrupar por
team_id(yslugpara el nombre para mostrar del equipo) y agregar. Uso:COUNT(DISTINCT user_id)para recuentos de usuarios distintos, como usuarios activos.SUM(...)para contadores de volumen comocode_generation_activity_count,loc_added_sumyuser_initiated_interaction_count.
La 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.
Corte por lenguaje, IDE, característica o modelo
Los 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 el array correspondiente como parte de la unión, añada las columnas de la dimensión a la agrupación y agregue los contadores por elemento delimitados para esa dimensión.
language y ide se encuentran en arrays independientes, por lo que una tabla cruzada de (language × ide) a nivel de equipo requiere dos consultas que se combinan en la aplicación.
Generación de informes de equipo con ventana móvil
Para generar un informe del equipo con una ventana móvil (por ejemplo, un acumulado de 28 días):
- Llame a los puntos de conexión diarios para cada día en la ventana.
- Únase al informe de métricas de uso por usuario de cada día (
organization_users_1_dayousers_1_day) con el informe de equipos de usuario (organization_user_teams_1_dayoenterprise_user_teams_1_day) del mismo día en(user_id, day, entity_id). - Filtrar
dayen la ventana y quitardayde la agrupación.
Los 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.
La 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 equipos equivocados.
Limitaciones y advertencias
- 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.
- 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.
- 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)las filas combinadas de toda la ventana en lugar de sumar recuentos diarios. - Se realiza un seguimiento de más superficies de características. Los contadores de volumen (
code_generation_activity_count,code_acceptance_activity_county los contadoresloc_*) agregan la actividad en varias interfaces Copilot: autocompletados en línea del IDE, acciones del panel de chat y, en el caso de los contadores de líneas aceptadas, ediciones de agente de Copilote. Para obtener detalles de la cobertura de superficie de cada contador, consulte Datos disponibles en métricas de uso de Copilot. Si anteriormente consultó métricas similares en una interfaz que solo contabilizaba los autocompletados en línea del 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 del cambio. - 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 a nivel de equipo que las vistas anteriores de métricas de equipo no permitían.
Pasos siguientes
- 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.
- 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.
- 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.
