Koog

Koog 是由 JetBrains 开发的 AI Agent 框架，以 Kotlin 为核心语言（占比 97.1%），基于 Kotlin Multiplatform 支持跨平台部署（JVM、JS、WasmJS、iOS，Android 待确认）。框架提供四种 Agent 类型——Basic、Functional、Graph-based 和 Planner，覆盖从简单对话到复杂多步骤规划的全场景需求。

可靠性与容错

• 内置重试机制与 Agent 持久化能力，支持在执行任意点保存和恢复状态
• 智能历史压缩技术在保持上下文完整性的同时优化 token 消耗
• 内置 LLM 内容审核能力

工作流与策略

• Agent 行为由有向图（Strategy Graph）驱动，支持子图嵌套、并行节点执行和节点间数据传递
• Planner 类型支持 GOAP（Goal-Oriented Action Planning）和 LLM-based 策略
• 模块化特性系统通过 Feature 组合模式灵活扩展 Agent 能力（History Compression、Chat Memory、Long-term Memory、Agent Persistence、Tracing 等）

协议与互操作

• 集成 MCP（Model Context Protocol）、ACP（Agent Client Protocol，实现范围待确认）和 A2A（Agent-to-Agent）三大协议
• 支持 7 家 LLM 提供商：Google、OpenAI、Anthropic、DeepSeek、OpenRouter、Ollama、Amazon Bedrock（含 Vertex AI），切换时不丢失对话历史
• 知识检索层面提供向量嵌入、RAG、共享记忆和长期记忆能力

框架集成与可观测性

• 原生集成 Spring Boot（koog-spring-boot-starter）和 Ktor（koog-ktor），可复用 Spring AI 的 VectorStore 与 ChatMemoryRepository
• 内置 OpenTelemetry 导出器，支持 W&B Weave、Langfuse、DataDog
• 流式 API、JSON Schema 结构化输出、Amazon Bedrock 提示缓存

模块结构 核心模块包括 agents（Agent 实现）、prompt（Prompt 与 LLM 客户端）、tools（工具注册与执行）、rag、embeddings、a2a、http-client（已从 Ktor 解耦）、serialization（库无关序列化 API）等。

快速开始 环境要求：JDK 17+、Kotlin 2.3.10+，核心依赖 kotlinx-coroutines 1.10.2、kotlinx-serialization 1.10.0、kotlinx-datetime 0.7.1。

dependencies {
    implementation("ai.koog:koog-agents:0.7.3")
}

fun main() = runBlocking {
    val apiKey = System.getenv("OPENAI_API_KEY")
    val agent = AIAgent(
        promptExecutor = simpleOpenAIExecutor(apiKey),
        systemPrompt = "You are a helpful assistant. Answer user questions concisely.",
        llmModel = OpenAIModels.Chat.GPT4o
    )
    val result = agent.run("Hello! How can you help me?")
    println(result)
}

当前项目处于 Beta 阶段，最新版本 0.8.0（2026-04-10），README 引用的稳定依赖为 0.7.3。使用 Apache-2.0 许可证。待确认信息：项目初始发布日期、Slack 频道链接、ACP 实现范围、Android 及 iOS 目标实际可用性。