요약
- 깃허브가 자바 개발자용 GitHub Copilot SDK를 공개했으며 메이븐 의존성(1.0.7-preview.1)으로 배포된다
- BYOK(자체 API 키 사용) 방식을 지원해 오픈AI, 애저, 앤스로픽 등 어떤 모델 제공자와도 연동 가능하다
- 부동산 리드 관리 에이전트 예제 앱이 Jakarta EE 11과 가상 스레드 기반으로 함께 공개됐다
- 발행
- GitHub Blog, 작성자 Edward Burns, 2026-08-10
- SDK 버전
- com.github:copilot-sdk-java 1.0.7-preview.1 (Maven)
- JDK 요구사항
- JDK 17 또는 25 (25 권장, 가상 스레드 활용)
- Copilot CLI 요구 버전
- 1.0.71 이상
- 예제 앱 런타임
- Open Liberty 26.0.0.5 + Jakarta EE 11 (Faces 4.1, CDI 4.1, WebSocket 2.2)
- 핵심 API
- @CopilotTool 애노테이션으로 도구 정의
- 벤더 중립성
- BYOK 지원 시 Copilot 구독 없이도 사용 가능
자바로 짠 코드가 곧 AI 에이전트가 된다
부동산 상담 앱에 "런던에서 8억원 이하 방 3개짜리 집을 찾는다"는 문의가 들어오면, 서버는 가상 스레드 하나를 띄워 독립된 코파일럿 에이전트를 생성한다. 이 에이전트가 매물 데이터베이스를 조회하고 조건에 맞는 집을 골라 응답을 만드는 전 과정이 자바 코드 몇 줄로 끝난다. 깃허브가 지난 8월 10일 공개한 GitHub Copilot SDK for Java의 실제 동작 방식이다.
프레임워크 종속을 끊은 SDK
그동안 엔터프라이즈 자바 개발자가 앱에 AI를 붙이려면 두 갈래 길뿐이었다. Langchain4j — 자바 진영에서 AI 모델 제공자를 추상화해주는 라이브러리 — 를 쓰면 특정 AI 벤더에는 묶이지 않지만 Langchain4j 자체에 의존하게 된다. Spring AI를 쓰면 스프링 프레임워크의 설계 방식을 그대로 따라야 한다.
깃허브는 이번 SDK를 "진정한 의미의 프레임워크 애그노스틱" 도구라고 소개했다. 여기에 BYOK(Bring Your Own Key, 자체 API 키 사용) 방식을 얹어 오픈AI, 애저, 앤스로픽은 물론 오픈AI 호환 엔드포인트까지 자유롭게 연결할 수 있게 했다. 개발자가 자체 baseUrl과 API 키만 넘기면 깃허브 코파일럿 구독 없이도 SDK를 쓸 수 있다는 점이 특징이다.
자바 개발자에게 익숙한 문법 그대로
SDK는 CompletableFuture, 애노테이션, 람다, 가상 스레드 등 자바 개발자가 이미 써온 도구를 그대로 활용한다. 가상 스레드는 자바 21부터 정식 도입된 경량 스레드 모델로, 수천 개의 동시 요청을 적은 시스템 자원으로 처리할 수 있게 해준다. 핵심 API는 @CopilotTool 애노테이션이다. REST API의 @GET 엔드포인트를 작성해본 개발자라면 익숙한 방식으로 AI가 호출할 도구를 정의할 수 있다.
Jakarta EE는 오라클이 이관한 뒤 자바 진영 커뮤니티가 이어가는 엔터프라이즈 표준 플랫폼이다. 깃허브는 이번 예제 애플리케이션을 Jakarta EE 11 기반으로 만들었는데, 특정 프레임워크에 종속되지 않는다는 SDK의 취지를 강조하려는 선택으로 풀이된다.
예제 앱, 부동산 리드 파이프라인
공개된 샘플 애플리케이션은 고객 문의를 받아 자동으로 매물을 매칭하는 부동산 리드 관리 에이전트다. 여러 문의를 동시에 넣으면 각각 독립된 가상 스레드 위에서 별도의 코파일럿 세션이 병렬로 처리되는 모습을 볼 수 있다. Jakarta WebSocket을 통해 서버가 처리 단계를 실시간으로 브라우저에 밀어주기 때문에, 에이전트가 도구를 호출하며 단계를 넘어가는 과정을 화면에서 지켜볼 수 있다.
| 구성 요소 | 사용 기술 |
|---|---|
| 런타임 | Open Liberty 26.0.0.5 |
| 플랫폼 | Jakarta EE 11 (Faces 4.1, CDI 4.1, WebSocket 2.2, Data 1.0, Persistence 3.2) |
| UI | PrimeFaces 15.0.16 |
| AI 오케스트레이션 | Copilot SDK for Java 1.0.7-preview.1 |
| 데이터베이스 | H2 인메모리 (매물 10건 시드) |
실행 요건과 배포 방식
SDK는 메이븐 의존성으로 배포되며, 실행에는 JDK 17 또는 25가 필요하다. 깃허브는 25 버전을 권장하는데, 가상 스레드를 비롯한 최신 기능을 온전히 쓸 수 있어서다. 메이븐 3.9 이상, 활성화된 코파일럿 구독이 있는 깃허브 계정, 그리고 1.0.71 이상 버전의 코파일럿 CLI가 사전 조건으로 요구된다.
| 요구 사항 | 값 |
|---|---|
| SDK 버전 | 1.0.7-preview.1 |
| JDK | 17 또는 25 (25 권장) |
| Maven | 3.9 이상 |
| Copilot CLI | 1.0.71 이상 |
그래서 무엇이 달라지나
지금까지 자바 진영에서 AI를 붙이려면 Langchain4j나 Spring AI처럼 특정 생태계에 발을 담가야 했다. 이번 SDK는 그 전제를 흔든다. 프레임워크와 모델 제공자 양쪽 모두에서 선택지를 넓혀준다는 점이 핵심이다. 엔터프라이즈 자바 코드베이스를 유지하는 기업 입장에서는 기존 CI/CD, 빌드 도구, 배포 파이프라인을 그대로 두고 AI 에이전트 기능만 얹을 수 있는 길이 열린 셈이다. 아직 프리뷰 버전 단계인 만큼 API가 안정화되기 전까지는 프로덕션 도입에 신중할 필요가 있지만, 자바 생태계에 익숙한 개발자라면 별도 학습 곡선 없이 바로 시험해볼 수 있다는 점에서 진입 장벽이 낮다는 점은 분명하다.
댓글