Données disponibles dans les métriques d’utilisation Copilot

Le Copilot tableau de bord et les API des métriques d’utilisation affichent et exportent des données à l’aide d’un ensemble cohérent de champs. Cette référence répertorie toutes les métriques disponibles et décrit comment interpréter leurs valeurs dans les visuels de tableau de bord et les exportations de NDJSON ou d’API.

• Les tableaux de bord des Copilot métriques d’utilisation sont disponibles au niveau de l’entreprise et de l’organisation.
• Les Copilot API de métriques d’utilisation retournent des rapports au niveau de l’entreprise ou de l’organisation , avec des granularités de rapport agrégées, au niveau du référentiel et au niveau de l’utilisateur individuelles . Les formes varient selon l’étendue et la granularité.
• Les métriques au niveau de l’équipe ne sont pas pré-agrégées ; vous les construisez en joignant le rapport des équipes utilisateur au rapport des métriques d’utilisation par utilisateur. Consultez « Métriques d’utilisation Copilot au niveau de l’équipe ».
• Les rapports au niveau du dépôt contiennent un enregistrement par dépôt avec l’activité des pull requests pour le jour demandé. Consultez les champs au niveau du référentiel (API uniquement) plus loin dans cet article.

Pour obtenir des conseils sur la lecture et l’interprétation de ces métriques, consultez Métriques d’utilisation de GitHub Copilot.

Copilot Métriques du tableau de bord d’utilisation

Ces métriques apparaissent directement dans le Copilot tableau de bord d’utilisation. Ces graphiques n’incluent pasCopilot CLI l’utilisation de GitHub Copilot CLI.

Unité de mesure	Descriptif
Adoption de l’agent	Pourcentage d’utilisateurs Copilotactifs sous licence qui ont essayé un agent dans le mois calendaire en cours.
Demandes de conversation moyennes par utilisateur actif	Nombre moyen de demandes de conversation par utilisateur actif.
Complétion de code (proposée/acceptée)	Nombre total de suggestions de code inline affichées et acceptées.
Taux d'acceptation de la complétion de code	Pourcentage de suggestions acceptées par les utilisateurs.
Utilisateurs actifs quotidiens	Nombre d’utilisateurs uniques utilisés Copilot le jour donné.
Utilisateurs actifs hebdomadaires	Nombre d’utilisateurs uniques utilisés Copilot pendant une fenêtre de sept jours.
Nombre total d’utilisateurs actifs	Utilisateurs sous licence actifs dans le mois calendrier actuel.
Utilisation de la langue	Distribution des langages de programmation utilisés avec Copilot.
Utilisation de la langue par jour	Répartition quotidienne des langues utilisées.
Utilisation du modèle	Distribution des modèles IA utilisés pour la conversation.
Utilisation du modèle par jour	Répartition quotidienne de l’utilisation du modèle de conversation.
Utilisation du modèle par mode de conversation	Utilisation du modèle par Copilot fonctionnalité (demander, modifier, planifier, agent).
Utilisation du modèle par langue	Distribution des langues réparties par modèle.
Modèle de conversation le plus utilisé	Le modèle de conversation le plus fréquemment utilisé au cours des 28 derniers jours.
Demandes par mode conversation	Nombre de demandes de conversation par mode (demander, modifier, planifier, agent).

Métriques du tableau de bord Impact

Ces métriques apparaissent dans le tableau de bord d’impact, qui regroupe les utilisateurs en cohortes d’adoption et relie cette adoption à l’activité liée aux pull requests. Pour obtenir des conseils sur l’interprétation des cohortes d’adoption, consultez Métriques d’utilisation de GitHub Copilot.

Unité de mesure	Descriptif
Tendances d’engagement	Comment la répartition par cohorte d’adoption de l’organisation et le débit de requêtes de tirage fusionnées (nombre total de requêtes de tirage fusionnées par mois) ont évolué au cours des six derniers mois.
Distribution de cohorte d’adoption	Partage des utilisateurs sous licence regroupés dans chaque phase d’adoption (utilisateurs passifs, phase 1, phase 2, phase 3) pour la période. Les utilisateurs passifs correspondent à la No Cohort valeur de l’API.
Multiplicateur d’adoption	Compare les utilisateurs engagés (phase 1, 2 ou 3) aux utilisateurs passifs en termes de code livré (pull requests fusionnées par utilisateur et par mois) et de délai de fusion des pull requests, afin de montrer l’impact relatif d’une adoption plus poussée de Copilot.
Recommendations	Actions suggérées, telles que la configuration Copilot cloud agent ou l’activation Copilot code review, en fonction de la distribution actuelle de cohorte de l’organisation.

Métriques de tableau de bord de génération de code

Ces métriques apparaissent dans le tableau de bord de génération de code et fournissent une répartition de la façon dont le code est généré entre l’activité initiée par l’utilisateur et l’activité initiée par l’agent. Toutes les valeurs sont dérivées de lignes de code (LoC) ajoutées ou supprimées dans l’IDE.

Unité de mesure	Descriptif
Lignes de code modifiées avec l’IA	Nombre total de lignes de code ajoutées et supprimées dans tous les modes au cours des 28 derniers jours.
Contribution de l’agent	Pourcentage de lignes de code ajoutées et supprimées par les agents (y compris les modes de modification, d’agent et personnalisés) au cours des 28 derniers jours.
Nombre moyen de lignes supprimées par agent	Nombre moyen de lignes supprimées automatiquement par les agents pour le compte des utilisateurs actifs pendant le mois calendrier actuel.
Total quotidien des lignes ajoutées et supprimées	Nombre total de lignes ajoutées et supprimées de la base de code sur tous les modes pour chaque jour.
Modifications du code initiées par l’utilisateur	Lignes suggérées ou ajoutées manuellement par les utilisateurs via des complétions de code et la fenêtre de chat (insertion, copie ou application).
Modifications du code initiées par l’agent	Lignes automatiquement ajoutées ou supprimées de la base de code par les agents pour le compte des utilisateurs dans les modes de modification, d’agent et personnalisés.
Modifications de code initiées par l’utilisateur par modèle	Lignes de code initiées par l’utilisateur, regroupées par modèle utilisées dans l’IDE.
Modifications de code initiées par l’agent par modèle	Lignes de code initiées par l’agent, regroupées par modèle effectuant les actions de l’agent.
Modifications de code initiées par l’utilisateur par langue	Lignes de code initiées par l’utilisateur, regroupées par langage de programmation.
Modifications de code initiées par l’agent par langue	Lignes de code initiées par l’agent, regroupées par langage de programmation.

