여러 단계 작업을 위해 에이전트를 연결하고 작업을 전달합니다.

Completed

개별 사용자 지정 에이전트는 자체에서 강력하지만 복잡한 다단계 개발 작업을 처리하기 위해 순차로 연결할 때 모든 잠재력이 나타납니다. 핸드오프를 사용하면 한 에이전트가 다른 에이전트와 함께 다음 단계를 제안하여 대화 컨텍스트를 전달하고 특수한 역할 간에 원활한 전환을 제공할 수 있습니다.

핸드오프란 무엇인가요?

핸드오프는 한 사용자 지정 에이전트가 작업의 일부를 완료한 후 다른 에이전트로의 전환을 제안할 수 있도록 하는 메커니즘입니다. 에이전트가 응답을 완료하면 제안되는 "다음 작업"인 핸드오프 단추를 표시할 수 있습니다. 이 단추를 선택하면 채팅을 대상 에이전트로 전환하고 필요에 따라 워크플로를 계속하기 위한 프롬프트를 미리 입력합니다.

예를 들어 Planner 에이전트는 자세한 구현 계획을 생성한 다음 "구현 시작" 단추를 표시할 수 있습니다. 개발자가 이 단추를 선택하면 GitHub Copilot 채팅은 "이제 제안된 계획을 구현합니다."와 같은 프롬프트와 함께 계획을 컨텍스트로 수신하는 구현자 에이전트로 전환합니다. 개발자는 단추를 선택하기 전에 계획을 검토하여 에이전트가 특수 작업을 처리하는 동안 워크플로에 대한 제어를 유지 관리합니다.

이 방법은 각 에이전트가 개발 프로세스의 특정 단계를 처리하는 구조화된 다중 에이전트 워크플로를 만듭니다. 개발자는 각 전환을 감독하여 모든 단계에서 품질과 정확성을 보장합니다. 핸드오프 작업은 기본적으로 자동으로 실행되지 않습니다. 개발자가 핸드오프 단추를 선택해야 하며, 이를 통해 사람이 프로세스에 지속적으로 참여합니다.

핸드오프 구성

핸드오프를 설정하려면 사용자 지정 에이전트 .agent.md 파일의 YAML 프런트매터에 handoffs 섹션을 추가할 수 있습니다. 각 핸드오프 항목은 현재 에이전트와 대상 에이전트 간의 연결을 지정합니다.

핸드오프 항목에는 다음 필드가 포함됩니다.

  • label: 핸드오프 단추에 표시되는 텍스트입니다(예: "구현 시작" 또는 "테스트 실행").

  • agent: 전환할 대상 에이전트의 이름 또는 식별자입니다. 이 이름은 .agent.md 확장자 없이 파일 이름이나 name 대상 에이전트의 필드와 일치해야 합니다.

  • prompt: 다음 에이전트로 보낼 선택적 메시지입니다. 이 프롬프트는 대상 에이전트에 대한 컨텍스트 또는 지침(예: "이제 제안된 계획을 구현합니다." 또는 "이전 단계에서 변경한 코드 검토")을 제공합니다.

  • send: 프롬프트가 자동으로 제출되는지 여부를 제어하는 부울 값입니다. 기본값으로 false 설정하면 개발자가 보내기 전에 검토하고 편집할 수 있도록 채팅 입력에 프롬프트가 미리 채워집니다. 로 true설정하면 프롬프트가 즉시 제출되고 대상 에이전트가 즉시 작동하기 시작합니다.

  • 모델: 핸드오프를 실행할 때 사용할 특정 AI 모델을 지정하는 선택적 필드입니다. 형식은 Model Name (vendor)와 같습니다 GPT-4.1 (OpenAI)Claude Sonnet 4 (Anthropic). 이 필드는 워크플로의 여러 단계가 다양한 모델 기능(예: 계획을 위한 추론 모델 및 구현을 위한 더 빠른 모델 사용)의 이점을 누릴 때 유용합니다.

다음 YAML 코드 조각은 Implementer 에이전트에 대한 핸드오프로 구성된 Planner 에이전트를 보여줍니다.

---
description: Generates high-level implementation plans without writing code
tools: ['search', 'read', 'fetch']
handoffs:
  - label: Start Implementation
    agent: implementer
    prompt: Now implement the plan outlined above.
    send: false
---

