GitHub Copilot 에이전트 모드(프리뷰) 소개

justinyoo

Microsoft

Feb 26, 2025

GitHub Copilot 에이전트 모드를 소개합니다

2025년 2월 24일 | Isidor Nikolic

Copilot 에이전트 모드는 AI 지원 코딩의 새로운 진화 단계를 대표합니다. 이 기능은 동료 프로그래머처럼 자율적으로 동작하여 여러 단계를 거치는 코딩 작업을 수행합니다. 코드베이스를 분석하고 관련 파일을 읽고 파일 편집을 제안하며 터미널 명령어를 실행하고 테스트를 수행합니다. 또한 컴파일 및 린트 오류에 대응하고, 터미널 및 테스트 출력을 모니터링하며, 문제가 발생하면 자동으로 수정하여 작업을 완료할 때까지 반복적으로 개선합니다.

이 프리뷰 기능은 현재 VS Code 인사이더 버전 사용자에게 제공하며, 곧 VS Code 정식 버전에서도 사용할 수 있습니다.

Copilot 에이전트 모드 사용 방법

VS Code 인사이더에서 Copilot Edits 뷰 (Ctrl+Shift+I) 를 열고, 모드 드롭다운에서 Agent를 선택한 후 프롬프트를 입력하세요.

Copilot 에이전트 모드는 다음과 같은 작업을 수행할 수 있습니다:

애플리케이션 처음부터 생성하기
여러 파일에 걸쳐 리팩토링하기
테스트 코드 작성하고 실행하기
레거시 코드를 최신 프레임워크로 마이그레이션하기
자동으로 문서 생성하기
새 라이브러리 통합하기
복잡한 코드베이스에 대한 질문에 답변하기

Copilot 에이전트 모드는 보다 자율적이고 동적인 방식으로 원하는 결과를 얻기 위해 반복 작업을 수행합니다. 요청을 처리하는 동안 Copilot은 다음 단계를 여러 번 반복합니다:

관련 컨텍스트와 편집할 파일을 자동으로 선택합니다.
코드 변경 및 터미널 명령어 실행을 통해 작업을 완료합니다. 예를 들어, 코드 컴파일, 패키지 설치, 테스트 실행 등을 수행할 수 있습니다.
코드 수정의 정확성과 터미널 출력 결과를 모니터링하고 필요할 경우 반복하여 문제를 해결합니다.

Copilot 에이전트 모드는 이러한 작업을 수행하기 위해 다양한 도구를 활용합니다.

Copilot 에이전트 모드 UI 스크린샷

이상적인 상황이라면 Copilot 에이전트 모드의 최종 결과만 신경 쓰면 되겠지만, 때때로 실수를 하거나 예상과 다르게 동작할 수도 있습니다. 이러한 상황에서 사용자가 쉽게 개입하고 되돌릴 수 있도록 모든 도구를 호출하는 과정을 UI에 투명하게 표시하며, 터미널 명령어를 실행할 때는 승인을 요청합니다. 또한 강력한 되돌리기(Undo) 기능을 지원합니다. 완벽한 솔루션을 만들기 위해 엄청나게 자세하게 작성한 긴 프롬프트를 사용하는 대신 반복해서 Copilot을 합니다. 이 UI는 이런 반복작업을 위해 만들어졌으며 더 나은 최종 결과를 만들어내기 위해 이 반복작업을 사용자가 완전하게 제어할 수 있도록 합니다.

Copilot 에이전트 모드는 정확한 컨텍스트를 자동으로 찾아 작업에 필요한 파일을 설정합니다. 하지만 더 정밀하게 가이드하려면 #file을 사용하여 직접 컨텍스트를 참조하거나, 파일을 드래그 앤 드롭하거나 Add Files 버튼을 클릭하여 추가할 수도 있습니다. 예를 들어, specifications.md 파일을 생성하여 컨텍스트로 추가하면 Copilot이 더욱 정확하게 작업을 수행할 수 있습니다. 또한, 사용자 지정 지침을 설정하면 Copilot이 특정 코딩 스타일이나 선호도를 따르게 할 수도 있습니다.

참고: Copilot 에이전트 모드는 하나의 프롬프트에 대해 여러 요청을 보낼 수 있으므로 일반적인 편집 모드보다 속도가 느릴 수 있으며, 무료 Copilot 할당량을 더 빠르게 소진할 수 있습니다. 따라서, 작업이 명확하고 한정적인 범위에 대해서 사용할 경우에는 편집 모드를, 여러 파일에 걸친 대규모 변경이 필요할 때는 에이전트 모드를 사용하는 것이 좋습니다.

