# Beispielschema für Copilot Nutzungsmetriken

Sehen Sie sich ein Beispielschema der Daten an, die von der Copilot Verwendungsmetriken-API zurückgegeben werden.

Im Folgenden finden Sie Beispielschemas für die Daten auf Benutzerebene, Enterprise-Ebene und Repositoryebene, die von den Endpunkten der Copilot Verwendungsmetriken zurückgegeben werden. Die zurückgegebenen tatsächlichen Daten können je nach den zu verfolgenden Metriken und der Aggregationsebene variieren. Sie können diese Beispiele als Referenz verwenden, um die Struktur der Daten zu verstehen und die verschiedenen Felder und Metriken zu interpretieren, die in der API-Antwort enthalten sind.

## Beispiel für ein Schema auf Benutzerebene

```json copy
[{
  "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",
  "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_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_model_feature": [],
  "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,
  "user_id": 1,
  "user_login": "login1",
  "user_initiated_interaction_count": 1,
  "etl_id": "green",
  "day_partition": "2025-10-01",
  "entity_id_partition": 1
}]
```

Berichte pro Benutzer für die Organisation verwenden dieselben `totals_by_3rd_party_agent` Eingabefelder und enthalten außerdem `organization_id`. Benutzerspezifische Einträge enthalten kein `session_count`.

In diesem Beispiel sind `used_copilot_code_review_passive` und `null``used_copilot_code_review_active`, da an diesem Tag kein Copilot code review-Signal für den Benutzer vorlag.
`used_copilot_cloud_agent` und `used_copilot_coding_agent` tragen immer denselben Wert.

## Beispiel für ein Schema auf Unternehmensebene

```json copy
[ {
  "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_passive_copilot_code_review_users" : 0,
    "day" : "2025-10-01",
    "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_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,
      "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 2",
      "phase_number" : 2,
      "total_engaged_users" : 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_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_model_feature" : [ ],
    "user_initiated_interaction_count" : 1,
    "weekly_active_copilot_cloud_agent_users" : 1,
    "weekly_active_copilot_code_review_users" : 1,
    "weekly_active_users" : 2,
    "weekly_passive_copilot_code_review_users" : 0
  } ],
  "enterprise_id" : "1",
  "report_end_day" : "2025-10-01",
  "report_start_day" : "2025-09-04",
  "etl_id" : "green",
  "day_partition" : "2025-10-01",
  "entity_id_partition" : 1
}, {
  "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",
    "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,
    "monthly_passive_copilot_code_review_users" : 0,
    "pull_requests" : {
      "total_applied_suggestions" : 0,
      "total_copilot_applied_suggestions" : 0,
      "total_copilot_suggestions" : 0,
      "total_created" : 1,
      "total_created_by_copilot" : 0,
      "total_merged" : 0,
      "total_merged_created_by_copilot" : 0,
      "total_merged_reviewed_by_copilot" : 0,
      "total_reviewed" : 1,
      "total_reviewed_by_copilot" : 0,
      "total_suggestions" : 1
    },
    "totals_by_ai_adoption_phase" : [ {
      "avg_code_acceptance_activities" : 0.0,
      "avg_code_generation_activities" : 1.0,
      "avg_loc_added" : 12.0,
      "avg_loc_deleted" : 3.0,
      "avg_pull_requests_created" : 0.0,
      "avg_pull_requests_median_minutes_to_merge" : 0.0,
      "avg_pull_requests_merged" : 0.0,
      "avg_pull_requests_minutes_to_review" : 0.0,
      "avg_pull_requests_review_cycles" : 0.0,
      "avg_pull_requests_reviewed" : 0.0,
      "avg_user_initiated_interactions" : 0.0,
      "phase" : "No Cohort",
      "phase_number" : 0,
      "total_engaged_users" : 1,
      "total_pull_requests_merged" : 0
    }, {
      "avg_code_acceptance_activities" : 2.0,
      "avg_code_generation_activities" : 2.0,
      "avg_loc_added" : 38.0,
      "avg_loc_deleted" : 0.0,
      "avg_pull_requests_created" : 1.0,
      "avg_pull_requests_median_minutes_to_merge" : 0.0,
      "avg_pull_requests_merged" : 0.0,
      "avg_pull_requests_minutes_to_review" : 0.0,
      "avg_pull_requests_review_cycles" : 0.0,
      "avg_pull_requests_reviewed" : 1.0,
      "avg_user_initiated_interactions" : 1.0,
      "phase" : "Phase 1",
      "phase_number" : 1,
      "total_engaged_users" : 1,
      "total_pull_requests_merged" : 0
    } ],
    "totals_by_feature" : [ {
      "code_acceptance_activity_count" : 1,
      "code_generation_activity_count" : 2,
      "feature" : "code_completion",
      "loc_added_sum" : 38,
      "loc_deleted_sum" : 0,
      "loc_suggested_to_add_sum" : 40,
      "loc_suggested_to_delete_sum" : 0,
      "user_initiated_interaction_count" : 0
    }, {
      "code_acceptance_activity_count" : 1,
      "code_generation_activity_count" : 1,
      "feature" : "copilot_app",
      "loc_added_sum" : 12,
      "loc_deleted_sum" : 3,
      "loc_suggested_to_add_sum" : 12,
      "loc_suggested_to_delete_sum" : 3,
      "user_initiated_interaction_count" : 1
    } ],
    "totals_by_ide" : [ {
      "code_acceptance_activity_count" : 1,
      "code_generation_activity_count" : 2,
      "ide" : "vscode",
      "loc_added_sum" : 38,
      "loc_deleted_sum" : 0,
      "loc_suggested_to_add_sum" : 40,
      "loc_suggested_to_delete_sum" : 0,
      "user_initiated_interaction_count" : 0
    } ],
    "totals_by_language_feature" : [ {
      "code_acceptance_activity_count" : 1,
      "code_generation_activity_count" : 2,
      "feature" : "code_completion",
      "language" : "unknown",
      "loc_added_sum" : 38,
      "loc_deleted_sum" : 0,
      "loc_suggested_to_add_sum" : 40,
      "loc_suggested_to_delete_sum" : 0
    }, {
      "code_acceptance_activity_count" : 1,
      "code_generation_activity_count" : 1,
      "feature" : "copilot_app",
      "language" : "markdown",
      "loc_added_sum" : 12,
      "loc_deleted_sum" : 3,
      "loc_suggested_to_add_sum" : 12,
      "loc_suggested_to_delete_sum" : 3
    } ],
    "totals_by_language_model" : [ ],
    "totals_by_model_feature" : [ ],
    "user_initiated_interaction_count" : 1,
    "weekly_active_copilot_cloud_agent_users" : 0,
    "weekly_active_copilot_code_review_users" : 0,
    "weekly_active_users" : 2,
    "weekly_passive_copilot_code_review_users" : 0
  } ],
  "enterprise_id" : "2",
  "report_end_day" : "2025-10-01",
  "report_start_day" : "2025-09-04",
  "etl_id" : "green",
  "day_partition" : "2025-10-01",
  "entity_id_partition" : 2
} ]
```