Champs d’API et d’exportation

Ces champs apparaissent dans les rapports NDJSON exportés et dans les Copilot API de métriques d’utilisation. La plupart des tableaux ci-dessous répertorient le nom du champ, son type JSON, si la valeur peut être null et une description.

Les rapports sont fournis sous différentes formes en fonction de leur portée et de leur granularité, de sorte que les champs disponibles dans un enregistrement dépendent du rapport à partir duquel il provient :

• Les rapports par utilisateur (*-users-1-day et *-users-28-day) contiennent un enregistrement par utilisateur, y compris user_id, user_login, , ai_credits_usedles used_* indicateurs et ai_adoption_phase. Ils ne contiennent pas de nombres d’utilisateurs actifs, pull_requestsou totals_by_ai_adoption_phase.
• Les rapports agrégés (enterprise-1-day et org-1-day) contiennent un enregistrement agrégé par entreprise ou organisation, y compris les nombres d’utilisateurs actifs, pull_requestset totals_by_ai_adoption_phase. Ils ne contiennent pas user_id, user_login ou les indicateurs used_*.
• Les rapports de 28 jours (enterprise-28-day et org-28-day) encapsulent un tableau d’enregistrements agrégés quotidiens dans un day_totals champ, avec la fenêtre de création de rapports au niveau supérieur.
• Les rapports d’équipes utilisateur (*-user-teams-1-day) mappent les utilisateurs aux équipes auxquelles ils appartiennent. Vous pouvez donc construire des métriques au niveau de l’équipe.
• Les rapports au niveau du dépôt (*-repos-1-day) contiennent un enregistrement par dépôt, comprenant l’activité des pull requests pour la journée considérée, y compris les pull requests créées par Copilot cloud agent et examinées par Copilot code review.

Les rapports à l’échelle de l’organisation incluent également organization_id aux côtés de enterprise_id. Pour obtenir des exemples de schémas des données retournées par les API, consultez Exemple de schéma pour les métriques d’utilisation de Copilot.

La colonne Type utilise des types de schéma JSON : string, , integer``number, boolean, array, et .object La colonne Nullable indique si la valeur d’un champ peut être null ou absente d’un enregistrement où elle s’appliquerait autrement. Les tableaux de répartition des activités sont toujours présents, mais peuvent être vides ([]). Les tableaux facultatifs sont marqués comme nullables et peuvent être absents.

Champs d’identification et de partition du rapport

Ces champs identifient la portée, la date et, pour les exportations, la partition de chaque enregistrement. L’ensemble exact disponible dépend du type de rapport.

Champ	Type	Nullable	Descriptif
day	string	No	Jour calendaire représenté par cet enregistrement, au format YYYY-MM-DD. Dans les rapports de 28 jours, day apparaît dans chaque day_totals entrée plutôt qu’au niveau supérieur.
enterprise_id	string	No	ID unique de l’entreprise. Inclus dans les rapports à l’échelle de l’entreprise et de l’organisation.
organization_id	string	Oui	ID unique de l’organisation. Inclus dans les rapports d’étendue de l’organisation uniquement ; omis dans les rapports d’étendue d’entreprise.
etl_id / day_partition	string	No	Champs de partition utilisés pour les tâches de maintenance. Inclus dans les fichiers NDJSON exportés et retournés par les API de métriques d’utilisation.
entity_id_partition	integer	No	Partition d'entité utilisée pour les tâches de maintenance. Inclus dans les fichiers NDJSON exportés et retournés par les API de métriques d’utilisation.

Champs de rapport par utilisateur

Les rapports par utilisateur contiennent un enregistrement par utilisateur pour la période de rapport. Le rapport par utilisateur sur 28 jours inclut également report_start_day et report_end_day pour marquer la période de rapport.

