앱 안에 코파일럿의 자율 실행 엔진을 심는 방법
자신이 만든 서비스나 앱 안에서 코파일럿이 스스로 계획을 세우고 도구를 호출하며 파일을 수정하게 할 수 있습니다. 이는 코파일럿 CLI 뒤에 숨겨진 동일한 엔진을 프로그램으로 직접 부를 수 있게 해주는 인터페이스입니다. 복잡한 작업 흐름을 직접 짜지 않아도, 에이전트의 행동만 정의하면 나머지 실행 과정은 코파일럿이 처리합니다.
깃허브에서 마이크로소프트로 넘어가는 중
이 저장소는 곧 마이크로소프트 조직으로 이동하며 이름도 '마이크로소프트 코파일럿 SDK'로 바뀝니다. 이는 마이크로소프트와 깃허브 제품 전반에서 공유되는 에이전트 기반의 공통 토대를 위한 단계적 전환입니다. 기존 패키지 이름이나 네임스페이스, 일부 문서에는 여전히 '깃허브 코파일럿 SDK'라는 표기가 남아 있을 수 있습니다. 현재 사용자에게는 즉각적인 변경 사항이 없으며 지원 범위도 그대로 유지됩니다.
여섯 가지 언어로 쓰는 동일한 엔진
파이썬, 타입스크립트, 고, 닷넷, 자바, 러스트 환경에서 모두 동일한 코파일럿 엔진을 호출할 수 있습니다. 각 언어별 SDK는 코파일럿 CLI 서버와 JSON-RPC 프로토콜로 통신하며, SDK가 CLI 프로세스의 생명주기를 자동으로 관리합니다. 외부 CLI 서버에 연결하는 것도 가능합니다. 이 구조 덕분에 특정 언어에 종속되지 않고 동일한 에이전트 워크플로우를 다양한 애플리케이션에 적용할 수 있습니다.
사용을 시작하기 전 확인해야 할 것들
SDK를 사용하려면 깃허브 코파일럿 구독이 필요합니다. 다만 BYOK(Bring Your Own Key) 방식을 쓰면 깃허브 인증 없이 자체 API 키로 모델을 호출할 수 있습니다. 노드.js, 파이썬, 닷넷 SDK는 CLI를 자동으로 번들링하지만, 고, 자바, 러스트 SDK는 CLI를 별도로 설치하거나 PATH에 포함시켜야 합니다. 인증 방식으로는 깃허브 로그인, OAuth 앱, 환경 변수, BYOK를 지원합니다. BYOK는 키 기반 인증만 지원하며 엔트라 ID나 관리된 ID는 지원하지 않습니다.
도구 제어와 커스텀 확장
기본적으로 코파일럿 CLI의 1차 도구가 활성화되며, 각 SDK의 권한 핸들러를 통해 도구 호출을 승인하거나 거부할 수 있습니다. 특정 도구의 사용 가능 여부를 설정으로 조절할 수도 있습니다. 또한 자체 로직을 구현해 커스텀 에이전트, 스킬, 도구를 정의하고 확장할 수 있습니다. 이는 에이전트의 기능을 애플리케이션의 요구사항에 맞게 구체화하는 데 유용합니다.
적용 전 점검 사항
이 SDK는 일반 가용(GA) 상태이며 시맨틱 버전 관리를 따릅니다. 특정 언어별 SDK의 문서에서 설치 명령과 API 참조를 확인해야 하며, 특히 자바의 경우 Maven 좌표(com.github:copilot-sdk-java)를 사용해 의존성을 추가합니다. BYOK를 사용할 경우 지원되는 LLM 제공자(OpenAI, Microsoft Foundry, Anthropic 등)의 키를 설정해야 합니다. 공식적으로 지원하지 않는 커뮤니티 SDK(Clojure, C++)는 사용 시 위험을 감수해야 합니다. 라이선스는 MIT입니다.
