Koog

构建状态：

相关链接：

• 文档
• API 参考
• Slack 频道
• 问题追踪

概述

Koog 是一个基于 Kotlin 的框架，旨在通过符合 Kotlin 和 Java 习惯的 API 构建并运行 AI Agent。它支持创建能够与工具交互、处理复杂工作流以及与用户进行沟通的 Agent。

核心特性

Koog 的主要功能包括：

• 多平台开发：利用 Kotlin Multiplatform 将 Agent 部署到 JVM、JS、WasmJS、Android 和 iOS 等目标平台。
• 可靠性与容错性：通过内置的重试机制处理故障，并借助 Agent 持久化功能在执行过程中的特定节点恢复 Agent 状态。
• 智能历史压缩：利用先进的内置历史压缩技术，在长会话中优化 Token 使用的同时保持上下文关联。
• 企业级集成：利用与 Spring Boot 和 Ktor 等主流 JVM 框架的集成，将 Koog 嵌入到您的应用程序中。
• OpenTelemetry 可观测性导出：通过对流行可观测性平台（W&B Weave, Langfuse）的内置支持，监控并调试应用程序。
• LLM 切换与无缝历史适配：可在任何时刻切换到不同的 LLM，且无需丢失现有的对话历史，或在多个 LLM 提供商之间进行路由重定向。
• 与 JVM 和 Kotlin 应用集成：使用专为 JVM 和 Kotlin 开发者设计的、类型安全的 Kotlin DSL 构建 AI Agent。
• Model Context Protocol (MCP) 集成：在 AI Agent 中使用 MCP 工具。
• Agent Client Protocol (ACP) 集成：构建兼容 ACP 的 Agent，通过 ACP 与标准化客户端应用程序进行通信。
• 知识检索与记忆：通过向量嵌入（Vector Embeddings）、RAG 和共享 Agent 记忆，跨会话保留并检索知识。
• 强大的 Streaming API：通过流式处理支持和平行工具调用，实现实时响应。
• 模块化特性系统：通过可组合的架构自定义 Agent 能力。
• 灵活的图形工作流：使用直观的图形化工作流设计复杂的 Agent 行为。
• 自定义工具创建：通过访问外部系统和 API 的工具来增强您的 Agent。
• 全面追踪：通过详细且可配置的追踪功能，调试并监控 Agent 的执行过程。

可用的 LLM 提供商与平台

您可以选择以下提供商的 LLM 来驱动您的 Agent：

• Google
• OpenAI
• Anthropic
• DeepSeek
• OpenRouter
• Ollama
• Bedrock

快速入门示例

为了帮助您快速上手 AI Agent，这里提供一个简单的示例：

fun main() = runBlocking {
    // 运行示例前，请将相应的 API Key 设置为环境变量。
   val apiKey = System.getenv("OPENAI_API_KEY") // 或 Anthropic, Google, OpenRouter 等。

   val agent = AIAgent(
      promptExecutor = simpleOpenAIExecutor(apiKey), // 或 Anthropic, Google, OpenRouter 等。
      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)
}

在项目中使用

支持的目标平台

目前，该框架支持 JVM、JS、WasmJS 和 iOS 目标平台。

系统要求

• 在 JVM 上使用该框架需要 JDK 17 或更高版本。
• 在现有项目中应显式设置 Kotlin 2.3.10 或更高版本。请查看 li 获取更多信息。