Champ	Type	Nullable	Descriptif
user_id	integer	No	Identificateur unique de l’utilisateur.
user_login	string	No
GitHub nom d’utilisateur de l’utilisateur.
ai_credits_used	number	No	Total des crédits IA consommés par l’utilisateur au cours de la période de rapport. Ce champ est inclus dans les rapports par utilisateur uniquement et n’est pas décomposé par fonctionnalité, modèle ou surface. Cette métrique concerne l’analyse de la consommation, et non les totaux de facturation.
user_initiated_interaction_count	integer	No	Nombre d’invites explicites envoyées à Copilot. Compte uniquement les messages ou les invites activement envoyés au modèle. N’inclut pas l’ouverture du panneau de conversation, le changement de mode (par exemple, demander, modifier, planifier ou agent), l'utilisation de raccourcis clavier pour ouvrir l'interface utilisateur en ligne, ou l'apport de modifications de configuration.
code_generation_activity_count	integer	No	Nombre d’événements de sortie distincts Copilot générés.
Comprend: Tout le contenu généré, y compris les commentaires et les documents.
Plusieurs blocs : Chaque bloc de code distinct d’une invite d’utilisateur unique compte comme une génération distincte.
Note: Cette métrique n’est pas directement comparable à user_initiated_interaction_count, car une invite peut produire plusieurs générations.
code_acceptance_activity_count	integer	No	Nombre de suggestions ou de blocs de code acceptés par les utilisateurs.
Comptes: Toutes les actions d’acceptation intégrées, telles que « appliquer au fichier », « insérer au curseur », « insérer dans le terminal », ainsi que l'utilisation du bouton Copier.
Ne comptabilise pas : les actions manuelles du presse-papiers du système d’exploitation (par exemple, Ctrl+C).
Granularité: Chaque action d’acceptation incrémente le nombre une fois, quel que soit le nombre de blocs de code générés par l’invite initiale.
loc_suggested_to_add_sum	integer	No	Lignes de code que Copilot a suggéré d'ajouter (complétions, discussion en ligne, panneau de discussion, etc. ; hors modifications effectuées par l'agent).
loc_suggested_to_delete_sum	integer	No	Lignes de code Copilot suggérées pour supprimer (prise en charge ultérieure planifiée).
loc_added_sum	integer	No	Lignes de code réellement ajoutées à l’éditeur (achèvements acceptés, blocs de code appliqués, agent et mode d’édition).
loc_deleted_sum	integer	No	Lignes de code supprimées dans l’éditeur (actuellement issues des modifications de l’assistant).
used_agent	boolean	No	Si l’utilisateur a utilisé le mode agent dans l’IDE ce jour-là. N’inclut pas l’activité Copilot code review , qui est capturée séparément dans used_copilot_code_review_active et used_copilot_code_review_passive.
used_chat	boolean	No	Indique si l’utilisateur a utilisé la conversation IDE ce jour-là.
used_cli	boolean	No	Indique si l’utilisateur a utilisé Copilot CLI ce jour-là.
used_copilot_app	boolean	No	Indique si l’utilisateur a utilisé ce Copilot app jour-là.
used_copilot_coding_agent	boolean	No	Indique si l’utilisateur a utilisé Copilot cloud agent (précédemment Copilot agent de codage) ce jour-là.
used_copilot_cloud_agent	boolean	No	Indique si l’utilisateur a utilisé Copilot cloud agent ce jour-là. Porte la même valeur que used_copilot_coding_agent; les deux noms sont conservés pour la compatibilité descendante.
used_copilot_code_review_active	boolean	Oui	Indique si l’utilisateur s’est engagé activement avec Copilot code review ce jour-là. Un utilisateur est considéré comme actif s’il a demandé manuellement une Copilot révision ou appliqué une Copilot suggestion de révision. Null lorsqu’il n’y a aucun Copilot code review signal pour l’utilisateur ce jour-là.
used_copilot_code_review_passive	boolean	Oui	Indique si Copilot a été automatiquement affecté à l'utilisateur pour examiner sa demande de tirage ce jour-là, sans qu'il participe activement à la revue. Null lorsqu’il n’y a aucun Copilot code review signal pour l’utilisateur ce jour-là.
ai_adoption_phase	object	No	Phase d'adoption de l'IA de l'utilisateur pour la journée. Toujours présent ; correspond par défaut à la phase « Aucune cohorte ». Consultez les champs de la phase d’adoption de l’IA.
totals_by_cli	object	Oui	Métriques spécifiques à l’interface CLI pour l’utilisateur. Est omis lorsque l’utilisateur n’a eu aucune utilisation de Copilot CLI ce jour. Consultez Copilot CLI les champs des métriques.
totals_by_copilot_app	object	Oui
Copilot app Métriques pour l’utilisateur. Est omis lorsque l’utilisateur n’a eu aucune utilisation de Copilot app ce jour. Consultez Copilot app les champs des métriques.
totals_by_3rd_party_agent	array	Oui	Métriques d’utilisation par agent pour les agent apps reconnus. Omis lorsque l’utilisateur n’avait aucune activité reconnue agent app pendant la période de rapport. Consultez Agent apps les champs des métriques.
totals_by_ide	array	No	Répartition de l’activité de l’utilisateur par EDI. Consultez les objets de répartition des activités.
totals_by_feature	array	No	Répartition par fonctionnalité de l’activité de l’utilisateur. Consultez les objets de répartition des activités.
totals_by_language_feature	array	No	Répartition de la combinaison des dimensions de langage et de fonctionnalité. Consultez les objets de répartition des activités.
totals_by_language_model	array	No	Répartition par langue et par modèle pour l’activité de chat. Consultez les objets de répartition des activités.
totals_by_model_feature	array	No	Répartition de la combinaison de dimensions de modèle et de fonctionnalité, pour l’activité de conversation. Consultez les objets de répartition des activités.

Champs de rapport d’entreprise et d’organisation agrégés

Les rapports agrégés contiennent un enregistrement par entreprise ou organisation, récapitunant tous les utilisateurs pour la journée. Les nombres d’utilisateurs actifs incluent les utilisateurs identifiés par le biais de données de télémétrie côté client et côté serveur. Les utilisateurs exposés uniquement par le biais de données de télémétrie côté serveur sont comptabilisés dans les totaux des utilisateurs actifs, mais peuvent ne pas apparaître dans les tableaux de répartition dimensionnelle (totals_by_ideet totals_by_featuresimilaires). Les tableaux suivants répertorient les nombres d’utilisateurs actifs, puis les totaux d’activité et les répartitions.

Nombres d’utilisateurs actifs :

