Koog 框架深度入门：JetBrains 原生 Kotlin AI Agent 如何落地 KMP 全栈

本文基于 JetBrains 官方 Koog 框架与 Kotlin Multiplatform（KMP）生产实践，从设计哲学、核心架构、跨端代码复用、实战样例四个维度，拆解 AI Agent 在 KMP 全栈中的落地路径。适合 Android/Kotlin 开发者向全栈智能体架构师进阶。一、为什么需要 Koog：JVM 原生 Agent 的“最后一公里”现有 Python 系 Agent 框架（LangChain 等）在 JVM 生态中常面临类型安全缺失、协程模型不匹配、跨语言部署复杂的痛点。JetBrains 基于内部 AI Assistant 经验开源Koog，定位为“地道、类型安全、可预测且企业就绪”的 Kotlin 原生框架，让开发者用协程、DSL 直接构建生产级 Agent。关键差异：Koog 底层基于Kotlin Multiplatform，同一套 Agent 逻辑可编译至 JVM、JS/Wasm、Android、iOS，实现“一次编写，多端运行”。二、核心架构与 KMP 全栈契合点Koog 抽象分为五层：应用层（Basic/Functional/Graph/Planner Agent）→ 核心组件（Prompt/Strategy/Tools/Features）→ LLM 抽象层（OpenAI/Anthropic/Ollama/MCP）→ 模型提供商 →JVM Runtime（Kotlin/Java/Spring Boot/Ktor）。协程为核心：Agent 执行、工具调用、流式响应均为suspend或Flow，可无缝嵌入 Ktor 路由或ViewModelScope。强类型 To