이벤트 핸들러

로깅, 테스트, 디버깅 및 에이전트 동작 확장용으로 이벤트 핸들러를 사용하여 에이전트 워크플로 중에 특정 이벤트를 모니터링하고 대응할 수 있습니다.

기능 개요

EventHandler 기능은 다양한 에이전트 이벤트에 훅을 걸 수 있게 해줍니다. 이는 다음과 같은 이벤트 위임 메커니즘으로 작동합니다.

• AI 에이전트 작업의 수명 주기를 관리합니다.
• 워크플로의 다양한 단계를 모니터링하고 대응하기 위한 훅을 제공합니다.
• 오류 처리 및 복구를 가능하게 합니다.
• 도구 호출 추적 및 결과 처리를 용이하게 합니다.

설치 및 구성

EventHandler 기능은 에이전트 워크플로와 EventHandler 클래스를 통해 통합되며, 다양한 에이전트 이벤트에 대한 콜백을 등록하는 방법을 제공하고 에이전트 구성에 기능으로 설치될 수 있습니다. 자세한 내용은 API 참조를 참조하세요.

이 기능을 설치하고 에이전트에 대한 이벤트 핸들러를 구성하려면 다음을 수행하세요:

handleEvents {
    // 도구 호출 처리
    onToolCallStarting { eventContext ->
        println("Tool called: ${eventContext.tool.name} with args ${eventContext.toolArgs}")
    }
    // 에이전트 실행 완료 시 트리거되는 이벤트 처리
    onAgentCompleted { eventContext ->
        println("Agent finished with result: ${eventContext.result}")
    }

    // 다른 이벤트 핸들러
}

이벤트 핸들러 구성에 대한 자세한 내용은 API 참조를 참조하세요.

에이전트를 생성할 때 handleEvents 확장 함수를 사용하여 이벤트 핸들러를 설정할 수도 있습니다. 이 함수는 이벤트 핸들러 기능을 설치하고 에이전트에 대한 이벤트 핸들러를 구성합니다. 다음은 예시입니다:

val agent = AIAgent(
    promptExecutor = simpleOllamaAIExecutor(),
    llmModel = OllamaModels.Meta.LLAMA_3_2,
){
    handleEvents {
        // 도구 호출 처리
        onToolCallStarting { eventContext ->
            println("Tool called: ${eventContext.tool.name} with args ${eventContext.toolArgs}")
        }
        // 에이전트 실행 완료 시 트리거되는 이벤트 처리
        onAgentCompleted { eventContext ->
            println("Agent finished with result: ${eventContext.result}")
        }

        // 다른 이벤트 핸들러
    }
}