Champ	Type	Nullable	Descriptif
daily_active_users	integer	No	Nombre d’utilisateurs uniques utilisés Copilot le jour donné.
weekly_active_users	integer	No	Nombre d’utilisateurs uniques ayant utilisé Copilot sur une période glissante de sept jours.
monthly_active_users	integer	No	Nombre d’utilisateurs uniques ayant utilisé Copilot sur une période glissante de 28 jours.
monthly_active_chat_users	integer	No	Nombre d’utilisateurs uniques ayant utilisé le chat sur les 28 derniers jours.
monthly_active_agent_users	integer	No	Nombre d’utilisateurs uniques qui ont utilisé le mode agent pendant une fenêtre de fin de 28 jours.
daily_active_copilot_cloud_agent_users	integer	No	Nombre d’utilisateurs uniques utilisés Copilot cloud agent le jour donné.
weekly_active_copilot_cloud_agent_users	integer	No	Nombre d’utilisateurs uniques ayant utilisé Copilot cloud agent sur une période glissante de sept jours.
monthly_active_copilot_cloud_agent_users	integer	No	Nombre d’utilisateurs uniques ayant utilisé Copilot cloud agent sur une période glissante de 28 jours.
daily_active_copilot_code_review_users	integer	No	Nombre d’utilisateurs uniques qui utilisaient Copilot code review activement un jour donné. L’utilisation active signifie demander manuellement une révision ou appliquer une suggestion. Lorsqu’un utilisateur a des signaux actifs et passifs dans la même période, ils sont comptabilisés comme actifs uniquement.
weekly_active_copilot_code_review_users	integer	No	Nombre d’utilisateurs uniques qui ont utilisé activement Copilot code review pendant une fenêtre glissante de sept jours. Lorsqu’un utilisateur a des signaux actifs et passifs dans la même période, ils sont comptabilisés comme actifs uniquement.
monthly_active_copilot_code_review_users	integer	No	Nombre d’utilisateurs uniques qui ont activement utilisé Copilot code review pendant une fenêtre de fin de 28 jours. Lorsqu’un utilisateur a des signaux actifs et passifs dans la même période, ils sont comptabilisés comme actifs uniquement.
daily_passive_copilot_code_review_users	integer	No	Nombre d’utilisateurs uniques à qui Copilot code review a été automatiquement attribué pour réviser leur pull request un jour donné, sans engagement actif.
weekly_passive_copilot_code_review_users	integer	No	Nombre d’utilisateurs uniques pour lesquels Copilot code review a été automatiquement assigné à la revue de leur pull request pendant une fenêtre glissante de sept jours, sans engagement actif.
monthly_passive_copilot_code_review_users	integer	No	Nombre d’utilisateurs uniques pour lesquels Copilot code review a été automatiquement assigné à la revue de leur pull request pendant une fenêtre glissante de 28 jours, sans engagement actif.
daily_active_cli_users	integer	Oui	Nombre d’utilisateurs uniques utilisés Copilot CLI le jour donné. Ce nombre est indépendant du nombre d’utilisateurs actifs de l’IDE et n’est pas inclus dans les définitions active-utilisateur basées sur l’IDE. Omis pour les entreprises ou les organisations sans utilisation de l’interface CLI ce jour-là.
daily_active_copilot_app_users	integer	Oui	Nombre d’utilisateurs uniques qui utilisaient le Copilot app jour donné. Null lorsque l’entreprise ou l’organisation n’a aucune Copilot app activité ce jour-là.

Totaux et répartitions des activités :

Champ	Type	Nullable	Descriptif
user_initiated_interaction_count	integer	No	Nombre total d’invites explicites envoyées à Copilot tous les utilisateurs pour la journée.
code_generation_activity_count	integer	No	Nombre total d’événements de sortie distincts Copilot générés pour tous les utilisateurs pour la journée.
code_acceptance_activity_count	integer	No	Nombre total de suggestions ou de blocs de code acceptés pour tous les utilisateurs pour la journée.
loc_suggested_to_add_sum	integer	No	Nombre total de lignes de code suggérées à ajouter pour la journée. Même définition que le champ par utilisateur.
loc_suggested_to_delete_sum	integer	No	Nombre total de lignes de code dont la suppression est suggérée pour la journée. Même définition que le champ par utilisateur.
loc_added_sum	integer	No	Lignes de code agrégées ajoutées pour la journée. Même définition que le champ par utilisateur.
loc_deleted_sum	integer	No	Lignes agrégées de code supprimées pour le jour. Même définition que le champ par utilisateur.
totals_by_ide	array	No	Répartition agrégée des activités par IDE. Consultez les objets de répartition des activités.
totals_by_feature	array	No	Répartition agrégée de l'activité par fonctionnalité. Consultez les objets de répartition des activités.
totals_by_language_feature	array	No	Répartition des activités de langage et de fonctionnalité agrégées. Consultez les objets de répartition des activités.
totals_by_language_model	array	No	Répartition agrégée de l’activité par langue et par modèle. Consultez les objets de répartition des activités.
totals_by_model_feature	array	No	Répartition agrégée des activités de modèle et de fonctionnalité. Consultez les objets de répartition des activités.
totals_by_cli	object	Oui	Métriques agrégées Copilot CLI pour la journée. Omis lorsqu’il n’y a pas d’utilisation de l’interface CLI ce jour-là. Contrairement au formulaire individuel, il n’inclut pas last_known_cli_version. Consultez Copilot CLI les champs des métriques.
totals_by_copilot_app	object	Oui	Métriques agrégées Copilot app pour la journée. Null lorsque l’entreprise ou l’organisation n’a aucune Copilot app activité ce jour-là. Consultez Copilot app les champs des métriques.
totals_by_3rd_party_agent	array	Oui	Métriques d’utilisation agrégées par agent pour les agent apps reconnus. Omis lorsque l’entreprise ou l’organisation n’avait aucune activité reconnue agent app ce jour-là. Consultez Agent apps les champs des métriques.
totals_by_ai_adoption_phase	array	Oui	Agrégats par phase des utilisateurs et de leur activité moyenne. Omis lorsqu’aucune donnée de phase d’adoption n’est disponible. Consultez les champs de la phase d’adoption de l’IA.
pull_requests	object	No	Activité quotidienne des pull requests pour l’entreprise ou l’organisation. Consultez les champs d’activité des pull requests.

Champs du rapport sur 28 jours

Les rapports sur 28 jours (enterprise-28-day et org-28-day) sont des enveloppes : ils contiennent la fenêtre de création de rapports au niveau supérieur et un tableau d'enregistrements agrégés quotidiens.

Champ	Type	Nullable	Descriptif
report_start_day	string	No	Premier jour calendaire de la fenêtre de rapport de 28 jours, au format YYYY-MM-DD.
report_end_day	string	No	Dernier jour civil de la période de référence de 28 jours, au format YYYY-MM-DD.
created_at	string	No	Horodatage (ISO 8601) auquel le rapport a été généré.
day_totals	array	No	Tableau d’enregistrements agrégés quotidiens. Chaque entrée a les mêmes champs qu’un rapport agrégé de 1 jour. Consultez les champs de rapport d’entreprise et d’organisation agrégés.