Zusammengefasste Berichte der Organisation verwenden dieselben `totals_by_3rd_party_agent` Eintragsfelder, einschließlich `session_count`, und enthalten auch `organization_id`.

Die folgenden Berichtbeispiele zu Benutzerteams werden von den `user-teams-1-day`-Endpunkten zurückgegeben und sollen mit dem Nutzungsbericht pro Benutzer anhand von `user_id`, `day` und der relevanten Entitäts-ID (`organization_id` für den Organisationsbereich, `enterprise_id` für den Unternehmensbereich) verknüpft werden, um Kennzahlen auf Teamebene zu ermitteln. Weitere Anleitungen finden Sie unter [Copilot Nutzungsmetriken auf Teamebene](/de/copilot/reference/copilot-usage-metrics/team-level-metrics).

> \[!NOTE]
> Teams mit weniger als 5 sitzenden Copilot Benutzern werden aus Benutzerteamsberichten weggelassen.

## Beispiel für ein Benutzerteamsschema der Organisation

```json copy
[
  {
    "user_id": 1001,
    "user_login": "octocat",
    "day": "2026-05-14",
    "organization_id": "999",
    "team_id": 42,
    "slug": "frontend"
  },
  {
    "user_id": 1001,
    "user_login": "octocat",
    "day": "2026-05-14",
    "organization_id": "999",
    "team_id": 43,
    "slug": "backend"
  },
  {
    "user_id": 1002,
    "user_login": "hubot",
    "day": "2026-05-14",
    "organization_id": "999",
    "team_id": 42,
    "slug": "frontend"
  }
]
```

## Beispiel für ein Enterprise-Benutzerteamsschema

```json copy
[
  {
    "user_id": 1001,
    "user_login": "octocat",
    "day": "2026-05-14",
    "enterprise_id": "1",
    "team_id": 9001,
    "slug": "eng-platform"
  },
  {
    "user_id": 1001,
    "user_login": "octocat",
    "day": "2026-05-14",
    "enterprise_id": "1",
    "team_id": 7001,
    "slug": "business-analytics"
  },
  {
    "user_id": 1002,
    "user_login": "hubot",
    "day": "2026-05-14",
    "enterprise_id": "1",
    "team_id": 9001,
    "slug": "eng-platform"
  }
]
```

