기능
이 가이드에서는 Copilot SDK 애플리케이션에 추가할 수 있는 기능을 다룹니다. 각 가이드에는 지원되는 언어(TypeScript, Python, Go, .NET, Java 및 Rust)의 예제가 포함되어 있습니다.
에이전트 루프
Copilot CLI가 사용자 메시지를 엔드투엔드로 처리하는 방식: 프롬프트부터 session.idle까지.
사용자 정의 에이전트 및 하위 에이전트 오케스트레이션
범위가 지정된 도구 및 프롬프트를 사용하여 특수 에이전트를 정의한 다음, Copilot 단일 세션 내에서 하위 에이전트로 오케스트레이션하도록 합니다.
후크를 사용한 작업
후크를 사용하면 시작되는 순간부터 각 사용자 프롬프트와 도구 호출을 거쳐 종료되는 순간까지 Copilot 세션의 모든 단계에 사용자 지정 논리를 연결할 수 있습니다. 이 가이드에서는 핵심 에이전트 동작을 수정하지 않고 사용 권한, 감사, 알림 등을 제공할 수 있도록 실제 사용 사례를 안내합니다.
이미지 입력
Copilot 세션에 이미지를 첨부 파일로 보냅니다. 이미지를 연결하는 방법에는 두 가지가 있습니다.
Using MCP servers with the GitHub Copilot SDK
The Copilot SDK can integrate with MCP servers (Model Context Protocol) to extend the assistant's capabilities with external tools. MCP servers run as separate processes and expose tools (functions) that Copilot can invoke during conversations.
원격 세션
원격 세션을 사용하면 사용자가 사용 제어 통해 GitHub 웹 및 모바일에서 Copilot 세션에 액세스할 수 있습니다. 사용하도록 설정하면 SDK는 각 세션을 Mission Control에 연결하여 링크 또는 QR 코드로 공유할 수 있는 URL을 생성합니다.
세션 다시 시작 및 지속성
이 가이드에서는 SDK의 세션 지속성 기능(작업을 일시 중지하고, 나중에 다시 시작하고, 프로덕션 환경에서 세션을 관리하는 방법)을 안내합니다.
사용자 지정 기술
스킬은 Copilot의 기능을 확장하는 재사용 가능한 프롬프트 모듈입니다. 디렉터리에서 기술을 로드하여 특정 도메인 또는 워크플로에 대해 Copilot 특수한 기능을 제공합니다.
조향 및 대기열 관리
에이전트가 이미 작업 중인 동안에도 사용자가 메시지를 보낼 수 있게 하는 두 가지 상호작용 패턴이 있습니다. 방향 조정은 현재 턴 도중 에이전트의 진행 방향을 바꾸고, 대기열 처리는 현재 턴이 완료된 후 순차적으로 처리할 수 있도록 메시지를 버퍼링합니다.
스트리밍 세션 이벤트
Copilot 에이전트 수행하는 모든 작업(생각, 코드 작성, 실행 도구)은 구독할 수 있는 session 이벤트로 내보내집니다. 이 가이드는 각 이벤트 유형에 대한 필드 수준 참조이므로 SDK 원본을 읽지 않고도 예상되는 데이터를 정확하게 알 수 있습니다.