Champs des équipes d’utilisateurs

Ces champs apparaissent dans le rapport quotidien des équipes utilisateur (disponibles via l’API REST au niveau de l’organisation et des étendues d’entreprise) et sont utilisés pour construire des métriques au niveau de l’équipe en se joignant au rapport des métriques d’utilisation par utilisateur. Pour obtenir la recette de jointure complète et les URL de point de terminaison, consultez Métriques d’utilisation Copilot au niveau de l’équipe.

Les équipes avec moins de 5 utilisateurs assis Copilot sur une journée donnée sont exclues du rapport des équipes utilisateur.

Champ	Type	Nullable	Descriptif
user_id	integer	No	Identificateur unique de l’utilisateur.
user_login	string	No
GitHub nom d’utilisateur de l’utilisateur.
day	string	No	Cet enregistrement représente le jour du calendrier.
organization_id	string	No	ID unique de l’organisation à laquelle appartient l’équipe. Portée de l'organisation uniquement.
enterprise_id	string	No	ID unique de l’entreprise auquel appartient l’équipe. Portée Enterprise uniquement. Le rapport au niveau de l’entreprise comprend à la fois les équipes d’entreprise et les équipes métier.
team_id	integer	No	ID unique de l’équipe à laquelle appartient l’utilisateur.
slug	string	No	Identificateur d’équipe compatible avec les URL.

Champs au niveau du référentiel (API uniquement)

Les rapports au niveau du dépôt affichent l’activité quotidienne de création, de révision, de fusion et de suggestion des pull requests pour les dépôts d’une organisation ou d’une entreprise, y compris les pull requests créées par Copilot cloud agent et révisées par Copilot code review. Chaque ligne représente un dépôt ayant eu une activité de pull request à la date demandée ; les dépôts sans activité sont omis. Ces rapports se concentrent sur l’activité liée au cycle de vie des pull requests et peuvent contenir des données même en l’absence de métriques d’utilisation de l’EDI.

Ces champs sont renvoyés par le rapport quotidien au niveau du référentiel (repos-1-day), disponible via l’API REST selon les portées de l’organisation et de l’entreprise. Pour connaître les URL de point de terminaison, l’enveloppe de réponse, les autorisations et le flux de travail de téléchargement, consultez Points de terminaison d’API REST pour les métriques d’utilisation Copilot. Pour obtenir des exemples de lignes, consultez Exemple de schéma pour les métriques d’utilisation de Copilot.

Champ	Type	Nullable	Descriptif
day	string	No	Jour calendaire représenté par cet enregistrement, au format YYYY-MM-DD.
enterprise_id	string	No	ID unique de l’entreprise. Renseignés dans les rapports à l’échelle de l’entreprise et dans les rapports à l’échelle de l’organisation pour les organisations appartenant à une entreprise. Vide pour les organisations non détenues par une entreprise.
organization_id	string	No	ID unique de l’organisation propriétaire du référentiel. Inclus dans les rapports d’entreprise et d’organisation.
repo_id	integer	No	ID unique du référentiel.
repo_owner_name	string	No	Connexion du propriétaire du référentiel.
repo_name	string	No	Nom du référentiel.
repo_visibility	string	No	Visibilité du référentiel. Les valeurs possibles sont PRIVATE, INTERNAL et PUBLIC.
pull_requests	object	No	Activité quotidienne des requêtes de tirage pour le référentiel. Consultez les champs d’activité des pull requests.

Objets de répartition de l'activité

Les totals_by_* champs sont des tableaux d’objets de répartition. Le tableau est toujours présent, mais peut être vide. Dans chaque objet, les champs de mesure (*_count et loc_*_sum) suivent les mêmes définitions que les champs par utilisateur de niveau supérieur, et les champs de dimension contiennent les valeurs décrites dans Valeurs de la dimension de répartition.

Object	Champs de dimension	Descriptif
totals_by_ide[]	ide	Répartition par IDE. Dans les rapports par utilisateur, chaque entrée comprend également last_known_ide_version et last_known_plugin_version.
totals_by_feature[]	feature	Répartition par Copilot fonctionnalité (par exemple, conversation inline ou panneau de conversation).
totals_by_language_feature[]
language, feature	Répartition de la combinaison du langage et de la fonctionnalité. N’inclut pas user_initiated_interaction_count.
totals_by_language_model[]
language, model	Répartition combinant le langage et le modèle pour l'activité de discussion (et non les complétions).
totals_by_model_feature[]
model, feature	Répartition combinant le modèle et la fonctionnalité, pour l’activité de chat (pas les complétions).

Dans les rapports par utilisateur, chaque totals_by_ide[] entrée signale également les versions d’IDE et Copilot Chat d’extension les plus récentes détectées pour l’utilisateur.

Champ	Type	Nullable	Descriptif
last_known_ide_version	object	Oui	Version de l’IDE la plus récente détectée pour l’utilisateur, en tant que { ide_version, sampled_at }. Omis pour les lignes de répartition agrégées, comme le compartiment IDE « autres » plafonné.
last_known_ide_version.ide_version	string	No	Chaîne de version de l’IDE. Présent lorsque last_known_ide_version est présent.
last_known_ide_version.sampled_at	string	Oui	Horodatage (ISO 8601) auquel la version a été échantillonnée.
last_known_plugin_version	object	Oui	Dernière extension Copilot détectée pour l’utilisateur, sous le nom { plugin, plugin_version, sampled_at }. Omis pour les lignes de répartition agrégées.
last_known_plugin_version.plugin	string	No	Nom de l’extension (par exemple, copilot ou copilot-chat). Présent lorsque last_known_plugin_version est présent.
last_known_plugin_version.plugin_version	string	No	Chaîne de version de l'extension. Présent lorsque last_known_plugin_version est présent.
last_known_plugin_version.sampled_at	string	Oui	Horodatage (ISO 8601) auquel la version a été échantillonnée.

Copilot CLI Champs de métriques