## Schemabeispiel auf Repositoryebene

Das folgende Berichtbeispiel auf Repositoryebene wird in den NDJSON-Dateien zurückgegeben, die von den `repos-1-day` Endpunkten heruntergeladen wurden. Jede Zeile stellt ein Repository mit Pullanforderungsaktivität am angeforderten Tag dar. Sowohl Zeilen mit Unternehmens- als auch mit Organisationsbereich befüllen `organization_id` (die Organisation, der die einzelnen Repositorys gehören). Unternehmensbezogene Zeilen befüllen ebenfalls `enterprise_id`, und organisationsbezogene Zeilen befüllen `enterprise_id` nur für Organisationen, die einem Unternehmen gehören. Informationen zum Feldverweis finden Sie unter [In den Nutzungsmetriken von Copilot verfügbare Daten](/de/copilot/reference/copilot-usage-metrics/copilot-usage-metrics#repository-level-fields-api-only).

```json copy
[
  {
    "day": "2026-07-14",
    "enterprise_id": "1001",
    "organization_id": "2002",
    "repo_id": 900000001,
    "repo_owner_name": "octodemo-metrics",
    "repo_name": "example-service-alpha",
    "repo_visibility": "INTERNAL",
    "pull_requests": {
      "total_reviewed": 1,
      "total_created": 1,
      "total_created_by_copilot": 1,
      "total_reviewed_by_copilot": 1,
      "total_merged": 1,
      "median_minutes_to_merge": 372.62,
      "total_suggestions": 0,
      "total_applied_suggestions": 0,
      "total_merged_created_by_copilot": 1,
      "median_minutes_to_merge_copilot_authored": 372.62,
      "total_copilot_suggestions": 0,
      "total_copilot_applied_suggestions": 0,
      "total_merged_reviewed_by_copilot": 1,
      "median_minutes_to_merge_copilot_reviewed": 372.62,
      "copilot_suggestions_by_comment_type": []
    }
  },
  {
    "day": "2026-07-14",
    "enterprise_id": "1001",
    "organization_id": "2002",
    "repo_id": 900000003,
    "repo_owner_name": "octodemo-metrics",
    "repo_name": "example-service-gamma",
    "repo_visibility": "INTERNAL",
    "pull_requests": {
      "total_reviewed": 1,
      "total_created": 0,
      "total_created_by_copilot": 0,
      "total_reviewed_by_copilot": 1,
      "total_merged": 1,
      "median_minutes_to_merge": 1020.53,
      "total_suggestions": 0,
      "total_applied_suggestions": 1,
      "total_merged_created_by_copilot": 0,
      "total_copilot_suggestions": 0,
      "total_copilot_applied_suggestions": 1,
      "total_merged_reviewed_by_copilot": 1,
      "median_minutes_to_merge_copilot_reviewed": 1020.53,
      "copilot_suggestions_by_comment_type": [
        {
          "comment_type": "spelling",
          "total_copilot_suggestions": 0,
          "total_copilot_applied_suggestions": 1
        }
      ]
    }
  },
  {
    "day": "2026-07-14",
    "organization_id": "3003",
    "enterprise_id": "",
    "repo_id": 900000010,
    "repo_owner_name": "octodemo-metrics",
    "repo_name": "example-service-delta",
    "repo_visibility": "PRIVATE",
    "pull_requests": {
      "total_reviewed": 1,
      "total_created": 0,
      "total_created_by_copilot": 0,
      "total_reviewed_by_copilot": 1,
      "total_merged": 2,
      "median_minutes_to_merge": 1332.96,
      "total_suggestions": 1,
      "total_applied_suggestions": 2,
      "total_merged_created_by_copilot": 1,
      "median_minutes_to_merge_copilot_authored": 1329.47,
      "total_copilot_suggestions": 1,
      "total_copilot_applied_suggestions": 2,
      "total_merged_reviewed_by_copilot": 2,
      "median_minutes_to_merge_copilot_reviewed": 1332.96,
      "copilot_suggestions_by_comment_type": [
        {
          "comment_type": "documentation",
          "total_copilot_suggestions": 1,
          "total_copilot_applied_suggestions": 1
        },
        {
          "comment_type": "spelling",
          "total_copilot_suggestions": 0,
          "total_copilot_applied_suggestions": 1
        }
      ]
    }
  }
]
```