작동 방식

에이전트 모드 내부 구조 다이어그램

Copilot 에이전트 모드에서 요청을 보내면, 선택한 LLM(대형 언어 모델)로 다음과 같은 정보를 포함한 프롬프트를 전달합니다:

사용자 입력 쿼리
워크스페이스의 구조를 요약한 내용(전체 코드베이스가 아닌 핵심 정보만 포함)
OS 등 시스템 정보
사용 가능한 도구 목록 (및 선택적으로 도구 호출 결과)

각 도구는 특정 기능을 수행하며, Copilot은 이를 활용하여 코드 검색, 파일 읽기, 터미널 명령 실행, 컴파일 및 린트 오류 확인, 변경 제안사항 적용 등을 수행합니다. 이런 도구 리스트는 계속해서 늘어날 예정이며 어떤 도구들이 Copilot 에이전트 모드의 기능을 더 향상시킬 수 있는지 지속적으로 실험중입니다.

Copilot 에이전트 모드가 npm run dev 터미널 명령어를 수행하라고 제안하는 모습

각각의 도구는 각자 언제, 어떻게 사용할지에 대한 자세한 사용 지침을 LLM에 전달합니다. 아래는 read_file 도구에 대한 지침의 예시입니다.

{
  "name": "read_file",
  "description": "Read the contents of a file. You must specify the line range you're interested in, and if the file is larger, you will be given an outline of the rest of the file. If the file contents returned are insufficient for your task, you may call this tool again to retrieve more content.",
  "parameters": {
    "type": "object",
    "properties": {
      "filePath": {
        "description": "The absolute paths of the files to read.",
        "type": "string"
      },
      "startLineNumberBaseZero": {
        "type": "number",
        "description": "The line number to start reading from, 0-based."
      },
      "endLineNumberBaseZero": {
        "type": "number",
        "description": "The inclusive line number to end reading at, 0-based."
      }
    },
    "required": ["filePath", "startLineNumberBaseZero", "endLineNumberBaseZero"]
  }
}

LLM이 이 도구들을 더 정확하게 이해하고 쓸 수 있게끔 개발 시간의 상당량을 이 도구 사용 지침을 명확하게 하고 시스템 프롬프트를 정제하는데 투자했습니다. 이 프롬프트를 확인하기 위한 LLMOps 자동화 시스템을 이미 구축해 뒀지만, 실제 상황에서 얼마나 정확하게 쓰이는지 확인하는 작업은 여전히 필요하더군요.

GPT-4o 모델과 Claude Sonnet 모델이 살짝 다른 행동을 하는 경향이 있긴 하지만, 최대한 비슷하게 동작하게끔 시스템 프롬프트를 향상시켜 적용하고 있습니다. 향후 Copilot 에이전트 모드를 지원하는 더 많은 LLM을 추가할 계획이며 각 모델에 맞는 최적화된 프롬프트를 제공할 예정입니다.

VS Code 팀의 자체 사용 경험

VS Code 팀은 출시 초기부터 모든 코드에 자체적으로 Copilot을 활용하는 것을 중요하게 여깁니다. 우리 팀에서 사용하지 않는 기능을 굳이 출시할 가치가 있을까요?

현재 VS Code 팀은 200개 이상의 GitHub 리포지토리를 관리하고 있으며, 작은 프로젝트에서는 Copilot 에이전트 모드가 이미 큰 생산성 향상을 제공하고 있습니다. 예를 들어, 특정 기능이 어디에서 어떻게 구현되었는지 묻는 질문 같은 것에도 빠르게 답변할 수 있습니다. 반면, 대규모 코드베이스(예: vscode)에서 여러 파일에 걸친 리팩토링을 수행하는 것은 현재 AI 에이전트에게도 여전히 어려운 과제입니다. 하지만 이러한 환경에서도 Copilot 에이전트 모드가 더 많은 기회를 제공할 수 있도록 지속적으로 개선하고 있습니다.

또한, VS Code 팀원들은 개인적인 취미 프로젝트에서도 Copilot 에이전트 모드를 활용하고 있습니다. 예를 들어 날씨 예측 앱, 식단 관리, 커피 소비 기록, 운동 계획 앱 개발 등 다양한 작업에 활용하고 있습니다.

그거 아시나요? 현재 VS Code 팀은 GPT-4o보다 Claude Sonnet 모델을 선호한답니다!