L’objet totals_by_cli contient les champs imbriqués suivants lorsque Copilot CLI l’utilisation est présente ; l’objet est omis lorsqu’il n’y a pas d’utilisation de l’interface CLI. L’utilisation de l’interface CLI n’est pas indépendante des métriques IDE . Elle n’est pas reflétée dans des champs tels que totals_by_ide ou totals_by_feature. L’objet last_known_cli_version apparaît uniquement dans les rapports par utilisateur.

Champ	Type	Nullable	Descriptif
totals_by_cli.session_count	integer	No	Nombre de sessions CLI distinctes lancées ce jour-ci.
totals_by_cli.request_count	integer	No	Nombre total de demandes adressées Copilot via l’interface CLI ce jour-ci, y compris les invites initiées par l’utilisateur et les appels de suivi agentique automatisés.
totals_by_cli.prompt_count	integer	No	Nombre total d’invites utilisateur, de commandes ou de requêtes exécutées dans une session.
totals_by_cli.token_usage.output_tokens_sum	integer	No	Nombre total de jetons de sortie générés sur toutes les requêtes CLI ce jour-ci.
totals_by_cli.token_usage.prompt_tokens_sum	integer	No	Nombre total de jetons d’invite envoyés sur toutes les demandes CLI ce jour-là.
totals_by_cli.token_usage.avg_tokens_per_request	number	Oui	Nombre moyen de jetons de sortie et de requête par requête CLI, calculé comme (output_tokens_sum + prompt_tokens_sum) ÷ request_count. Null lorsqu’il n’y a pas eu de demandes ce jour-là.
totals_by_cli.last_known_cli_version	object	No	Version la plus récente Copilot CLI détectée pour cet utilisateur ce jour-là, à savoir { cli_version, sampled_at }. Rapports par utilisateur uniquement.
totals_by_cli.last_known_cli_version.cli_version	string	No
Copilot CLI chaîne de version.
unknown Par défaut, si aucune version n’a été détectée.
totals_by_cli.last_known_cli_version.sampled_at	string	Oui	Horodatage (ISO 8601) auquel la version a été échantillonnée.

Copilot app Champs de métriques

L’objet totals_by_copilot_app contient les champs imbriqués suivants lorsque l’utilisation de Copilot app est présente. Il apparaît dans les rapports par utilisateur et dans les rapports d’entreprise agrégés ; il est omis ou null lorsque l’utilisateur ou l’entreprise n’avait aucune Copilot app activité ce jour-là. Contrairement à totals_by_cli, l’activité de codage de Copilot app est également reflétée dans totals_by_feature, totals_by_model_feature, totals_by_language_feature et totals_by_language_model pour la valeur de fonctionnalité copilot_app, ainsi que dans l’activité de code globale et les métriques de lignes de code. Il n’y a pas de last_known_app_version champ.

Champ	Type	Nullable	Descriptif
totals_by_copilot_app.session_count	integer	No	Nombre de sessions Copilot app distinctes initiées ce jour.
totals_by_copilot_app.request_count	integer	No	Nombre total de requêtes effectuées auprès de Copilot via le Copilot app ce jour-là, y compris les prompts initiés par l’utilisateur et les appels de suivi effectués automatiquement par l’agent.
totals_by_copilot_app.prompt_count	integer	No	Nombre total d’invites utilisateur, de commandes ou de requêtes exécutées dans une session.
totals_by_copilot_app.token_usage.output_tokens_sum	integer	No	Nombre total de jetons de sortie générés pour l’ensemble des requêtes Copilot app au cours de cette journée.
totals_by_copilot_app.token_usage.prompt_tokens_sum	integer	No	Nombre total de tokens de prompt envoyés pour toutes les requêtes Copilot app ce jour-là.
totals_by_copilot_app.token_usage.avg_tokens_per_request	number	Oui	Moyenne des tokens de sortie et de prompt par requête Copilot app, calculée comme suit : (output_tokens_sum + prompt_tokens_sum) ÷ request_count Null lorsqu’il n’y a pas eu de demandes ce jour-là.

Agent apps Champs de métriques

Le totals_by_3rd_party_agent tableau contient une entrée pour chaque élément reconnu agent app utilisé pendant la période de rapport. Les entrées sont regroupées par agent_id, et les intégrations qui correspondent au même agent sont regroupées. Utilisez agent_id comme clé de regroupement stable et agent_name pour l’affichage. Le tableau est omis lorsqu’aucune activité reconnue agent app n’est disponible pendant la période de rapport.

Ces métriques proviennent de l’activité de travail côté serveur. Le champ imbriqué user_initiated_interaction_count compte les démarrages de tâches agent app et se distingue du champ racine portant le même nom, qui compte les prompts explicites issus d’autres sources de télémétrie prises en charge.

Champ	Type	Nullable	Descriptif
totals_by_3rd_party_agent[].agent_name	string	No	Afficher le nom de agent app. Le nom peut changer. Ainsi, utilisez-le agent_id pour le regroupement.
totals_by_3rd_party_agent[].agent_id	string	No	Identificateur stable pour le agent app.
totals_by_3rd_party_agent[].user_initiated_interaction_count	integer	No	Nombre de tâches lancées par l’utilisateur pour le agent app au cours de la période de rapport. Chaque démarrage de tâche incrémente le compteur une fois.
totals_by_3rd_party_agent[].session_count	integer	No	Somme du nombre de sessions distinctes et non nulles pour les intégrations associées à l’agent pendant la période de reporting. Inclus uniquement dans les rapports d’entreprise et d’organisation agrégés ; omis dans les rapports par utilisateur.

Champs d’activité des pull requests

L’objet pull_requests apparaît dans les rapports d’entreprise et d’organisation agrégés et dans les rapports au niveau du référentiel. Il enregistre chaque jour les créations, examens, fusions et activités liées aux suggestions dans les requêtes de tirage, y compris les activités effectuées par Copilot cloud agent et Copilot code review.

