쿠그(Koog) 0.4.0은 네이티브 구조화 출력 기능과 애플 iOS 플랫폼, GPT-5 모델 지원을 추가했다.
쿠그 0.4.0은 젯브레인의 코틀린 기반 AI 에이전트 개발 프레임워크 최신 업데이트로, 실제 서비스 환경에서도 안정적으로 동작할 수 있도록 설계된 네이티브 구조화 출력 기능을 제공한다. 또한 애플 iOS를 타깃 플랫폼으로 추가하고, GPT-5 모델과 오픈텔레메트리(OpenTelemetry) 지원도 포함됐다.
젯브레인은 8월 28일 발표에서 쿠그 0.4.0의 목적을 “에이전트를 관찰 가능하게 하고, 사용자 스택에 원활하게 배포할 수 있으며, 더 예측 가능한 방식으로 동작하도록 하는 것”이라고 설명했다. 소스 코드는 깃허브에서 확인할 수 있다.
네이티브 구조화 출력은 대형 언어 모델(LLM)이 요구되는 데이터 형식을 정확히 제공하지만 프로세스가 중간에 멈추는 문제를 해결하기 위한 기능이다. 쿠그 0.4.0은 일부 LLM에서 지원하는 경우 이를 직접 사용하고, 지원하지 않을 때는 조정된 프롬프트와 재시도 방식으로 전환해 별도의 모델 기반 파서를 활용한다. 이를 통해 최종 출력이 기대한 형식과 정확히 일치하도록 한다.
iOS 지원 역시 주목할 만하다. 코틀린 멀티플랫폼 전략의 일환으로, 개발자는 한 번 에이전트를 빌드하면 동일한 전략 그래프, 관찰 기능, 테스트를 활용해 iOS, 안드로이드, JVM 백엔드에 배포할 수 있다. 단, iOS 빌드를 위해서는 쿠그 0.4.1 버전이 필요하다.
또한 쿠그 0.4.0은 GPT-5 지원과 맞춤형 LLM 파라미터를 도입해 복잡한 파라미터를 더 정교하게 처리할 수 있게 한다. 예를 들어 reasoningEffort와 같은 설정을 통해 호출마다 품질, 비용, 지연 시간 간 균형을 조정할 수 있다고 젯브레인은 밝혔다. 오픈텔레메트리 지원은 W&B의 위브(Weave) AI 개발 툴킷과 오픈소스 LLM 엔지니어링 플랫폼인 Langfuse와도 연동된다.
개발자는 원하는 플러그인을 에이전트에 설치하고 백엔드에 연결할 수 있으며, 요청별 토큰 사용량과 비용 breakdown, 중첩된 에이전트 이벤트를 확인할 수 있다. LLM 호출 지연, 툴 비정상 동작, 네트워크 불안정 문제를 해결하기 위해 쿠그 0.4.0에는 Conservative, Production, Aggressive 세 가지 프리셋을 제공하는 RetryingLLMClient가 추가됐다. 이와 함께 세밀한 제어 기능과 딥시크 모델 지원도 포함됐다.
dl-ciokorea@foundryco.com
