Esquema de ejemplo para métricas de uso de Copilot

Consulte un esquema de ejemplo de los datos devueltos por la API de Copilot métricas de uso.

¿Quién puede utilizar esta característica?

Propietarios de empresas, administradores de facturación empresarial, propietarios de la organización y personas con un rol de organización o empresa personalizado con el permiso "Ver métricas de Copilot la organización" o "Ver métricas empresariales Copilot ".

En este artículo

Los siguientes ejemplos muestran esquemas de datos a nivel de usuario, de empresa y de repositorio devueltos por los Copilotpuntos de conexión de métricas de uso. Los campos devueltos varían según la métrica y el nivel de agregación. Use estos ejemplos para comprender la estructura de respuesta e interpretar sus campos y métricas.

Ejemplo de esquema de nivel de usuario

JSON
[{
  "ai_adoption_phase": {
    "phase": "Phase 2",
    "phase_number": 2,
    "version": "v1"
  },
  "ai_credits_used": 12.5,
  "code_acceptance_activity_count": 3,
  "code_generation_activity_count": 3,
  "day": "2025-10-01",
  "distinct_custom_agent_use_count": 2,
  "distinct_mcp_use_count": 2,
  "distinct_plugin_use_count": 1,
  "distinct_skill_use_count": 3,
  "distinct_slash_cmd_use_count": 2,
  "enterprise_id": "1",
  "loc_added_sum": 32,
  "loc_deleted_sum": 6,
  "loc_suggested_to_add_sum": 34,
  "loc_suggested_to_delete_sum": 6,
  "totals_by_cli": {
    "last_known_cli_version": {
      "cli_version": "1.0.8",
      "sampled_at": "2025-10-01T00:01:43.000Z"
    },
    "prompt_count": 2,
    "request_count": 2,
    "session_count": 2,
    "token_usage": {
      "avg_tokens_per_request": 4400.0,
      "output_tokens_sum": 5000,
      "prompt_tokens_sum": 3800
    }
  },
  "totals_by_copilot_app": {
    "prompt_count": 1,
    "request_count": 3,
    "session_count": 1,
    "token_usage": {
      "avg_tokens_per_request": 3200.0,
      "output_tokens_sum": 4200,
      "prompt_tokens_sum": 5400
    }
  },
  "totals_by_custom_agent": [{
    "custom_agent": "general-purpose",
    "interaction_count": 4
  }, {
    "custom_agent": "other",
    "interaction_count": 2
  }],
  "totals_by_3rd_party_agent": [{
    "agent_id": "2246796",
    "agent_name": "Claude (Anthropic)",
    "user_initiated_interaction_count": 2
  }, {
    "agent_id": "2248422",
    "agent_name": "Codex (OpenAI)",
    "user_initiated_interaction_count": 2
  }],
  "totals_by_feature": [{
    "code_acceptance_activity_count": 1,
    "code_generation_activity_count": 1,
    "feature": "code_completion",
    "loc_added_sum": 8,
    "loc_deleted_sum": 0,
    "loc_suggested_to_add_sum": 10,
    "loc_suggested_to_delete_sum": 0,
    "user_initiated_interaction_count": 0
  }, {
    "code_acceptance_activity_count": 2,
    "code_generation_activity_count": 2,
    "feature": "copilot_app",
    "loc_added_sum": 24,
    "loc_deleted_sum": 6,
    "loc_suggested_to_add_sum": 24,
    "loc_suggested_to_delete_sum": 6,
    "user_initiated_interaction_count": 1
  }],
  "totals_by_ide": [{
    "code_acceptance_activity_count": 1,
    "code_generation_activity_count": 1,
    "ide": "vscode",
    "last_known_ide_version": {
      "ide_version": "1.85.0",
      "sampled_at": "2025-10-01T00:00:02.000Z"
    },
    "last_known_plugin_version": {
      "plugin": "",
      "plugin_version": "",
      "sampled_at": "2025-10-01T00:00:02.000Z"
    },
    "loc_added_sum": 8,
    "loc_deleted_sum": 0,
    "loc_suggested_to_add_sum": 10,
    "loc_suggested_to_delete_sum": 0,
    "user_initiated_interaction_count": 0
  }],
  "totals_by_language_feature": [{
    "code_acceptance_activity_count": 1,
    "code_generation_activity_count": 1,
    "feature": "code_completion",
    "language": "unknown",
    "loc_added_sum": 8,
    "loc_deleted_sum": 0,
    "loc_suggested_to_add_sum": 10,
    "loc_suggested_to_delete_sum": 0
  }, {
    "code_acceptance_activity_count": 2,
    "code_generation_activity_count": 2,
    "feature": "copilot_app",
    "language": "markdown",
    "loc_added_sum": 24,
    "loc_deleted_sum": 6,
    "loc_suggested_to_add_sum": 24,
    "loc_suggested_to_delete_sum": 6
  }],
  "totals_by_language_model": [],
  "totals_by_mcp": [{
    "interaction_count": 8,
    "mcp": "github-mcp-server"
  }, {
    "interaction_count": 3,
    "mcp": "other"
  }],
  "totals_by_model_feature": [],
  "totals_by_vscode_agent": {
    "session_count": 1,
    "total_user_messages": 1
  },
  "totals_by_plugin": [{
    "interaction_count": 2,
    "plugin": "other"
  }],
  "totals_by_skill": [{
    "interaction_count": 5,
    "skill": "other"
  }],
  "totals_by_slash_cmd": [{
    "interaction_count": 3,
    "slash_cmd": "/plan"
  }, {
    "interaction_count": 1,
    "slash_cmd": "custom"
  }],
  "used_agent": false,
  "used_chat": false,
  "used_cli": true,
  "used_copilot_app": true,
  "used_copilot_cloud_agent": false,
  "used_copilot_code_review_active": null,
  "used_copilot_code_review_passive": null,
  "used_copilot_coding_agent": false,
  "used_vscode_agent": true,
  "user_id": 1,
  "user_login": "login1",
  "user_initiated_interaction_count": 1
}]