Champ	Type	Nullable	Descriptif
pull_requests.total_created	integer	No	Nombre total de pull requests créées ce jour précis. La création est un événement unique. Chaque pull request est comptabilisée uniquement le jour où elle est créée.
pull_requests.total_reviewed	integer	No	Nombre total de pull requests examinées ce jour-là. La même demande de tirage peut être comptée pour plusieurs jours si elle reçoit des examens sur plusieurs jours. En une seule journée, chaque pull request est comptée une seule fois, même si plusieurs actions de révision ont lieu.
pull_requests.total_merged	integer	No	Nombre total de pull requests fusionnées ce jour-là. La fusion est un événement unique. Chaque pull request est comptée uniquement le jour où elle est fusionnée.
pull_requests.median_minutes_to_merge	number	Oui	Temps médian, en minutes, entre la création d'une requête de tirage et sa fusion pour les requêtes de tirage fusionnées ce jour-là. La médiane est utilisée afin de réduire l’impact des valeurs aberrantes provenant de pull requests dont la durée est exceptionnellement longue. Valeur nulle lorsqu'aucune demande de tirage n'a été fusionnée ce jour-là.
pull_requests.total_suggestions	integer	No	Nombre total de suggestions de révision de pull request générées en ce jour précis, indépendamment de l’auteur.
pull_requests.total_applied_suggestions	integer	No	Nombre total de suggestions de révision de pull request appliquées ce jour-là, quel que soit l’auteur.
pull_requests.total_created_by_copilot	integer	No	Nombre de pull requests créées par Copilot cloud agent ce jour précis.
pull_requests.total_reviewed_by_copilot	integer	No	Nombre de pull requests examinées par Copilot code review cette journée précise. Une pull request peut être comptabilisée sur plusieurs jours si Copilot code review l’examine sur plusieurs jours.
pull_requests.total_merged_created_by_copilot	integer	No	Nombre de pull requests créées par Copilot cloud agent qui ont été fusionnées ce jour spécifique. Chaque pull request est comptée uniquement le jour où elle est fusionnée.
pull_requests.total_merged_reviewed_by_copilot	integer	No	Nombre de pull requests qui ont été à la fois fusionnées et examinées par Copilot code review au cours de la période de rapport.
pull_requests.median_minutes_to_merge_copilot_authored	number	Oui	Temps médian, en minutes, entre la création de demande de tirage et la fusion pour les demandes de tirage créées par Copilot cloud agent et fusionnées ce jour spécifique. Null si aucune pull request n’a été fusionnée ce jour.
pull_requests.median_minutes_to_merge_copilot_reviewed	number	Oui	Durée médiane, en minutes, entre la création et la fusion des demandes de tirage, calculée uniquement pour les demandes de tirage examinées par Copilot code review. Null si aucune pull request n’a été fusionnée ce jour.
pull_requests.total_copilot_suggestions	integer	No	Nombre de suggestions de révision de pull request générées par Copilot code review ce jour-là.
pull_requests.total_copilot_applied_suggestions	integer	No	Nombre de suggestions de révision de pull request générées par Copilot code review qui ont été appliquées ce jour-là.
pull_requests.copilot_suggestions_by_comment_type	array	No	Nombres agrégés de suggestions, divisés par le type de Copilot code review commentaire affecté (par exemple, security ou bug_risk). Chaque entrée inclut comment_type, total_copilot_suggestionset total_copilot_applied_suggestions. Toujours présent, mais peut être vide.

Champs de phase d’adoption de l’IA

Copilot regroupe les utilisateurs en phases d’adoption de l’IA en fonction de leur activité. Les informations de phase s’affichent à deux emplacements : l’objet par utilisateur ai_adoption_phase et le tableau agrégé totals_by_ai_adoption_phase . Pour les valeurs de phase, consultez Valeurs des dimensions de répartition.

Logique de classification

Un utilisateur est classé dans une phase en fonction des Copilot fonctionnalités avec lesquelles il est engagé . Un utilisateur est engagé avec une fonctionnalité lorsqu’il l’utilise sur au moins deux jours distincts dans la fenêtre de fin de 28 jours. L’engagement est évalué à partir des signaux d’activité au niveau des fonctionnalités figurant dans le tableau ci-dessous, et non directement à partir des used_* ou à partir de code_acceptance_activity_count. Les phases sont évaluées du haut vers le bas, et un utilisateur reçoit la phase la plus élevée pour laquelle il est éligible.

