Skip to main content

コード行のメトリック

コード行メトリックは、Copilot の出力について、補完機能、チャット、エージェント機能全体で提案、追加、または削除されたコードの行を定量化することで、方向を示す指標を提供します。

この機能を使用できるユーザーについて

エンタープライズ所有者、組織管理者、課金マネージャー、"エンタープライズ Copilot メトリックの表示" アクセス許可を持つエンタープライズ カスタム ロールを持つユーザー。

コード行 (LoC) メトリックは、Copilot の出力について、補完機能、チャット、エージェント機能全体で提案された行、追加された行、または削除された行を定量化することで、方向を示す指標を提供します。

LoC メトリックが表示される場所

LoC メトリックは次の場合に発生する可能性があります。

  • コード生成ダッシュボード (エンタープライズおよび組織レベル) - LoC ベースのユーザーとエージェントのアクティビティを視覚化します。 「コード生成ダッシュボードの表示」を参照してください。
  • エクスポートと API (エンタープライズ、組織、ユーザー レベル)loc_suggested_to_add_sumloc_added_sumloc_deleted_sumなどの LoC フィールドを公開します。 「Copilot使用状況メトリックの REST API エンドポイント」を参照してください。
  • "Copilot 使用状況メトリックで使用可能なデータ" リファレンス - LoC から派生したすべてのダッシュボードと API フィールドが一覧表示されます。 「Copilot使用状況メトリックで使用可能なデータ」を参照してください。

この記事では、LoC の測定方法と、その精度とカバレッジに影響するものについて説明します。 詳細な定義については、上記のリファレンス記事を参照してください。

LoC メトリックに関する考慮事項

LoC メトリックは、IDE とバージョンによって異なる場合があります。 以下の点に注意してください。

  • カバレッジ: 必要なバージョンにアップグレードするまで、すべての IDE とユーザーが LoC テレメトリを出力するわけではありません。 レポートには last_known_ide_version フィールドと last_known_plugin_version フィールドが含まれているため、企業全体の対象範囲を監視できます。
  • 安定性: Copilot が進化すると、テレメトリ定義が変更される可能性があります。 時間の経過とともに精度が向上するにつれて、データの小さなシフトが予想されます。

バージョンの要件

LoC メトリックが機能するには、特定の最小バージョンの IDE と Copilot プラグインが必要です。 以前のバージョンのユーザーは LoC データを提供しないため、アップグレードするまでレポートが不足する可能性があります。

IDE特徴最小 IDE バージョンコパイロットチャット 拡張機能の最小バージョン
Eclipse
  • code_completion
4.310.9.3.202507240902
chat_panel (Ask、Edit、Plan、Agent)4.310.11.0.202508291001
  • agent_edit
4.310.10.0.202508110512
IntelliJ/JetBrains
  • code_completion
chat_panel (Ask、Edit、Plan、Agent)
  • chat_inline
  • agent_edit
  • 2024.2.61.5.52-241
    Visual Studio
    • code_completion
    chat_panel (Ask、Edit、Plan、Agent)17.14.1318.0.471.29466
    • chat_inline
    • agent_edit
    17.14.1418.0.471.29466
    VS Code
    • code_completion
    1.104.00.31.0
    chat_panel (Ask、Edit、Plan、Agent)1.102.00.29.0
    • chat_inline
    1.103.20.30.3
    • agent_edit
    1.103.00.30.0
    XCode
    • code_completion
    14.3.10.40.0
    chat_panel (Ask、Edit、Plan、Agent)15.00.43.0
    • agent_edit
    15.20.41.0

    エージェント モードが LoC メトリックに与える影響

    入力候補やチャットとは異なり、Copilot エージェント は「提案してから承認」フローに従って動作することはありません。 エージェントは複数ステップのタスクを計画して実行します。多くの場合、ユーザーが明示的に受け入れることなく、複数のファイルを繰り返し編集します。 このため、エージェント アクティビティの LoC メトリックの測定方法は異なります。

    行動LoC メトリックへの反映方法
    エージェントコード提案案表示されているコード ブロックがチャット パネルに表示されるときに、 loc_suggested_to_add_sum としてカウントされます。
    ファイル内のエージェントの編集
    loc_added_sum機能バケットでloc_deleted_sumおよびagent_editとしてカウントされます。 これらの編集は、推奨されるメトリックには含まれません。
    複数ファイルの操作各ファイル編集は、1 つのプロンプトによってトリガーされた場合でも、追加された行と削除された行の合計に影響します。

    エージェント関連の LoC アクティビティの出力例:

    "totals_by_language_feature": [
      {
        "language": "unknown",
        "feature": "chat_panel_agent_mode",
        "code_generation_activity_count": 12,
        "code_acceptance_activity_count": 0,
        "loc_suggested_to_add_sum": 86, // code block suggestions in chat panel in agent mode
        "loc_suggested_to_delete_sum": 0,
        "loc_added_sum": 5, // only includes code block copy or apply in chat panel, not agent edits
        "loc_deleted_sum": 0
      },
      {
        "language": "unknown",
        "feature": "agent_edit",
        "code_generation_activity_count": 345,
        "code_acceptance_activity_count": 0,
        "loc_suggested_to_add_sum": 0,
        "loc_suggested_to_delete_sum": 0,
        "loc_added_sum": 2342, // agent and edit mode edits in files
        "loc_deleted_sum": 947
      }
    ]
    

    単一のエージェント編集では、次のようなメトリックが表示される場合があります。

    "user_initiated_interaction_count": 0,
    "code_generation_activity_count": 1,
    "code_acceptance_activity_count": 0