블로그 | 모하지?

원문: Koog Documentation — why-koog 이 글은 Koog 공식 문서의 why-koog 페이지를 한국어로 옮긴 번역본입니다. 문서 구조와 링크 의미를 유지하되, MkDocs 전용 UI 문법은 블로그에서 읽기 좋도록 정리했습니다.

왜 쿠그인가?

Koog는 JetBrains 수준의 품질로 실제 문제를 해결하도록 설계되었습니다. 고급 AI 알고리즘, 즉시 사용 가능한 입증된 기술, Kotlin DSL, Java 유창한 API 및 강력한 다중 플랫폼을 제공합니다. 기존 프레임워크를 뛰어넘는 지원을 제공합니다.

주요 초점은 신뢰성입니다. 즉, 까다로운 기업 환경에서 자신있게 사용할 수 있는 AI 에이전트를 지원하는 것입니다.

Java 및 Kotlin 애플리케이션과 통합

Koog는 Java 사용자를 위한 원활한 Java API와 함께 Kotlin 개발자를 위해 특별히 설계된 Kotlin 도메인 특정 언어(DSL)를 제공합니다. 동일한 프레임워크가 두 JVM 언어 모두에서 기본 느낌을 제공하여 Kotlin 및 Java 애플리케이션과의 원활한 통합을 보장합니다. 생산성을 크게 높이고 전반적인 개발자 경험을 향상시킵니다.

JetBrains 제품을 통한 실제 검증

Koog는 내부 AI 에이전트를 포함한 여러 JetBrains 제품을 지원합니다. 이러한 실제 통합을 통해 Koog는 실제 사용 사례에 대해 지속적으로 테스트, 개선 및 검증됩니다. 광범위한 피드백과 실제 제품 시나리오에서 얻은 통찰력을 통합하여 실제로 작동하는 것에 중점을 둡니다. 이러한 통합은 Koog에 다른 프레임워크와 구별되는 강점을 제공합니다.

즉시 사용 가능한 고급 솔루션

Koog에는 기본 구성 요소만 제공하는 프레임워크와 차별화하여 에이전트 시스템 개발을 단순화하고 속도를 높이는 사전 구축된 구성 가능한 솔루션이 포함되어 있습니다.

도메인 모델링을 사용한 그래프 워크플로. 검증된 도메인 모델을 기반으로 구축된 명시적 그래프로 AI 워크플로를 모델링합니다. 단순한 프롬프트에 의존하는 대신 요구사항을 구조화된 데이터 클래스로 표현함으로써 상담원 행동을 정밀하게 제어할 수 있으며 안정성과 예측 가능성이 크게 향상됩니다.
다양한 기록 압축 전략. Koog는 장기간 실행되는 대화를 즉시 압축하고 관리할 수 있는 고급 전략을 제공하므로 접근 방식을 수동으로 실험할 필요가 없습니다. ML 엔지니어가 테스트하고 개선한 세부 조정된 프롬프트, 기법, 알고리즘을 통해 입증된 방법을 활용하여 성능을 향상할 수 있습니다. 압축 전략에 대한 자세한 내용은 History compression을 참조하세요. Koog가 실제 시나리오에서 압축 및 컨텍스트 관리를 처리하는 방법을 알아보려면 this article을 확인하세요.
고급 지속성(지속 가능한 실행). Koog를 사용하면 채팅 메시지 대신 전체 에이전트 상태 시스템을 복원할 수 있습니다. 이를 통해 체크포인트, 오류 복구, 심지어 상태 시스템 실행 중 어느 시점으로든 되돌릴 수 있는 기능과 같은 기능이 가능해집니다.
모든 최신 에이전트 패턴, 단일 프레임워크. 그래프 워크플로, GOAP(목표 지향 행동 계획) 및 LLM 계획, 다중 에이전트 오케스트레이션 - 완벽하게 지원되고 완벽하게 구성 가능합니다. 사용 사례에 필요한 에이전트를 정확하게 구축하세요.
원활한 LLM 전환. 기존 대화 기록을 잃지 않고 언제든지 새로운 사용 가능한 도구 세트를 사용하여 대화를 다른 LLM(대형 언어 모델)로 전환할 수 있습니다. Koog는 기록을 자동으로 다시 작성하고 사용할 수 없는 도구를 처리하여 원활한 전환과 자연스러운 상호 작용 흐름을 가능하게 합니다.
강력한 재시도 구성 요소. Koog에는 에이전트 시스템 내에서 작업 세트를 래핑하고 구성 가능한 조건을 충족할 때까지 재시도할 수 있는 재시도 메커니즘이 포함되어 있습니다. 신뢰할 수 있는 결과를 보장하기 위해 피드백을 제공하고 각 시도를 조정할 수 있습니다. LLM 호출 시간이 초과되거나 도구가 예상대로 작동하지 않거나 네트워크 문제가 있는 경우 Koog는 일시적인 오류가 발생하는 동안에도 에이전트가 복원력을 유지하고 효과적으로 작동하도록 보장합니다. 자세한 기술 정보는 Retry functionality을 참조하세요.