Planner 에이전트가 응답을 완료하면 채팅에 "구현 시작" 단추가 나타납니다. 이 단추를 선택하면 구현자 에이전트로 전환되고, 대화 기록(계획 포함)을 전달하고, 개발자가 검토할 프롬프트 텍스트를 미리 입력합니다.

에이전트는 여러 핸드오프를 정의하여 다른 다음 단계를 제공할 수 있습니다. 예를 들어 Planner 에이전트는 "구현 시작" 및 "먼저 테스트 쓰기" 단추를 모두 제공하여 개발자가 상황에 따라 적절한 경로를 선택할 수 있도록 할 수 있습니다.

작업 전달을 검토하고 수락하기

핸드오프는 사용자가 명시적으로 작업하여 핸드오프 단추를 선택하는 것을 항상 포함합니다. 단, send 필드가 true로 설정되어 있는 경우는 예외입니다. 이 디자인은 개발자가 워크플로를 계속 제어하고 다음 단계로 이동하기 전에 각 에이전트의 출력을 검토할 수 있도록 합니다.

체인의 각 에이전트는 자체 정의된 도구 집합 및 명령 집합 내에서 작동합니다. 이 환경은 워크플로의 각 단계에서 가드레일을 제공합니다. 다음은 그 예입니다.

  • 도구만 있는 readsearch는 정보를 수집하고 계획을 제안할 수 있지만 실수로 코드를 수정할 수는 없습니다.
  • 및 도구가 있는 readeditterminal는 코드를 작성하고 빌드 명령을 실행할 수 있지만 지침의 특정 코딩 지침을 따릅니다.
  • 검토 에이전트는 read 및 search 도구만 사용하여 생성된 코드를 분석할 수 있지만, 수정할 수 없어 검토는 순전히 자문 역할을 합니다.

이러한 역할별 제약 조건은 각 단계에서 의도하지 않은 작업을 방지하여 다단계 프로세스를 보다 안정적으로 만듭니다. 개발자는 각 핸드오프 지점에서 출력을 검토하고 결과에 만족하는 경우에만 진행합니다.

일반적인 다단계 워크플로

다음 시나리오에서는 사용자 지정 에이전트를 연결하면 다양한 개발 활동에서 생산성을 향상시킬 수 있는 방법을 보여 줍니다.

기획 → 구현

Planner 에이전트를 사용하여 요구 사항을 분석하고 새 기능에 대한 자세한 구현 계획을 생성합니다. 이 계획은 변경이 필요한 파일을 식별하고, 구현 단계를 간략하게 설명하고, 잠재적인 위험을 강조 표시합니다. 그런 다음, 책임이 전환되어 계획에 따라 코드를 작성하고 프로젝트의 사용자 지정 지침 파일에 명시된 코딩 표준을 따르는 Implementer 에이전트로 옮겨집니다.

이 워크플로는 개발자가 전환을 제어할 수 있는 동시에 두 단계 모두에 AI를 사용하여 구현을 시작하기 전에 선임 엔지니어 계획 작동 방식을 반영합니다.

구현 → 코드 검토

코드가 인간 개발자나 AI 에이전트에 의해 생성된 후, 작업 전달은 코드 검토 에이전트로 전환될 수 있습니다. 검토 에이전트는 새 코드의 품질을 평가하고 버그, 보안 문제, 스타일 위반 및 누락된 에지 사례를 확인합니다. 그런 다음 검토 에이전트는 수동 수정에 대한 피드백을 제공하거나 개발자 승인에 따라 수정을 적용하는 "Fixer" 에이전트에 전달할 수 있습니다.

실패한 테스트 작성 → 전달할 코드 작성

두 에이전트 체인을 사용하여 TDD(Test-Driven 개발)를 적용합니다. 먼저 테스트 생성기 에이전트는 지정된 요구 사항에 대한 실패한 단위 테스트를 만듭니다. 개발자는 테스트를 검토하여 의도한 동작을 캡처하는지 확인합니다. 그런 다음 핸드오프는 해당 테스트를 통과하는 데 필요한 최소 코드를 작성하는 Implementer 에이전트로 전환됩니다. 이 체인은 AI 지원을 사용하여 적색-녹색 테스트 주기를 적용하여 테스트와 구현을 모두 생성합니다.

디버깅 및 패치

