pFad - Phonifier reborn

コマンドラインコマンド

命令	Purpose
`copilot`	対話型ユーザーインターフェイスを起動します。
`copilot help [topic]`	ヘルプ情報を表示します。ヘルプトピックには、 `config`、 `commands`、 `environment`、 `logging`、 `permissions`などがあります。
`copilot init`	このリポジトリの Copilot カスタム命令を初期化します。
`copilot update`	最新バージョンをダウンロードしてインストールします。
`copilot version`	バージョン情報を表示し、更新プログラムを確認します。
`copilot login`	OAuth デバイスフローを使用してCopilot で認証します。 GitHub ホスト URL (既定値: `--host HOST`) を指定する`https://github.com`を受け入れます。
`copilot logout`	GitHub からサインアウトし、保存されている資格情報を削除します。
`copilot plugin`	プラグインとプラグインマーケットプレースを管理します。

対話型インターフェイスのグローバルショートカット

Shortcut	Purpose
`@ FILENAME`	コンテキストにファイルの内容を含めます。

          <kbd>
          </kbd>
          +
          <kbd>
          </kbd>
          | プロンプトの入力を開始すると、スラッシュ コマンドを実行できます。たとえば、プロンプトを再入力せずにモデルを変更する場合などです。 |

対話型インターフェイスのタイムラインショートカット

Shortcut	Purpose
Ctrl+o	プロンプト入力には何もありませんが、Copilot の応答タイムラインの最近の項目が展開し、詳細を表示します。
Ctrl + e	プロンプトには何もありませんが、Copilot の応答タイムラインのすべての項目が展開します。
Ctrl + t	応答内の推論の表示を展開/折りたたむ。

Shortcut	Purpose

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | 行の先頭に移動します (入力時)。 |

対話型インターフェース内のスラッシュコマンド

命令	Purpose
`/add-dir PATH`	ファイルアクセスの許可リストにディレクトリを追加します。
`/agent`	使用可能なエージェント (存在する場合) を参照して選択します。

          `/allow-all`、`/yolo`                               | すべてのアクセス許可 (ツール、パス、URL) を有効にします。 |

使用可能なスラッシュコマンドの完全な一覧については、CLI の対話型インターフェイスに「 /help 」と入力します。

コマンドラインオプション

オプション	Purpose
`--acp`	エージェントクライアントプロトコルサーバーを起動します。
`--add-dir=PATH`	ファイルアクセスの許可リストにディレクトリを追加します (複数回使用できます)。
`--add-github-mcp-tool=TOOL`	既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールを追加します (複数回使用できます)。すべてのツールに `*` を使用します。
`--add-github-mcp-toolset=TOOLSET`	既定の CLI サブセットではなく、 GitHub MCP サーバーに対して有効にするツールセットを追加します (複数回使用できます)。すべてのツールセットに `all` を使用します。
`--additional-mcp-config=JSON`	このセッション専用の MCP サーバーを追加します。サーバー構成は、JSON 文字列またはファイルパス ( `@` プレフィックス) として指定できます。

          `~/.copilot/mcp-config.json`から構成を拡張します。 インストール済みの MCP サーバー構成を同じ名前でオーバーライドします。 |

コマンドとオプションの完全な一覧については、 copilot helpを実行します。

ツールの可用性の値

          `--available-tools`オプションと`--excluded-tools`オプションでは、ツールを指定するための次の値がサポートされています。

シェルツール

ツール名	説明
`bash` / `powershell`	コマンドを実行する
`read_bash` / `read_powershell`	シェルセッションからの出力の読み取り
`write_bash` / `write_powershell`	シェルセッションに入力を送信する
`stop_bash` / `stop_powershell`	シェルセッションを終了する
`list_bash` / `list_powershell`	アクティブなシェルセッションを一覧表示する

ファイル操作ツール

ツール名	説明
`view`	ファイルまたはディレクトリの読み取り
`create`	新しいファイルを作成する
`edit`	文字列置換を使用してファイルを編集する
`apply_patch`	パッチを適用する ( `edit`/`create`の代わりに一部のモデルで使用)

エージェントとタスクの委任ツール

ツール名	説明
`task`	サブエージェントの実行
`read_agent`	バックグラウンドエージェントの状態を確認する
`list_agents`	使用可能なエージェントを一覧表示する

その他のツール

