GitHub Copilot CLI 명령 참조

명령줄 명령어

Command	Purpose
`copilot`	대화형 사용자 인터페이스를 시작합니다.
`copilot help [topic]`	도움말 정보를 표시합니다. 도움말 항목에는 다음이 포함됩니다: `config`, `commands`, `environment`, `logging`, 및 `permissions`.
`copilot init`	이 리포지토리에 대한 Copilot 사용자 지정 지침을 초기화합니다.
`copilot update`	최신 버전을 다운로드하고 설치합니다.
`copilot version`	버전 정보를 표시하고 업데이트를 확인합니다.
`copilot login`	OAuth 디바이스 플로우를 사용하여 Copilot로 인증합니다.

          `--host HOST`를 허용하여 GitHub 호스트 URL(기본값: `https://github.com`)을 지정합니다. |

대화형 인터페이스 내 전역 단축키

Shortcut	Purpose
`@ FILENAME`	컨텍스트에 파일 내용을 포함합니다.

          <kbd>Ctrl</kbd>+<kbd>그런 다음 X</kbd>`/`  | 프롬프트 입력을 시작한 후에는 프롬프트를 다시 입력하지 않고도 모델을 변경하려는 경우 슬래시 명령을 실행할 수 있습니다. |

대화형 인터페이스의 타임라인 바로 가기

Shortcut	Purpose
Ctrl+o	프롬프트에 입력된 내용이 없더라도, Copilot의 응답 시간표에서 최근 항목을 확장하여 더 많은 세부 정보를 표시합니다.
Ctrl+e	프롬프트 입력에 아무것도 없을 때, Copilot의 응답 타임라인의 모든 항목이 확장됩니다.
Ctrl+t	응답에서 추론 표시를 확장/축소합니다.

Shortcut	Purpose

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | 입력할 때 줄의 시작 부분으로 이동합니다. |

대화형 인터페이스의 슬래시 명령

Command	Purpose
`/add-dir PATH`	파일 액세스를 위해 허용된 목록에 디렉터리를 추가합니다.
`/agent`	사용 가능한 에이전트(있는 경우)를 찾아 선택합니다.

          `/allow-all`, `/yolo`                               | 모든 권한(도구, 경로 및 URL)을 사용하도록 설정합니다. |

사용 가능한 슬래시 명령의 전체 목록을 보려면 CLI의 대화형 인터페이스에 입력 /help 합니다.

명령줄 옵션

Option	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합니다.

도구 사용 권한 패턴

          `--allow-tool` 및 `--deny-tool` 옵션은 사용 권한 패턴을 형식`Kind(argument)`으로 허용합니다. 인수는 선택 사항이며, 이를 생략하면 해당 종류의 모든 도구와 일치하게 됩니다.

Kind	설명	예제 패턴
`shell`	셸 명령 실행

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