버그 수정 시나리오의 경우 디버깅 에이전트는 오류 로그를 읽고, 실패한 테스트를 검사하고, 관련 코드를 분석하여 문제의 원인을 가설합니다. 진단이 완료되면 편집 권한이 있는 패치 에이전트로 핸드오프가 전환되어 수정을 적용합니다. 최종 핸드오프는 테스트 에이전트를 호출하여 테스트 도구 모음을 실행하고 문제가 해결되었는지 확인할 수 있습니다.

리팩터링 또는 업그레이드

계획 에이전트를 사용하여 기존 코드베이스를 분석하고 리팩터링 또는 마이그레이션 계획을 간략하게 설명합니다(예: 이전 .NET 버전에서 .NET 8로 C# 프로젝트 업그레이드). 이 계획은 변경해야 하는 파일, API 및 패턴을 식별합니다. 작업 전달은 계획에 따라 파일 전체에서 코드 수정을 수행하는 업그레이드 에이전트로 전환됩니다. 검토 에이전트에 대한 최종 핸드오프는 마이그레이션 중에 도입된 문제에 대해 업데이트된 코드를 확인합니다.

비고

이러한 워크플로는 개발 팀이 각 단계를 감독하는 동안 다양한 특수 AI 도우미에게 일련의 작업(계획, 코드, 테스트, 검토)을 위임하는 방법을 반영합니다. 그 결과 반복적이거나 복잡한 작업이 AI에서 처리되어 개발자가 의사 결정 및 확인에 집중할 수 있는 보다 효율적인 워크플로가 만들어집니다.

에이전트 실행 환경

기본적으로 사용자 지정 에이전트는 클라이언트에서 실행됩니다(Visual Studio Code 내부). 그러나 에이전트의 YAML 프런트매터에서 설정 target: cloud 하여 클라우드에서 실행되도록 에이전트를 구성할 수도 있습니다. 클라우드 에이전트는 원격으로 실행되며 전체 기능 빌드 또는 포괄적인 테스트 도구 모음 실행과 같은 장기 실행 작업에 더 적합하며, 그렇지 않으면 로컬 Visual Studio Code 인스턴스를 계속 사용합니다. 백그라운드 에이전트는 관련 개념입니다. 채팅 인터페이스를 차단하지 않고 독립적으로 실행되므로 에이전트가 작업을 처리하는 동안 작업을 계속할 수 있습니다.

GitHub Copilot 후크

GitHub Copilot 후크를 사용하면 에이전트 워크플로의 전략적 지점에서 사용자 지정 셸 명령을 실행할 수 있습니다. 후크는 에이전트 파일이 아닌 Visual Studio Code 설정에 정의되며 GitHub Copilot가 파일을 저장하기 전이나 터미널 명령을 실행한 후와 같은 특정 이벤트 전후에 트리거됩니다. 예를 들어 GitHub Copilot에서 파일을 편집한 후 Linter를 자동으로 실행하도록 후크를 구성하여 AI 생성 코드가 저장되기 전에 항상 서식 표준을 충족하도록 할 수 있습니다.

후크는 에이전트의 자체 지침 및 도구를 보완하는 수명 주기 기반 작업을 추가하여 다중 에이전트 워크플로의 자동화 기능을 확장합니다.

비고

후크는 미리 보기 기능이며 해당 구성 형식이 변경될 수 있습니다. Visual Studio Code 설정에서 github.copilot.chat.hooks로 구성되며, postSaveFile, preRunTerminalCommand, postRunTerminalCommand와 같은 이벤트를 지원합니다.

요약

핸드오프는 여러 사용자 지정 에이전트를 단계별 순차 워크플로에 연결하여 각 에이전트가 특정 단계를 처리하는 다단계 개발 작업을 가능하게 합니다. 에이전트 파일의 YAML 프런트매터에서 핸드오프를 구성하여 계획에서 구현, 구현, 검토 또는 팀의 개발 프로세스와 일치하는 다른 시퀀스로 전환하는 체인을 만들 수 있습니다. 각 핸드오프는 다음 단계로 진행하기 전에 검토하고 승인할 수 있는 옵션을 사용하여 개발자를 제어합니다. 클라우드 에이전트, 백그라운드 실행 및 GitHub Copilot 후크와 같은 다른 기능은 원격 처리 및 수명 주기 자동화를 통해 이러한 워크플로를 확장합니다.