광범위한 통합, 다중 플랫폼 지원, 향상된 관측 가능성

Koog는 다양한 플랫폼과 환경에서 에이전트 애플리케이션의 개발 및 배포를 지원합니다.

Spring Boot, Spring AI 및 Ktor 통합. Koog는 널리 사용되는 기업 환경과 통합됩니다.
- Spring Boot의 경우 Koog는 즉시 사용 가능한 Bean과 자동 구성 LLM 클라이언트를 제공하여 AI 기반 워크플로 구축을 쉽게 시작할 수 있습니다.
- 이미 LLM 및 RAG 기능을 위해 Spring AI를 사용하고 있다면 Koog를 오케스트레이션 및 에이전트 프레임워크로 계층화할 수 있습니다. 이를 통해 Koog의 안정적이고 비용 효율적인 고급 AI 워크플로우의 이점을 활용하는 동시에 Spring AI의 광범위한 통합을 활용할 수 있습니다.
- Ktor 서버가 있는 경우 Koog를 플러그인으로 설치하고, 구성 파일을 사용하여 공급자를 구성하고, LLM 클라이언트를 수동으로 연결하지 않고도 모든 경로에서 직접 에이전트를 호출할 수 있습니다.
다중 플랫폼 지원. JVM, JS, WasmJS, Android 및 iOS 대상 전체에 에이전트 애플리케이션을 배포할 수 있습니다.
광범위한 AI 통합. Koog는 OpenAI, Anthropic, Google, DeepSeek, Mistral, Alibaba 및 Bedrock과 같은 엔터프라이즈급 AI 클라우드를 포함한 주요 LLM 제공업체와 통합됩니다. Ollama와 같은 로컬 모델도 지원합니다. 사용 가능한 공급자의 전체 목록은 LLM providers을 참조하세요.
OpenTelemetry 지원. Koog는 AI 애플리케이션 모니터링 및 디버깅을 위해 W&B Weave, Langfuse 및 DataDog와 같은 널리 사용되는 관찰 제공자와 즉시 통합을 제공합니다. 기본 OpenTelemetry 지원을 통해 시스템에서 이미 사용하고 있는 것과 동일한 도구를 사용하여 에이전트를 추적, 기록 및 측정할 수 있습니다. 자세한 내용은 OpenTelemetry을 참조하세요.

ML 엔지니어 및 제품팀과의 협업

Koog의 독특한 장점은 JetBrains ML 엔지니어 및 제품 팀과의 직접적인 협업입니다. 이를 통해 Koog로 구축된 기능은 단지 이론적인 것이 아니라 실제 제품 요구 사항에 따라 테스트되고 개선됩니다. 이는 Koog가 다음을 통합한다는 것을 의미합니다.

세밀하게 조정된 프롬프트와 전략은 실제 성능에 최적화되었습니다.
검증된 엔지니어링 접근 방식은 고유한 기록 압축 전략과 같은 제품 개발을 통해 발견되고 검증되었습니다. this detailed article에서 자세한 내용을 확인할 수 있습니다.
Koog가 효율성을 유지하고 변화하는 요구 사항에 적응할 수 있도록 돕는 지속적인 개선.

개발자 커뮤니티에 대한 헌신

Koog 팀은 강력한 개발자 커뮤니티를 구축하기 위해 최선을 다하고 있습니다. 피드백을 적극적으로 수집하고 반영함으로써 Koog는 개발자의 요구를 효과적으로 충족할 수 있도록 발전합니다. 다양한 AI 아키텍처, 종합 벤치마크, 상세한 사용 사례 가이드에 대한 지원을 적극적으로 확대하고 있습니다. 개발자의 역량을 강화하는 교육 리소스입니다.

어디서부터 시작해야 할까요?

Overview에서 Koog 기능을 살펴보세요.
Quickstart 가이드를 통해 첫 번째 Koog 에이전트를 구축하세요.
Koog release notes에서 최신 업데이트를 확인하세요.
Examples에서 알아보세요.