예

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

예

Koog 프레임워크는 다양한 사용 사례에 맞게 AI 에이전트를 구현하는 방법을 이해하는 데 도움이 되는 예제를 제공합니다. 이러한 예는 자신의 애플리케이션에 맞게 조정할 수 있는 주요 기능과 패턴을 보여줍니다.

아래 예제를 찾아보고 링크를 클릭하면 GitHub에서 소스 코드를 볼 수 있습니다.

예	설명
Attachments	프롬프트에서 구조화된 마크다운과 첨부 파일을 사용하는 방법을 알아보세요. OpenAI 모델을 사용하여 이미지를 포함하는 프롬프트를 구축하고 Instagram 게시물을 위한 창의적인 콘텐츠를 생성하세요.
Banking	정교한 그래프 기반 전략을 통해 송금 및 거래 분석을 처리할 수 있는 라우팅 기능을 갖춘 포괄적인 AI 뱅킹 도우미를 구축하세요. 도메인 모델링, 도구 생성, 에이전트 구성 패턴이 포함됩니다.
BedrockAgent	AWS Bedrock 통합과 함께 Koog 프레임워크를 사용하여 지능형 AI 에이전트를 생성합니다. 사용자 지정 도구를 정의하고, AWS Bedrock을 설정하고, 장치 제어를 위한 자연어 명령을 이해하는 대화형 에이전트를 구축하는 방법을 알아보세요.
Calculator	덧셈, 뺄셈, 곱셈, 나눗셈 도구를 사용하여 산술 연산을 수행하는 계산기 에이전트를 빌드합니다. 병렬 도구 호출, 이벤트 로깅 및 다중 실행기 지원(OpenAI 및 Ollama)을 보여줍니다.
Chess	복잡한 도메인 모델링, 사용자 정의 도구, 메모리 최적화 기술 및 대화형 선택 선택 기능을 갖춘 지능형 체스 게임 에이전트를 구축하세요. 고급 에이전트 전략, 게임 상태 관리, 인간-AI ​​협업 패턴을 보여줍니다.
GoogleMapsMcp	Docker를 통해 Koog를 Google 지도 MCP 서버에 연결합니다. Kotlin Notebook 환경에서 실제 지리 API가 포함된 AI 에이전트를 사용하여 도구를 검색하고, 주소를 지오코딩하고, 고도 데이터를 가져옵니다.
Guesser	타겟 질문을 하는 도구를 사용하여 이진 검색 전략을 구현하는 숫자 추측 에이전트를 구축합니다. 에이전트는 전략적 질문을 통해 효율적으로 사용자 수를 좁히고 도구 기반 상호 작용 패턴을 보여줍니다.
Langfuse	OpenTelemetry를 사용하여 Koog 에이전트 추적을 Langfuse로 내보내는 방법을 알아보세요. 포괄적인 관찰 가능성을 위해 환경 변수를 설정하고, 에이전트를 실행하고, Langfuse 인스턴스에서 범위 및 추적을 검사합니다.
MCP	지리 데이터용 GoogleMapsMcpClient와 브라우저 자동화용 PlaywrightMcpClient를 갖춘 모델 컨텍스트 프로토콜의 통합 예입니다.
Memory	메모리 시스템 사용법을 보여주는 고객 지원 에이전트입니다. 에이전트는 암호화된 로컬 저장소와 주제 및 범위가 포함된 적절한 메모리 구성을 사용하여 사용자 대화 기본 설정, 장치 진단 및 조직별 정보를 추적합니다.
OpenTelemetry	Koog AI 에이전트에 OpenTelemetry 기반 추적을 추가합니다. 디버깅을 위해 콘솔에 범위를 내보내고 Jaeger에서 볼 수 있도록 OpenTelemetry Collector로 추적을 내보내는 방법을 알아봅니다. Docker 설정 및 문제 해결 가이드가 포함되어 있습니다.
Planner	병렬 및 순차 실행 노드로 실행 트리를 구축하고 복잡한 워크플로에 대한 실행 계획을 동적으로 구성하는 작업 계획 시스템입니다.
PlaywrightMcp	Playwright MCP 및 Koog를 사용하여 브라우저를 구동하세요. Playwright MCP 서버를 실행하고, SSE를 통해 연결하고, AI 에이전트가 자연어 명령을 통해 탐색, 쿠키 수락, UI 상호 작용과 같은 웹 작업을 자동화하도록 하세요.
SimpleAPI	Koog를 시작하기 위한 간단한 API 패턴이 포함된 채팅 에이전트와 기본 에이전트를 보여주는 예입니다.
StructuredData	에이전트 응답에서 입력된 데이터로 작업하는 방법을 보여주는 복잡한 중첩 클래스, 다형성 및 일기 예보 예제를 통해 JSON 기반의 구조화된 데이터 출력을 보여줍니다.
SubgraphWithTask	하위 그래프 전략을 사용한 생성, 삭제, 명령 실행을 포함한 파일 및 디렉터리 작업을 보여주는 프로젝트 생성 도구입니다.
Tone	특수 도구를 사용하여 입력 텍스트의 긍정적, 부정적 또는 중립적 어조를 식별하고 감정 분석 기능을 보여주는 텍스트 어조 분석 에이전트입니다.
UnityMcp	Unity MCP 서버 통합을 사용하여 AI 에이전트로 Unity 게임 개발을 추진하세요. stdio를 통해 Unity에 연결하고, 사용 가능한 도구를 검색하고, 에이전트가 장면을 수정하고, 개체를 배치하고, 자연어 명령을 통해 게임 개발 작업을 실행할 수 있도록 하세요.
VaccumAgent	Koog 프레임워크를 사용하여 기본 반사 에이전트 구현. 단순한 2셀 세계에서 자동화된 청소 작업을 위한 환경 모델링, 도구 생성 및 에이전트 동작을 다룹니다.
Weave	OpenTelemetry(OTLP)를 사용하여 Koog 에이전트를 W&B Weave로 추적하는 방법을 알아보세요. 포괄적인 모니터링 및 디버깅을 위해 Weave UI에서 환경 변수를 설정하고, 에이전트를 실행하고, 풍부한 추적을 확인하세요.
A2A	Koog 프레임워크를 사용한 A2A(에이전트 간) 통신을 보여줍니다. AI 에이전트 간의 양방향 통신을 설정하고, 공동 문제 해결을 지원하고, 적절한 메시지 라우팅 및 조정을 통해 다중 에이전트 워크플로를 관리하는 방법을 보여줍니다.