Phase	Critères d’engagement
Aucune cohorte (affichée en tant qu'« utilisateurs passifs » dans le tableau de bord d’impact)	L’utilisateur n’utilise aucune fonctionnalité admissible à une phase. Cela ne signifie pas que l’utilisateur est inactif. Un utilisateur de ce groupe peut toujours utiliser Copilot régulièrement et consommer des requêtes Premium, mais n’a pas utilisé de fonctionnalité éligible sur au moins deux jours distincts dans la fenêtre de fin de 28 jours. Le cas le plus courant est l’utilisation conversationnelle de Copilot Chat ou du mode agent, consignée comme chat_panel_agent_mode, qui ne produit jamais d’activité code_completion ou agent_edit. La copie du code hors d’une réponse de conversation ne produit pas non plus de signal.
Phase 1 : Le code d'abord	Interactions avec des saisies de code en ligne (la valeur code_completion de la dimension feature) ou avec des modifications apportées par l’agent directement dans les fichiers (la valeur agent_edit de la dimension feature).
Phase 2 : Priorité à l’agent	Interagit avec exactement une surface d’agent basée sur GitHub : Copilot CLI (la valeur copilot_cli de la dimension feature), Copilot cloud agent (used_copilot_cloud_agent), ou Copilot code review (used_copilot_code_review_active ou used_copilot_code_review_passive). Les éléments actifs et passifs Copilot code review sont comptabilisés ensemble comme une seule surface.
Phase 3 : Multi-agent	Interagit avec Copilot app (la valeur copilot_app de la dimension feature), ou avec au moins deux des surfaces de l’agent répertoriées pour la phase 2.

Un utilisateur doit uniquement interagir avec les signaux propres à une phase pour atteindre cette phase. Un utilisateur n’a pas besoin de remplir à lui seul les critères de la Phase 1 pour atteindre la Phase 2 ou la Phase 3, même si, dans la pratique, l’utilisation de l’interface agent coïncide souvent avec des complétions ou des modifications effectuées par l’agent.

Parmi les surfaces de l’agent, seules les surfaces propriétaires répertoriées dans le tableau influent sur la phase d’adoption de l’IA par un utilisateur. L’activité provenant de agent apps créé par un partenaire n’affecte pas la phase. La même logique de classification s’applique aux rapports d’entreprise et d’organisation, y compris les rapports de 1 jour et de 28 jours.

L’attribution de phase est recalculée chaque jour à l’aide d’une fenêtre glissante de 28 jours, de sorte que la phase d’un utilisateur peut changer d’un jour à l’autre à mesure que son activité au sein de cette fenêtre évolue. Ce comportement est attendu et n’indique pas d’erreur de données.

L’objet par utilisateur ai_adoption_phase contient :

Champ	Type	Nullable	Descriptif
ai_adoption_phase.phase_number	integer	No	Identificateur de phase numérique (par exemple, 0 pour « Aucune cohorte »).
ai_adoption_phase.phase	string	No	Nom de phase lisible par l’homme.
ai_adoption_phase.version	string	No	Version du modèle de phase d’adoption utilisé (par exemple, v1).

Chaque entrée du tableau agrégé totals_by_ai_adoption_phase contient :

Champ	Type	Nullable	Descriptif
phase	string	No	Nom de phase lisible par l’homme.
phase_number	integer	No	Identificateur de phase numérique.
total_engaged_users	integer	No	Nombre d’utilisateurs regroupés dans cette phase pour la période.
avg_user_initiated_interactions	number	No	Interactions moyennes initiées par l’utilisateur par utilisateur dans cette phase.
avg_code_generation_activities	number	No	Activités moyennes de génération de code par utilisateur dans cette phase.
avg_code_acceptance_activities	number	No	Activités d’acceptation de code moyennes par utilisateur dans cette phase.
avg_loc_added	number	No	Lignes moyennes de code ajoutées par utilisateur dans cette phase.
avg_loc_deleted	number	No	Lignes moyennes de code supprimées par utilisateur dans cette phase.
avg_pull_requests_reviewed	number	No	Nombre moyen de pull requests examinées par utilisateur dans cette phase.
avg_pull_requests_created	number	No	Nombre moyen de pull requests créées par utilisateur au cours de cette phase.
avg_pull_requests_merged	number	No	Nombre moyen de demandes de tirage fusionnées par utilisateur dans cette phase.
total_pull_requests_merged	integer	No	Nombre total de pull requests fusionnées par les utilisateurs au cours de cette phase. S'applique aux rapports agrégés quotidiens de l'organisation et de l'entreprise.
avg_pull_requests_median_minutes_to_merge	number	No	Moyenne des délais médians de fusion par utilisateur pour les utilisateurs de cette phase.
avg_pull_requests_minutes_to_review	number	No	Durée médiane en minutes de la création d’une demande de tirage à la première révision, étendue aux demandes de tirage fusionnées et attribuées au jour de fusion de la demande de tirage.
avg_pull_requests_review_cycles	number	No	Nombre médian de soumissions de révision (cycles de révision) par demande de tirage, délimité aux demandes de tirage fusionnées et attribuées au jour de fusion de la demande de tirage.

Valeurs des dimensions de répartition

Les objets de répartition ci-dessus utilisent des champs de dimension dont les valeurs proviennent d’ensembles prédéfinis. Il s’agit de valeurs de champ, pas de champs distincts. Par exemple, agent_edit et les chat_panel_*_mode valeurs sont des valeurs du feature champ, et non des champs de niveau supérieur.

La feature dimension identifie la fonctionnalité ou le Copilot mode qu’une activité est attribuée à :

Valeur	Descriptif
code_completion	Complétions de code en ligne.
chat_inline	Conversation intégrée dans l’éditeur.
chat_panel_ask_mode	Interactions avec le panneau de discussion lorsque le mode « Poser une question » est sélectionné.
chat_panel_edit_mode	Interactions du panneau de conversation avec le mode d’édition sélectionné.
chat_panel_agent_mode	Interactions du panneau de conversation avec le mode agent sélectionné.
chat_panel_plan_mode	Interactions avec le panneau de discussion lorsque le mode « Planifier » est sélectionné.
chat_panel_custom_mode	Interactions de panneau de conversation avec un agent personnalisé sélectionné.
chat_panel_unknown_mode	Interactions du panneau de conversation où le mode est inconnu.
agent_edit	Les lignes ajoutées et supprimées lorsque Copilot (en mode agent et édition) écrivent des modifications directement dans vos fichiers dans l’IDE. Compte également les modifications des agents personnalisés.
agent_edit n’est pas inclus dans les métriques basées sur des suggestions et peut ne pas remplir les champs de style suggestion, tels que user_initiated_interaction_count.
copilot_cli	Activité attribuée à Copilot CLI.
copilot_app	Activité attribuée à l’application Copilot .
others	Toute fonctionnalité non couverte par les valeurs ci-dessus.

La ide dimension identifie l’IDE dans laquelle une activité s’est produite. Il ne s’agit pas d’une liste exhaustive, mais des exemples de valeurs observées incluent vscode, , visualstudio``intellij, eclipse, xcode, neovim, , vim, , emacset zed.

La model dimension identifie le modèle IA utilisé pour l’activité de conversation. Les valeurs incluent des identificateurs de modèle spécifiques (par exemple, gpt-5.4 ou claude-sonnet-4.6), auto, unknownet others. La auto valeur représente l’activité où auto model selection a été utilisée et la requête n’a pas été attribuée à un modèle spécifique.

La phase dimension identifie la phase d’adoption de l’IA dans laquelle un utilisateur est regroupé en : No Cohort, Phase 1``Phase 2ou Phase 3.