| write | 파일 만들기 또는 수정 | write, write(src/*.ts) | | read | 파일 또는 디렉터리 읽기 | read, read(.env) | | SERVER-NAME | MCP 서버 도구 호출 | MyMCP(create_issue), MyMCP | | url | 웹 페치 또는 셸을 통한 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:*)' --deny-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'

환경 변수

변수	설명
`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
사용자	`~/.copilot/config.json`	모든 리포지토리의 전역 기본값입니다. 환경 변수를 `COPILOT_HOME` 사용하여 대체 경로를 지정합니다.
리포지토리	`.github/copilot/settings.json`	공유 리포지토리 구성(리포지토리에 커밋됨)
로컬	`.github/copilot/settings.local.json`	개인 재정의(여기에 `.gitignore` 추가).

사용자 설정(`~/.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[]`	Replaced - 리포지토리가 우선합니다.	시작 시 임의로 표시되는 메시지입니다.
`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 | 문자열 | 다음 중 하나 bash/powershell | Unix에 대한 셸 명령입니다. | | powershell | 문자열 | 다음 중 하나 bash/powershell | Windows용 셸 명령입니다. | | cwd | 문자열 | No | 명령에 대한 작업 디렉터리입니다(리포지토리 루트 또는 절대를 기준으로). | | env | 객체 | No | 설정할 환경 변수(변수 확장 지원). | | timeoutSec | 숫자 | No | 초 단위의 시간 제한입니다. 기본값: 30. |

프롬프트 후크

사용자가 입력한 것처럼 프롬프트 후크가 텍스트를 자동으로 제출합니다. sessionStart에서만 지원되며 --prompt를 통해 초기 프롬프트가 전달되기 전에 실행됩니다. 텍스트는 자연어 프롬프트 또는 슬래시 명령일 수 있습니다.

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

분야	유형	필수	설명
`type`	`"prompt"`	예

          `"prompt"`이어야 합니다. |

| prompt | 문자열 | 예 | 제출할 텍스트는 자연어 메시지 또는 슬래시 명령일 수 있습니다. |

후크 이벤트

이벤트	발생하는 경우	처리된 출력
`sessionStart`	새 세션 또는 다시 시작된 세션이 시작됩니다.	No
`sessionEnd`	세션이 종료됩니다.	No
`userPromptSubmitted`	사용자가 프롬프트를 제출합니다.	No
`preToolUse`	각 도구를 실행하기 전에.	예 - 허용, 거부 또는 수정할 수 있습니다.
`postToolUse`	각 도구가 완료된 후	No
`agentStop`	주 에이전트가 턴을 완료합니다.	예 - 연속을 차단하고 강제 적용할 수 있습니다.
`subagentStop`	서브에이전트가 완료됩니다.	예 - 연속을 차단하고 강제 적용할 수 있습니다.
`errorOccurred`	실행하는 동안 오류가 발생합니다.	No

          `preToolUse` 의사 결정 제어

          `preToolUse` 후크는 stdout에 JSON 개체를 작성하여 도구 실행을 제어할 수 있습니다.

분야	가치들	설명
`permissionDecision`

          `"allow"`, , `"deny"``"ask"` | 도구가 실행되는지 여부입니다. 빈 출력은 기본 동작을 사용합니다. |

          `agentStop`
           / 
          `subagentStop` 의사 결정 제어

분야	가치들	설명
`decision`

          `"block"`, `"allow"` | 
          `"block"` 는 `reason` 를 프롬프트로 사용하여 다른 에이전트의 차례를 강제합니다. |

| reason | 문자열 | decision가 "block"일 때 다음 턴에 대한 프롬프트. |

후크 일치를 위한 도구 이름

도구 이름	설명
`bash`	셸 명령 실행(Unix).
`powershell`	셸 명령을 실행합니다(Windows).
`view`	파일 내용을 읽습니다.
`edit`	파일 내용을 수정합니다.
`create`	새 파일을 만듭니다.
`glob`	패턴별로 파일을 찾습니다.
`grep`	파일 콘텐츠를 검색합니다.
`web_fetch`	웹 페이지를 가져옵니다.
`task`	서브에이전트 작업을 실행합니다.

동일한 형식의 여러 후크가 구성된 경우 순서대로 실행됩니다. 의 경우 preToolUse후크가 반환 "deny"되면 도구가 차단됩니다. 후크 오류(0이 아닌 종료 코드 또는 시간 초과)는 로그에 기록되며 건너뜁니다. 이러한 오류는 에이전트 실행을 절대 차단하지 않습니다.

MCP 서버 구성

MCP 서버는 CLI 에이전트에 추가 도구를 제공합니다. ~/.copilot/mcp-config.json에서 영구 서버를 구성하십시오. 단일 세션에 대한 서버를 추가하는 데 사용합니다 --additional-mcp-config .

전송 형식

유형	설명	필수 필드
`local` / `stdio`	stdin/stdout을 통해 통신하는 로컬 프로세스입니다.

          `command`, `args` |

| http | 스트리밍 가능한 HTTP 전송을 사용하는 원격 서버입니다. | url | | sse | Server-Sent 이벤트 전송을 사용하는 원격 서버입니다. | url |

로컬 서버 구성 필드

분야	필수	설명
`command`	예	서버를 시작하는 명령입니다.
`args`	예	명령 인수(배열).
`tools`	예	사용하도록 설정할 도구: `["*"]` 모두 또는 특정 도구 이름 목록
`env`	No	환경 변수입니다.

          `$VAR`, `${VAR}`, 및 `${VAR:-default}` 확장을 지원합니다. |

| cwd | No | 서버에 대한 작업 디렉터리입니다. | | timeout | No | 도구 호출 시간 제한(밀리초)입니다. | | type | No | "local" 또는 "stdio". 기본값: "local". |

원격 서버 구성 필드

분야	필수	설명
`type`	예

          `"http"` 또는 `"sse"`. |

필터 매핑

MCP 도구 출력이 처리되는 방법을 서버 구성의 filterMapping 필드를 사용하여 제어합니다.

모드	설명
`none`	필터링이 없습니다.
`markdown`	출력의 서식을 Markdown으로 지정합니다.
`hidden_characters`	숨겨진 문자 또는 컨트롤 문자를 제거합니다. Default.

기본 제공 MCP 서버

CLI에는 추가 설정 없이 사용할 수 있는 기본 제공 MCP 서버가 포함되어 있습니다.

서버	설명
`github-mcp-server`	GitHub API 통합: 문제, 풀 리퀘스트, 커밋, 코드 검색 및 GitHub Actions.
`playwright`	브라우저 자동화: 탐색, 클릭, 입력, 스크린샷 및 양식 처리
`fetch`	HTTP 요청은 `fetch` 도구를 통해 이루어집니다.
`time`	시간 유틸리티: `get_current_time` 및 `convert_time`.

모든 기본 제공 서버를 사용하지 않도록 설정하거나 --disable-builtin-mcps 특정 서버를 사용하지 않도록 설정하는 데 사용합니다--disable-mcp-server SERVER-NAME.

MCP 서버 신뢰 수준

MCP 서버는 각각 다른 신뢰 수준을 가진 여러 원본에서 로드됩니다.

출처	신뢰 수준	검토 필요
내장형	높음	No
리포지토리(`.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`	문자열	예	스킬의 고유 식별자입니다. 문자, 숫자 및 하이픈만 해당됩니다. 최대 64자
`description`	문자열	예	기술이 수행하는 기능 및 사용 시기. 최대 1024자
`allowed-tools`	string 또는 string[]	No	기술이 활성 상태일 때 자동으로 허용되는 쉼표로 구분된 목록 또는 YAML 도구 배열입니다. 모든 도구에 `"*"`을 사용하십시오.
`user-invocable`	부울	No	사용자가 `/SKILL-NAME`를 사용하여 기술을 호출할 수 있는지 여부입니다. 기본값: `true`.
`disable-model-invocation`	부울	No	에이전트가 이 기술을 자동으로 호출하지 않도록 합니다. 기본값: `false`.

기술 위치

스킬은 우선순위에 따라 이 위치에서 로드됩니다(중복 이름의 경우, 먼저 발견된 것이 우선합니다).

위치	Scope	설명
`.github/skills/`	프로젝트	프로젝트별 기술.
`.agents/skills/`	프로젝트	대체 프로젝트 위치입니다.
`.claude/skills/`	프로젝트	클로드 호환 위치입니다.
부모 `.github/skills/`	Inherited	Monorepo 부모 디렉터리 지원.
`~/.copilot/skills/`	개인적인	모든 프로젝트에 대한 개인 기술.
`~/.claude/skills/`	개인적인	Claude와 호환되는 사용자의 위치.
플러그 인 디렉터리	플러그 인	설치된 플러그인에서 제공하는 기능입니다.
`COPILOT_SKILLS_DIRS`	Custom	추가 디렉터리(쉼표로 구분).

명령(대체 기술 형식)

명령은 .에 개별 .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`	클로드 소넷-4.6	심층 연구 에이전트. 코드베이스, 관련 리포지토리 및 웹의 정보를 기반으로 보고서를 생성합니다.
`task`	claude-haiku-4.5	명령 실행(테스트, 빌드, 린트). 성공, 실패의 전체 출력에 대한 간략한 요약을 반환합니다.

사용자 지정 에이전트 프런트매터 필드

분야	유형	필수	설명
`description`	문자열	예	에이전트 목록 및 `task` 도구에 표시된 설명입니다.
`infer`	부울	No	주 에이전트에서 자동 위임을 허용합니다. 기본값: `true`.
`mcp-servers`	객체	No	연결할 MCP 서버입니다. 와 동일한 스키마를 `~/.copilot/mcp-config.json`사용합니다.
`model`	문자열	No	이 에이전트에 대한 AI 모델입니다. 설정되지 않은 경우 외부 에이전트의 모델을 상속합니다.
`name`	문자열	No	표시 이름: 기본값은 파일 이름입니다.
`tools`	문자열[]	No	에이전트에서 사용할 수 있는 도구입니다. 기본값: `["*"]` (모든 도구).

사용자 지정 에이전트 위치

Scope	위치
프로젝트

          `.github/agents/` 또는 `.claude/agents/` |

프로젝트 수준 에이전트는 사용자 수준 에이전트보다 우선합니다. 플러그 인 에이전트의 우선 순위가 가장 낮습니다.

사용 권한 승인 응답

CLI에서 작업을 실행할 수 있는 권한을 묻는 메시지가 표시되면 다음 키로 응답할 수 있습니다.

암호키	영향
`y`	이 특정 요청을 한 번 허용합니다.
`n`	이 특정 요청을 한 번 거부합니다.
`!`	세션의 나머지 부분에 대해 유사한 모든 요청을 허용합니다.
`#`	세션의 나머지 부분에 대해 유사한 모든 요청을 거부합니다.
`?`	요청에 대한 자세한 정보를 표시합니다.

새 세션을 실행 /clear 하거나 시작할 때 세션 승인이 다시 설정됩니다.

Flag	계층	설명
`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 환경 변수

변수	기본값	설명
`COPILOT_OTEL_ENABLED`	`false`	OTel을 명시적으로 사용하도록 설정합니다. 설정된 경우 `OTEL_EXPORTER_OTLP_ENDPOINT` 필요하지 않습니다.
`OTEL_EXPORTER_OTLP_ENDPOINT`	—	OTLP 엔드포인트 URL입니다. 이를 자동으로 설정하면 OTel이 활성화됩니다.
`COPILOT_OTEL_EXPORTER_TYPE`	`otlp-http`	내보내기 형식: `otlp-http` 또는 `file`.

          `file`이(가) 설정되면 `COPILOT_OTEL_FILE_EXPORTER_PATH`을(를) 자동으로 선택합니다. |

Traces

런타임은 각 에이전트 상호 작용에 대한 계층적 범위 트리를 내보낸다. 각 트리에는 invoke_agent 루트 범위와 chat``execute_tool 자식 범위가 포함됩니다.

          `invoke_agent` 범위 속성

전체 에이전트 호출을 래핑합니다. 하나의 사용자 메시지에 대한 모든 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 요청당 하나의 범위입니다. 범위 종류: 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` 범위 속성

도구 호출당 하나의 범위입니다. 범위 종류: 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 규칙 메트릭

Metric	유형	단위	설명
`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	첫 번째 청크 이후의 청크 간 대기 시간

공급업체별 메트릭

Metric	유형	단위	설명
`github.copilot.tool.call.count`	계수기	호출

          `gen_ai.tool.name` 및 `success`에 의한 도구 호출 |

이벤트 범위 지정

활성 chat 또는 invoke_agent 범위에 기록된 수명 주기 이벤트입니다.

이벤트	설명	주요 속성
`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)

이 문서의 내용