Kimi 模型

agentscope-extensions-model-openai 通过 OpenAI 兼容模型栈提供 Kimi（月之暗面 / Moonshot AI）的一等支持。引入 OpenAI 模型扩展模块后，可以通过 ModelRegistry 使用 kimi:<model>。

添加依赖

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-extensions-model-openai</artifactId>
    <version>${agentscope.version}</version>
</dependency>

ModelRegistry

设置 MOONSHOT_API_KEY 或 KIMI_API_KEY 后，使用 kimi:<model> 字符串 id：

ReActAgent agent = ReActAgent.builder()
    .name("assistant")
    .model("kimi:kimi-k3") // 底层由 ModelRegistry.resolve(modelId) 解析
    .build();

Provider 默认使用 https://api.moonshot.cn/v1 ，发送请求前会去掉 kimi: 前缀，并使用 io.agentscope.extensions.model.openai.compat.kimi 下的 Kimi formatter。

思考模式

通过 ModelCreationContext 解析模型时，可以用 GenerateOptions 传入 Kimi 思考相关参数：

import io.agentscope.core.model.GenerateOptions;
import io.agentscope.core.model.Model;
import io.agentscope.core.model.ModelCreationContext;
import io.agentscope.core.model.ModelRegistry;
import java.util.Map;

Model model = ModelRegistry.resolve(
    "kimi:kimi-k2.6",
    ModelCreationContext.builder()
        .component(
            GenerateOptions.class,
            GenerateOptions.builder()
                .additionalBodyParam("thinking", Map.of("type", "disabled"))
                .maxCompletionTokens(16000)
                .build())
        .build());

kimi-k3 使用顶层 reasoning_effort 选项（low、high 或 max）。kimi-k3 和 kimi-k2.7-code 始终开启思考模式；kimi-k2.6 和 kimi-k2.5 默认开启思考模式，但可以通过 additionalBodyParam("thinking", Map.of("type", "disabled")) 关闭。

兼容性说明

Kimi formatter 会把 OpenAI 风格请求适配为 Kimi chat-completions API 支持的格式。它会省略工具 schema 的 strict 字段，保留历史 assistant 消息中的 reasoning_content，并移除 thinking_budget 等不支持的请求字段。

在 kimi-* 模型上，temperature、top_p、n、frequency_penalty、presence_penalty 等采样参数由平台固定，formatter 会从请求中移除这些字段。moonshot-v1 系列仍会保留这些参数。Kimi 文档使用 max_completion_tokens，因此当只设置了 max_tokens 且没有设置 max_completion_tokens 时，会自动映射到 max_completion_tokens。

reasoning_effort 只会在 kimi-k3 上保留。K2.x 的思考控制参数需要通过 GenerateOptions.additionalBodyParam 传入 thinking body 参数。

tool_choice=auto 和 tool_choice=none 通常可以直接使用。K2.x 模型不支持 tool_choice=required，formatter 会将其降级为 auto。tool_choice 指定函数调用时与开启思考模式不兼容，因此在 kimi-k3、kimi-k2.7-code，以及未显式设置 thinking.type=disabled 的 kimi-k2.6 / kimi-k2.5 上会降级为 auto。

结构化输出默认使用 AgentScope 的 fallback 行为。

使用兼容端点或自托管端点时，可以通过 ModelCreationContext 传入 baseUrl、endpointPath、生成参数或 formatter 覆盖。