Koog 大模型访问抽象机制解析

Koog 作为 Kotlin 生态的 AI Agent 开发框架，通过三层标准化抽象，彻底屏蔽了不同大模型厂商的接口差异，实现了 Prompt 定义、LLM 客户端管理、模型调用全流程的统一封装，让开发者无需为不同厂商的 API 单独编写适配代码。

📝 第一层：Prompt 结构化抽象

Koog 没有直接使用裸字符串传递 Prompt，而是将其封装为强类型的 Prompt 数据类，从根源上统一了所有大模型的输入格式：

核心属性‌：包含唯一标识 id、对话消息列表 messages、可选模型参数 params（temperature、工具选择等），天然兼容所有主流大模型的多轮对话结构。

Kotlin DSL 定义‌：提供声明式的结构化 Prompt 构建方式，替代零散的字符串拼接，代码可读性和可维护性大幅提升：

kotlin

val myPrompt = prompt("hello-koog") {

    system("You are a helpful assistant.")

    user("What is Koog?")

}

自动转换兼容‌：AI Agent 可直接接收纯文本 Prompt，框架内部自动将其转换为标准 Prompt 对象，兼顾简单场景的易用性和复杂场景的结构化能力。

🤖 第二层：LLM Client 统一抽象

Koog 定义了标准化的 LLMClient 接口，抹平了 OpenAI、Anthropic、通义千问等不同厂商的 API 签名差异，所有模型客户端都遵循同一套调用契约：

接口归一化‌：不同厂商的 SDK 差异被完全封装在实现层，上层业务代码无需感知具体模型的请求构造逻辑。

Spring AI 无缝桥接‌：提供官方集成桥接包，直接复用 Spring AI 生态中已有的 ChatModel、向量存储、对话记忆组件，零成本将现有 Spring AI 项目迁移到 Koog 架构下，无需替换原有依赖。

⚙️ 第三层：Prompt Executor 生命周期抽象

Prompt 执行器是 Koog 最核心的大模型访问抽象层，它接管了 LLM 客户端的全生命周期管理，提供多模型路由、故障自动降级等高阶能力：

表格

执行器类型 核心能力 适用场景

SingleLLMPromptExecutor‌ 封装单个厂商的 LLM 客户端，支持同厂商内不同模型切换 仅使用单一厂商模型的简单 Agent 业务

MultiLLMPromptExecutor‌ 同时封装多厂商 LLM 客户端，支持跨厂商动态路由，主模型不可用时自动切换到备用降级模型 需要多模型容灾、跨厂商负载均衡的生产级业务

所有执行器都实现统一的 PromptExecutor 接口，上层业务代码完全不需要感知底层用的是哪一家大模型，切换模型、新增厂商只需要修改配置，无需改动核心业务逻辑。

这套三层抽象机制，让 Koog 实现了“一次编写，全模型运行”的开发体验，彻底解决了大模型应用开发中多厂商适配繁琐、代码耦合度高的痛点。

需要我为你提供一份Koog大模型抽象层的‌最简集成代码示例‌吗？帮你快速上手多模型统一调用。