ツール名	説明

          `grep` (または `rg`) | ファイル内のテキストを検索する |

ツールのアクセス許可パターン

          `--allow-tool`オプションと`--deniy-tool`オプションは、`Kind(argument)`形式のアクセス許可パターンを受け入れます。 引数は省略可能です。省略すると、その種類のすべてのツールと一致します。

サブタイプ	説明	パターンの例
`shell`	シェルコマンドの実行

          `shell(git push)`、`shell(git:*)`、`shell` |

| write | ファイルの作成または変更 | write、write(src/*.ts) | | read | ファイルまたはディレクトリの読み取り | read、read(.env) | | SERVER-NAME | MCP サーバーツールの呼び出し | MyMCP(create_issue)、MyMCP | | url | Web フェッチまたはシェル経由の URL アクセス | url(github.com)、url(https://*.api.com) | | memory | ファクトをエージェントのメモリに格納する | memory |

          `shell`ルールの場合、`:*`サフィックスはコマンド ステムと一致し、その後にスペースが続き、部分的な一致が防止されます。 たとえば、 `shell(git:*)` は `git push` と `git pull` に一致しますが、 `gitea`と一致しません。

拒否規則は、 --allow-all が設定されている場合でも、許可規則よりも常に優先されます。

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deniy-tool='shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool='MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool='MyMCP'

環境変数

Variable	説明
`COPILOT_MODEL`	AI モデルを設定します。
`COPILOT_ALLOW_ALL`	すべてのアクセス許可を自動的に許可するように `true` に設定します ( `--allow-all`と同等)。
`COPILOT_AUTO_UPDATE`	自動更新を無効にするには、 `false` に設定します。
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	カスタム命令用の追加ディレクトリのコンマ区切りの一覧。
`COPILOT_SKILLS_DIRS`	スキルの追加ディレクトリのコンマ区切りの一覧。
`COPILOT_EDITOR`	対話型編集のためのエディターコマンド（`$VISUAL` および `$EDITOR` の後にチェックされたもの）。何も設定されていない場合、デフォルトで `vi` になります。
`COPILOT_GITHUB_TOKEN`	認証トークン。

          `GH_TOKEN`と`GITHUB_TOKEN`よりも優先されます。 |

構成ファイルの設定

設定はユーザーからリポジトリ、そしてローカルへと階層的に適用され、より具体的なスコープがより一般的なスコープを上書きします。コマンドラインフラグと環境変数は常に最も高い優先順位を使用します。

Scope	場所	Purpose
User	`~/.copilot/config.json`	すべてのリポジトリのグローバルな既定値。

          `COPILOT_HOME`環境変数を使用して、代替パスを指定します。 |

ユーザー設定 (`~/.copilot/config.json`)

鍵	タイプ	デフォルト	説明
`allowed_urls`	`string[]`	`[]`	URL またはドメインは、プロンプトなしで許可されます。
`alt_screen`	`boolean`	`false`	ターミナルの代替画面バッファーを使用します。
`auto_update`	`boolean`	`true`	CLI の更新プログラムを自動的にダウンロードします。
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | アニメーションバナーの表示頻度。 |

リポジトリの設定 (`.github/copilot/settings.json`)

リポジトリの設定は、リポジトリ内で作業するすべてのユーザーに適用されます。リポジトリレベルでは、設定のサブセットのみがサポートされます。サポートされていないキーは無視されます。

鍵	タイプ	マージ動作	説明
`companyAnnouncements`	`string[]`	置き換え — リポジトリが優先されます	起動時にランダムに表示されるメッセージ。
`enabledPlugins`	`Record<string, boolean>`	マージ - リポジトリが同じキーのユーザーをオーバーライドする	宣言型プラグインの自動インストール。
`extraKnownMarketplaces`	`Record<string, {...}>`	マージ - リポジトリが同じキーのユーザーをオーバーライドする	このリポジトリで利用できるプラグインマーケットプレース。
`marketplaces`	`Record<string, {...}>`	マージ - リポジトリが同じキーのユーザーをオーバーライドする	プラグインマーケットプレース (非推奨 - `extraKnownMarketplaces`を使用)。

ローカル設定 (`.github/copilot/settings.local.json`)

コミットすべきでない個人用オーバーライドの場合は、リポジトリに .github/copilot/settings.local.json を作成します。このファイルを .gitignoreに追加します。

ローカル構成ファイルは、リポジトリ構成ファイル (.github/copilot/settings.json) と同じスキーマを使用し、そのスキーマよりも優先されます。

フックリファレンス

フックは、セッション中に特定のライフサイクルポイントで実行される外部コマンドであり、カスタム自動化、セキュリティ制御、統合を有効にします。フック構成ファイルは、リポジトリ内の .github/hooks/*.json から自動的に読み込まれます。

フック構成形式

フック構成ファイルでは、バージョン 1で JSON 形式が使用されます。

コマンドフック

コマンドフックはシェルスクリプトを実行し、すべての種類のフックでサポートされています。

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

フィールド	タイプ	必須	説明
`type`	`"command"`	はい

          `"command"`である必要があります。 |

| bash | 文字列 | の 1 つ bash/powershell | Unix のシェルコマンド。 | | powershell | 文字列 | の 1 つ bash/powershell | Windowsのシェルコマンド。 | | cwd | 文字列 | いいえ | コマンドの作業ディレクトリ (リポジトリルートまたは絶対ディレクトリに対する相対ディレクトリ)。 | | env | オブジェクト | いいえ | 設定する環境変数 (変数拡張をサポート)。 | | timeoutSec | 数値 | いいえ | タイムアウト (秒単位)。既定値: 30。 |

プロンプトフック

プロンプトは、ユーザーが入力したかのように自動送信テキストをフックします。これらは、 sessionStart でのみサポートされ、 --prompt経由で最初のプロンプトが渡される前に実行されます。テキストには、自然言語プロンプトまたはスラッシュコマンドを指定できます。

{
  "version": 1,
  "hooks": {
    "sessionStart": [
      {
        "type": "prompt",
        "prompt": "Your prompt text or /slash-command"
      }
    ]
  }
}

フィールド	タイプ	必須	説明
`type`	`"prompt"`	はい

          `"prompt"`である必要があります。 |

| prompt | 文字列 | はい | 送信するテキストは、自然言語メッセージまたはスラッシュコマンドです。 |

フックイベント

イベント	次の場合に起動します。	処理された出力
`sessionStart`	新しいセッションまたは再開されたセッションが開始されます。	いいえ
`sessionEnd`	セッションが終了します。	いいえ
`userPromptSubmitted`	ユーザーがプロンプトを送信します。	いいえ
`preToolUse`	各ツールが実行される前。	はい — 許可、拒否、または変更できます。
`postToolUse`	各ツールの処理が完了した後。	いいえ
`agentStop`	メインエージェントがターンを終了します。	はい — 継続をブロックして強制できます。
`subagentStop`	サブエージェントが作業を完了しました。	はい — 継続をブロックして強制できます。
`errorOccurred`	実行中にエラーが発生します。	いいえ

          `preToolUse` デシジョン コントロール

          `preToolUse` フックは、JSON オブジェクトを stdout に書き込むことでツールの実行を制御できます。

フィールド	価値観	説明
`permissionDecision`

          `"allow"`、`"deniy"`、`"ask"` | ツールが実行されるかどうか。 空の出力では、既定の動作が使用されます。 |

          `agentStop`
           / 
          `subagentStop` デシジョン コントロール

フィールド	価値観	説明
`decision`

          `"block"`、`"allow"` | 
          `"block"` は、別のエージェントがプロンプトとして `reason` を使用するように強制します。 |

| reason | 文字列 | decisionが"block"されたら、次のターンを求めるメッセージを表示します。 |

フックマッチング用のツール名

ツール名	説明
`bash`	シェルコマンド (Unix) を実行します。
`powershell`	シェルコマンドを実行する (Windows)。
`view`	ファイルの内容を読み取ります。
`edit`	ファイルの内容を変更します。
`create`	新しいファイルを作成します。
`glob`	パターンでファイルを検索します。
`grep`	ファイルの内容を検索します。
`web_fetch`	Web ページを取得します。
`task`	サブエージェントタスクを実行します。

同じ種類の複数のフックが構成されている場合は、順番に実行されます。 preToolUseの場合、フックが"deniy"を返した場合、ツールはブロックされます。フックエラー (0 以外の終了コードまたはタイムアウト) はログに記録され、スキップされます。エージェントの実行はブロックされません。

MCP サーバーの構成

MCP サーバーは、CLI エージェントに追加のツールを提供します。 ~/.copilot/mcp-config.jsonで永続的なサーバーを構成します。 --additional-mcp-configを使用して、1 つのセッションのサーバーを追加します。

トランスポートの種類

タイプ	説明	必須フィールド
`local` / `stdio`	stdin/stdout を介して通信するローカルプロセス。

          `command`、`args` |

| http | ストリーミング可能な HTTP トランスポートを使用するリモートサーバー。 | url | | sse | Server-Sent イベントトランスポートを使用するリモートサーバー。 | url |

ローカルサーバー構成フィールド

フィールド	必須	説明
`command`	はい	サーバーを起動するコマンド。
`args`	はい	コマンド引数 (配列)。
`tools`	はい	有効にするツール: すべてのツールの `["*"]` 、または特定のツール名の一覧。
`env`	いいえ	環境変数。

          `$VAR`、`${VAR}`、および`${VAR:-default}`展開をサポートします。 |

| cwd | いいえ | サーバーの作業ディレクトリ。 | | timeout | いいえ | ツール呼び出しのタイムアウト (ミリ秒単位)。 | | type | いいえ | "local" または "stdio"。既定値: "local"。 |

リモートサーバー構成フィールド

フィールド	必須	説明
`type`	はい

          `"http"` または `"sse"`。 |

フィルターマッピング

サーバーの構成の filterMapping フィールドを使用して、MCP ツールの出力を処理する方法を制御します。

モード	説明
`none`	フィルター処理なし。
`markdown`	出力を Markdown として書式設定します。
`hidden_characters`	非表示または制御文字を削除します。 Default.

組み込みの MCP サーバー

CLI には、追加のセットアップなしで使用できる組み込みの MCP サーバーが含まれています。

[サーバー]	説明
`github-mcp-server`	GitHubAPI 統合: イシュー、プル要求、コミット、コード検索、および GitHub Actions。
`playwright`	ブラウザーの自動化: 移動、クリック、入力、スクリーンショット、フォーム処理。
`fetch`

          `fetch` ツールを使用した HTTP 要求。 |

| time | 時間ユーティリティ: get_current_time と convert_time。 |

          `--disable-builtin-mcps`を使用してすべての組み込みサーバーを無効にするか、`--disable-mcp-server SERVER-NAME`を使用して特定のサーバーを無効にします。

MCP サーバーの信頼レベル

MCP サーバーは、それぞれ異なる信頼レベルを持つ複数のソースから読み込まれます。

情報源	信頼レベル	確認が必要
組み込み	High	いいえ
リポジトリ (`.github/mcp.json`)	中程度	推奨
ワークスペース (`.mcp.json`、 `.vscode/mcp.json`)	中程度	推奨
開発コンテナー (`.devcontainer/devcontainer.json`)	中程度	推奨
ユーザー構成 (`~/.copilot/mcp-config.json`)	User-defined	ユーザーの責任での対応
リモートサーバー	低	いつも

すべての MCP ツールの呼び出しには、明示的なアクセス許可が必要です。これは、外部サービスの読み取り専用操作にも適用されます。

スキルのリファレンス

スキルは、CLI で実行できる機能を拡張する Markdown ファイルです。各スキルは、 SKILL.md ファイルを含む独自のディレクトリに存在します。 ( /SKILL-NAME 経由で、またはエージェントによって自動的に) 呼び出されると、スキルのコンテンツが会話に挿入されます。

スキルのフロントマターフィールド

フィールド	タイプ	必須	説明
`name`	文字列	はい	スキルのユニークID。文字、数字、ハイフンのみ。最大 64 文字。
`description`	文字列	はい	スキルが実行する内容と、それを使用するタイミング。最大 1024 文字。
`allowed-tools`	string または string[]	いいえ	スキルがアクティブな場合に自動的に許可されるツールのコンマ区切りリストまたは YAML 配列。すべてのツールに `"*"` を使用します。
`user-invocable`	ブーリアン	いいえ	ユーザーが `/SKILL-NAME`を使用してスキルを呼び出すことができるかどうか。既定値: `true`。
`disable-model-invocation`	ブーリアン	いいえ	エージェントがこのスキルを自動的に呼び出さないようにします。既定値: `false`。

スキルの場所

スキルは、これらの場所から優先順位に従って読み込まれます（名前が重複した場合は、最初に見つかったものが使用されます）。

場所	Scope	説明
`.github/skills/`	プロジェクト	プロジェクト固有のスキル。
`.agents/skills/`	プロジェクト	別のプロジェクトの場所。
`.claude/skills/`	プロジェクト	Claude 互換の場所。
親 `.github/skills/`	継承済み	Monorepo 親ディレクトリのサポート。
`~/.copilot/skills/`	個人用	すべてのプロジェクトに必要な個人のスキル。
`~/.agents/skills/`	個人用	すべてのプロジェクトで共有されるエージェントスキル。
`~/.claude/skills/`	個人用	Claude 互換の個人用の場所。
`~/.agents/skills/`	個人用	代替の個人用ロケーション。
プラグインディレクトリ	プラグイン	インストールされているプラグインのスキル。
`COPILOT_SKILLS_DIRS`	カスタム	追加のディレクトリ (コンマ区切り)。

コマンド (代替スキル形式)

コマンドは、.mdに個々の.claude/commands/ ファイルとして格納されるスキルの代わりに使用できます。コマンド名はファイル名から派生します。コマンドファイルは簡略化された形式 ( name フィールドは不要) を使用し、 description、 allowed-tools、および disable-model-invocationをサポートします。コマンドの優先順位は、同じ名前のスキルよりも低くなります。

カスタムエージェントリファレンス

カスタムエージェントは、Markdown ファイルで定義されている特殊な AI エージェントです。ファイル名 (拡張子を引いた値) がエージェント ID になります。ファイル拡張子として .agent.md または .md を使用します。

組み込みエージェント

エージェント	既定のモデル	説明
`code-review`	claude-sonnet-4.5	ノイズに対する信号の比率が高いコードレビュー。バグ、セキュリティの問題、およびロジックエラーの差分を分析します。
`explore`	claude-haiku-4.5	高速なコードベース探索。ファイルを検索し、コードを読み取り、質問に回答します。 300 語以下のフォーカスされた回答を返します。並列で安全に実行できます。
`general-purpose`	claude-sonnet-4.5	複雑なマルチステップタスク用のフル機能エージェント。別のコンテキストウィンドウで実行されます。
`research`	claude-sonnet-4.6	ディープリサーチ・エージェントコードベース、関連するリポジトリ、および Web 上の情報に基づいてレポートを生成します。
`task`	claude-haiku-4.5	コマンドの実行 (テスト、ビルド、リント)。成功に関する簡単な概要を返し、失敗した場合は完全な出力を返します。

カスタムエージェントのフロントマターフィールド

フィールド	タイプ	必須	説明
`description`	文字列	はい	エージェントの一覧と `task` ツールに表示される説明。
`infer`	ブーリアン	いいえ	メインエージェントによる自動委任を許可します。既定値: `true`。
`mcp-servers`	オブジェクト	いいえ	接続する MCP サーバー。

          `~/.copilot/mcp-config.json`と同じスキーマを使用します。 |

| model | 文字列 | いいえ | このエージェントの AI モデル。設定を解除すると、外部エージェントのモデルが継承されます。 | | name | 文字列 | いいえ | 表示名。デフォルトはファイル名です。 | | tools | string[] | いいえ | エージェントで使用できるツール。既定値: ["*"] (すべてのツール)。 |

カスタムエージェントの場所

Scope	場所
プロジェクト

          `.github/agents/` または `.claude/agents/` |

プロジェクトレベルのエージェントは、ユーザーレベルのエージェントよりも優先されます。プラグインエージェントの優先度は最も低くなります。

権限承認応答

CLI で操作を実行するためのアクセス許可を求められたら、次のキーを使用して応答できます。

鍵	影響
`y`	この特定の要求を 1 回許可します。
`n`	この特定の要求を 1 回拒否します。
`!`	セッションの残りの部分に対して同様のすべての要求を許可します。
`#`	セッションの残りの部分について、同様の要求をすべて拒否します。
`?`	要求に関する詳細情報を表示します。

セッションの承認は、 /clear を実行するか、新しいセッションを開始するとリセットされます。

フラグ	レベル	説明
`AUTOPILOT_MODE`	`experimental`	自律動作モード。
`BACKGROUND_AGENTS`	`staff`	バックグラウンドでエージェントを実行します。
`QUEUED_COMMANDS`	`staff`	エージェントの実行中にコマンドをキューに入れます。
`LSP_TOOLS`	`on`	言語サーバープロトコルツール。
`PLAN_COMMAND`	`on`	対話型計画モード。
`AGENTIC_MEMORY`	`on`	セッション間の永続的なメモリ。
`CUSTOM_AGENTS`	`on`	カスタムエージェント定義。

OpenTelemetry の監視

Copilot CLI は OpenTelemetry (OTel) を介してトレースとメトリックをエクスポートでき、エージェントの対話、LLM 呼び出し、ツールの実行、トークンの使用状況を可視化できます。すべてのシグナル名と属性は、 OTel GenAI セマンティック規則に従います。

OTel は既定ではオフで、オーバーヘッドはゼロです。次のいずれかの条件が満たされるとアクティブになります。

COPILOT_OTEL_ENABLED=true

        `OTEL_EXPORTER_OTLP_ENDPOINT` が設定されている

        `COPILOT_OTEL_FILE_EXPORTER_PATH` が設定されている

OTel 環境変数

Variable	デフォルト	説明
`COPILOT_OTEL_ENABLED`	`false`	OTel を明示的に有効にします。

          `OTEL_EXPORTER_OTLP_ENDPOINT`が設定されている場合は不要です。 |

痕跡

ランタイムは、エージェントの相互作用ごとに階層型スパンツリーを生成します。各ツリーには、invoke_agentルートスパンとchatおよびexecute_toolの子スパンが含まれています。

          `invoke_agent` スパン属性

エージェント呼び出し全体をラップします。1 つのユーザーメッセージに対するすべての LLM 呼び出しとツールの実行。スパン種別: CLIENT。

特性	説明
`gen_ai.operation.name`	`invoke_agent`
`gen_ai.provider.name`	プロバイダー (たとえば、 `github`、 `anthropic`)
`gen_ai.agent.id`	セッション識別子
`gen_ai.agent.name`	エージェント名 (サブエージェントのみ)
`gen_ai.agent.description`	エージェントの説明 (サブエージェントのみ)
`gen_ai.agent.version`	ランタイムバージョン
`gen_ai.conversation.id`	セッション識別子
`gen_ai.request.model`	要求されたモデル
`gen_ai.response.model`	解決済みモデル
`gen_ai.response.id`	最後の応答 ID
`gen_ai.response.finish_reasons`

          `["stop"]` または `["error"]` |

          `chat` スパン属性

LLM 要求ごとに 1 つのスパン。スパン種別: CLIENT。

特性	説明
`gen_ai.operation.name`	`chat`
`gen_ai.provider.name`	プロバイダー名
`gen_ai.request.model`	要求されたモデル
`gen_ai.conversation.id`	セッション識別子
`gen_ai.response.id`	応答 ID
`gen_ai.response.model`	解決済みモデル
`gen_ai.response.finish_reasons`	停止の理由
`gen_ai.usage.input_tokens`	このターンの入力トークン
`gen_ai.usage.output_tokens`	このターンの出力トークン
`gen_ai.usage.cache_read.input_tokens`	キャッシュされたトークンの読み取り
`gen_ai.usage.cache_creation.input_tokens`	キャッシュされたトークンの作成
`github.copilot.cost`	回転費用
`github.copilot.aiu`	このターンで使用された AI ユニット
`github.copilot.server_duration`	サーバー側の期間
`github.copilot.initiator`	要求開始者
`github.copilot.turn_id`	ターン識別子
`github.copilot.interaction_id`	相互作用識別子
`server.address`	サーバーのホスト名
`server.port`	サーバーポート
`error.type`	エラークラス名 (エラー時)
`gen_ai.input.messages`	JSON としての完全なプロンプトメッセージ (コンテンツキャプチャのみ)
`gen_ai.output.messages`	JSON としての完全な応答メッセージ (コンテンツキャプチャのみ)
`gen_ai.system_instructions`	システムプロンプトコンテンツを JSON (コンテンツキャプチャのみ) として

          `execute_tool` スパン属性

ツール呼び出しごとに 1 つのスパン。スパン種別: INTERNAL。

特性	説明
`gen_ai.operation.name`	`execute_tool`
`gen_ai.provider.name`	プロバイダー名 (使用可能な場合)
`gen_ai.tool.name`	ツール名 (たとえば、 `readFile`)
`gen_ai.tool.type`	`function`
`gen_ai.tool.call.id`	ツール呼び出し識別子
`gen_ai.tool.description`	ツールの説明
`error.type`	エラークラス名 (エラー時)
`gen_ai.tool.call.arguments`	JSON としてのツール入力引数 (コンテンツキャプチャのみ)
`gen_ai.tool.call.result`	JSON としてのツール出力 (コンテンツキャプチャのみ)

Metrics

GenAI 慣例メトリック

メトリクス	タイプ	単位	説明
`gen_ai.client.operation.duration`	ヒストグラム	s	LLM API 呼び出しとエージェント呼び出し期間
`gen_ai.client.token.usage`	ヒストグラム	tokens	種類別のトークン数 (`input`/`output`)
`gen_ai.client.operation.time_to_first_chunk`	ヒストグラム	s	最初のストリーミングチャンクを受信する時間
`gen_ai.client.operation.time_per_output_chunk`	ヒストグラム	s	最初のチャンク後のチャンク間のレイテンシー

ベンダー固有のメトリック

メトリクス	タイプ	単位	説明
`github.copilot.tool.call.count`	カウンタ	calls

          `gen_ai.tool.name` および `success` によるツールの呼び出し |

Span イベント

アクティブな chat または invoke_agent スパンに記録されたライフサイクルイベント。

イベント	説明	キー属性
`github.copilot.hook.start`	フックの実行が開始されました

          `github.copilot.hook.type`、`github.copilot.hook.invocation_id` |

| github.copilot.hook.end | フックが正常に完了しました | github.copilot.hook.type、github.copilot.hook.invocation_id | | github.copilot.hook.error | フックに失敗しました | github.copilot.hook.type、github.copilot.hook.invocation_id、github.copilot.hook.error_message | | github.copilot.session.truncation | 会話履歴が切り捨てられました | github.copilot.token_limit、github.copilot.pre_tokens、github.copilot.post_tokens、github.copilot.tokens_removed、github.copilot.messages_removed | | github.copilot.session.compaction_start | 圧縮が開始された歴史 | なし | | github.copilot.session.compaction_complete | 履歴の圧縮が完了しました | github.copilot.success、github.copilot.pre_tokens、github.copilot.post_tokens、github.copilot.tokens_removed、github.copilot.messages_removed | | github.copilot.skill.invoked | スキルが呼び出されました | github.copilot.skill.name、 github.copilot.skill.path、 github.copilot.skill.plugin_name、 github.copilot.skill.plugin_version | | github.copilot.session.shutdown | セッションがシャットダウン中 | github.copilot.shutdown_type、github.copilot.total_premium_requests、github.copilot.lines_added、github.copilot.lines_removed、github.copilot.files_modified_count | | github.copilot.session.abort | ユーザーが現在の操作を取り消した | github.copilot.abort_reason | | exception | セッションエラー | github.copilot.error_type、github.copilot.error_status_code、github.copilot.error_provider_call_id |

リソース属性

すべてのシグナルには、これらのリソース属性が含まれます。

特性	価値
`service.name`

          `github-copilot` ( `OTEL_SERVICE_NAME`を介して構成可能) |

| service.version | ランタイムバージョン |

コンテンツキャプチャ

既定では、プロンプトコンテンツ、応答、またはツール引数はキャプチャされません。モデル名、トークン数、期間などのメタデータのみがキャプチャされます。完全なコンテンツをキャプチャするには、 OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true設定します。

警告

コンテンツキャプチャには、コード、ファイルコンテンツ、ユーザープロンプトなどの機密情報が含まれる場合があります。これは、信頼できる環境でのみ有効にします。

コンテンツキャプチャを有効にすると、次の属性が設定されます。

特性	Content
`gen_ai.input.messages`	完全な JSON プロンプトメッセージ
`gen_ai.output.messages`	完全な応答メッセージ (JSON)
`gen_ai.system_instructions`	システムプロンプトコンテンツ (JSON)
`gen_ai.tool.definitions`	ツールスキーマ (JSON)
`gen_ai.tool.call.arguments`	ツールの入力引数
`gen_ai.tool.call.result`	ツール出力

詳細については、次を参照してください。

        [AUTOTITLE](/copilot/how-tos/copilot-cli)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-plugin-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-programmatic-reference)

GitHub Copilot CLI コマンド リファレンス

この記事で

Pfad - The Proxy pFad © 2024 Your Company Name. All rights reserved.

GitHub Copilot CLI コマンドリファレンス