Los informes por usuario de la organización utilizan los mismos campos de entrada totals_by_3rd_party_agent y también incluyen organization_id. Las entradas por usuario totals_by_3rd_party_agent omiten session_count.

En los informes por usuario de empresa y organización, used_vscode_agent y totals_by_vscode_agent proporcionan métricas específicas de la ventana VS Code Agentes. Estos campos aparecen en el nivel superior en informes de 1 día y 28 días. Se omiten cuando no hay datos específicos de la ventana Agents VS Code, y totals_by_vscode_agent se omite a menos que estén disponibles los dos recuentos.

Los Copilot CLI campos de personalización que se muestran en este ejemplo aparecen en informes de 1 día y 28 días por usuario.

En este ejemplo, used_copilot_code_review_active y used_copilot_code_review_passive son null porque no había ninguna señal Copilot code review para el usuario ese día. used_copilot_cloud_agent y used_copilot_coding_agent siempre llevan el mismo valor.

Ejemplo de esquema de nivel empresarial

JSON
[ {
  "day_totals" : [ {
    "code_acceptance_activity_count" : 4,
    "code_generation_activity_count" : 4,
    "daily_active_cli_users" : 2,
    "daily_active_copilot_app_users" : 1,
    "daily_active_copilot_cloud_agent_users" : 1,
    "daily_active_copilot_code_review_users" : 1,
    "daily_active_users" : 2,
    "daily_active_vscode_agent_users" : 2,
    "daily_passive_copilot_code_review_users" : 0,
    "day" : "2025-10-01",
    "distinct_custom_agent_use_count" : 2,
    "distinct_mcp_use_count" : 2,
    "distinct_plugin_use_count" : 1,
    "distinct_skill_use_count" : 3,
    "distinct_slash_cmd_use_count" : 2,
    "enterprise_id" : "1",
    "loc_added_sum" : 54,
    "loc_deleted_sum" : 6,
    "loc_suggested_to_add_sum" : 59,
    "loc_suggested_to_delete_sum" : 6,
    "monthly_active_agent_users" : 0,
    "monthly_active_chat_users" : 0,
    "monthly_active_copilot_cloud_agent_users" : 1,
    "monthly_active_copilot_code_review_users" : 1,
    "monthly_active_users" : 2,
    "monthly_active_vscode_agent_users" : 2,
    "monthly_passive_copilot_code_review_users" : 0,
    "pull_requests" : {
      "median_minutes_to_merge" : 2.5,
      "median_minutes_to_merge_copilot_authored" : 2.5,
      "median_minutes_to_merge_copilot_reviewed" : 2.5,
      "total_applied_suggestions" : 1,
      "total_copilot_applied_suggestions" : 1,
      "total_copilot_suggestions" : 1,
      "total_created" : 2,
      "total_created_by_copilot" : 1,
      "total_merged" : 2,
      "total_merged_created_by_copilot" : 1,
      "total_merged_reviewed_by_copilot" : 1,
      "total_reviewed" : 1,
      "total_reviewed_by_copilot" : 1,
      "total_suggestions" : 1
    },
    "totals_by_3rd_party_agent" : [ {
      "agent_id" : "2246796",
      "agent_name" : "Claude (Anthropic)",
      "session_count" : 1,
      "user_initiated_interaction_count" : 2
    }, {
      "agent_id" : "2248422",
      "agent_name" : "Codex (OpenAI)",
      "session_count" : 2,
      "user_initiated_interaction_count" : 2
    } ],
    "totals_by_ai_adoption_phase" : [ {
      "avg_code_acceptance_activities" : 1.0,
      "avg_code_generation_activities" : 1.0,
      "avg_loc_added" : 22.0,
      "avg_loc_deleted" : 0.0,
      "avg_pull_requests_created" : 1.0,
      "avg_pull_requests_median_minutes_to_merge" : 2.5,
      "avg_pull_requests_merged" : 1.0,
      "avg_pull_requests_minutes_to_review" : 1.5,
      "avg_pull_requests_review_cycles" : 1.0,
      "avg_pull_requests_reviewed" : 0.0,
      "avg_user_initiated_interactions" : 0.0,
      "phase" : "Phase 1",
      "phase_number" : 1,
      "total_engaged_users" : 1,
      "users_in_phase_28d" : 1,
      "total_pull_requests_merged" : 1
    }, {
      "avg_code_acceptance_activities" : 3.0,
      "avg_code_generation_activities" : 3.0,
      "avg_loc_added" : 32.0,
      "avg_loc_deleted" : 6.0,
      "avg_pull_requests_created" : 1.0,
      "avg_pull_requests_median_minutes_to_merge" : 2.5,
      "avg_pull_requests_merged" : 1.0,
      "avg_pull_requests_minutes_to_review" : 2.0,
      "avg_pull_requests_review_cycles" : 2.0,
      "avg_pull_requests_reviewed" : 1.0,
      "avg_user_initiated_interactions" : 1.0,
      "phase" : "Phase 3",
      "phase_number" : 3,
      "total_engaged_users" : 1,
      "users_in_phase_28d" : 1,
      "total_pull_requests_merged" : 1
    } ],
    "totals_by_cli" : {
      "prompt_count" : 3,
      "request_count" : 3,
      "session_count" : 3,
      "token_usage" : {
        "avg_tokens_per_request" : 4100.0,
        "output_tokens_sum" : 7000,
        "prompt_tokens_sum" : 5300
      }
    },
    "totals_by_copilot_app" : {
      "prompt_count" : 2,
      "request_count" : 6,
      "session_count" : 2,
      "token_usage" : {
        "avg_tokens_per_request" : 2466.67,
        "output_tokens_sum" : 6200,
        "prompt_tokens_sum" : 8600
      }
    },
    "totals_by_custom_agent" : [ {
      "custom_agent" : "general-purpose",
      "interaction_count" : 7
    }, {
      "custom_agent" : "other",
      "interaction_count" : 3
    } ],
    "totals_by_feature" : [ {
      "code_acceptance_activity_count" : 2,
      "code_generation_activity_count" : 2,
      "feature" : "code_completion",
      "loc_added_sum" : 30,
      "loc_deleted_sum" : 0,
      "loc_suggested_to_add_sum" : 35,
      "loc_suggested_to_delete_sum" : 0,
      "user_initiated_interaction_count" : 0
    }, {
      "code_acceptance_activity_count" : 2,
      "code_generation_activity_count" : 2,
      "feature" : "copilot_app",
      "loc_added_sum" : 24,
      "loc_deleted_sum" : 6,
      "loc_suggested_to_add_sum" : 24,
      "loc_suggested_to_delete_sum" : 6,
      "user_initiated_interaction_count" : 1
    } ],
    "totals_by_ide" : [ {
      "code_acceptance_activity_count" : 2,
      "code_generation_activity_count" : 2,
      "ide" : "vscode",
      "loc_added_sum" : 30,
      "loc_deleted_sum" : 0,
      "loc_suggested_to_add_sum" : 35,
      "loc_suggested_to_delete_sum" : 0,
      "user_initiated_interaction_count" : 0
    } ],
    "totals_by_language_feature" : [ {
      "code_acceptance_activity_count" : 2,
      "code_generation_activity_count" : 2,
      "feature" : "code_completion",
      "language" : "unknown",
      "loc_added_sum" : 30,
      "loc_deleted_sum" : 0,
      "loc_suggested_to_add_sum" : 35,
      "loc_suggested_to_delete_sum" : 0
    }, {
      "code_acceptance_activity_count" : 2,
      "code_generation_activity_count" : 2,
      "feature" : "copilot_app",
      "language" : "markdown",
      "loc_added_sum" : 24,
      "loc_deleted_sum" : 6,
      "loc_suggested_to_add_sum" : 24,
      "loc_suggested_to_delete_sum" : 6
    } ],
    "totals_by_language_model" : [ ],
    "totals_by_mcp" : [ {
      "interaction_count" : 12,
      "mcp" : "github-mcp-server"
    }, {
      "interaction_count" : 5,
      "mcp" : "other"
    } ],
    "totals_by_model_feature" : [ ],
    "totals_by_vscode_agent" : {
      "session_count" : 2,
      "total_user_messages" : 2
    },
    "totals_by_plugin" : [ {
      "interaction_count" : 4,
      "plugin" : "other"
    } ],
    "totals_by_skill" : [ {
      "interaction_count" : 9,
      "skill" : "other"
    } ],
    "totals_by_slash_cmd" : [ {
      "interaction_count" : 6,
      "slash_cmd" : "/plan"
    }, {
      "interaction_count" : 2,
      "slash_cmd" : "custom"
    } ],
    "user_initiated_interaction_count" : 1,
    "weekly_active_copilot_cloud_agent_users" : 1,
    "weekly_active_copilot_code_review_users" : 1,
    "weekly_active_users" : 2,
    "weekly_active_vscode_agent_users" : 2,
    "weekly_passive_copilot_code_review_users" : 0
  } ],
  "enterprise_id" : "1",
  "copilot_feature_engagement" : {
    "active_user_count" : 2,
    "totals_by_feature" : [ {
      "feature" : "code_completion",
      "engaged_user_count" : 2
    }, {
      "feature" : "agent_edit",
      "engaged_user_count" : 1
    }, {
      "feature" : "code_review_passive",
      "engaged_user_count" : 1
    }, {
      "feature" : "code_review_active",
      "engaged_user_count" : 1
    }, {
      "feature" : "cloud_agent",
      "engaged_user_count" : 1
    }, {
      "feature" : "copilot_cli",
      "engaged_user_count" : 1
    }, {
      "feature" : "github_app",
      "engaged_user_count" : 1
    } ]
  },
  "report_end_day" : "2025-10-01",
  "report_start_day" : "2025-09-04"
}, {
  "day_totals" : [ {
    "code_acceptance_activity_count" : 2,
    "code_generation_activity_count" : 3,
    "daily_active_copilot_cloud_agent_users" : 0,
    "daily_active_copilot_code_review_users" : 0,
    "daily_active_users" : 2,
    "daily_passive_copilot_code_review_users" : 0,
    "day" : "2025-10-01",
    "distinct_custom_agent_use_count" : 0,
    "distinct_mcp_use_count" : 0,
    "distinct_plugin_use_count" : 0,
    "distinct_skill_use_count" : 0,
    "distinct_slash_cmd_use_count" : 0,
    "enterprise_id" : "2",
    "loc_added_sum" : 50,
    "loc_deleted_sum" : 3,
    "loc_suggested_to_add_sum" : 52,
    "loc_suggested_to_delete_sum" : 3,
    "monthly_active_agent_users" : 0,
    "monthly_active_chat_users" : 0,
    "monthly_active_copilot_cloud_agent_users" : 0,
    "monthly_active_copilot_code_review_users" : 0,
    "monthly_active_users" : 2