org.noear.solon.ai.llm.dialect.gemini

类 GeminiChatDialect

java.lang.Object

org.noear.solon.ai.chat.dialect.AbstractChatDialect

org.noear.solon.ai.llm.dialect.gemini.GeminiChatDialect

所有已实现的接口:

AiModelDialect, ChatDialect

public class GeminiChatDialect
extends AbstractChatDialect

Gemini 聊天模型方言

此类实现了与 Google Gemini API 的集成，提供聊天补全功能。 主要职责包括：

• 构建符合 Gemini API 规范的请求 JSON
• 处理流式和非流式两种响应模式
• 解析 Gemini 特有的思考内容（thoughts）格式
• 处理配置参数的自动类型转换（YAML 读取的字符串转数值类型）

Gemini API 与 OpenAI API 的主要差异：

• URL 格式：使用 /models/{model}:generateContent 或 :streamGenerateContent
• 认证方式：使用 x-goog-api-key 请求头而非 Bearer Token
• 思考内容：支持将思考过程作为响应的一部分返回

从以下版本开始:

3.1

构造器概要

构造器

构造器和说明
GeminiChatDialect()

方法概要

限定符和类型	方法和说明
org.noear.snack4.ONode	buildAssistantToolCallMessageNode(ChatResponseDefault resp, java.util.Map<java.lang.String,ToolCallBuilder> toolCallBuilders) 构建助理消息节点
java.lang.String	buildRequestJson(ChatConfig config, ChatOptions options, java.util.List<ChatMessage> messages, boolean isStream) 构建符合 Gemini API 规范的请求 JSON 主要处理逻辑： 构建 contents 数组，包含对话历史 处理 generationConfig 配置，特别是类型转换 类型转换说明：由于 YAML 配置文件读取的值都是字符串， 需要在此处进行类型转换以符合 Gemini API 的要求： temperature 和 topP 转换为 Double 类型（范围 0-1 的小数） thinkingBudget 转换为 Integer 类型（思考token预算） thinkingConfig 中的 includeThoughts 转换为 Boolean 类型
org.noear.solon.net.http.HttpUtils	createHttpUtils(ChatConfig config) 创建 http 工具
org.noear.solon.net.http.HttpUtils	createHttpUtils(ChatConfig config, boolean isStream) 创建 http 工具
static GeminiChatDialect	getInstance()
boolean	matched(ChatConfig config) 匹配检测
java.util.List<AssistantMessage>	parseAssistantMessage(ChatResponseDefault resp, org.noear.snack4.ONode oMessage) 分析工具调用
boolean	parseResponseJson(ChatConfig config, ChatResponseDefault resp, java.lang.String json) 分析响应数据

从类继承的方法 org.noear.solon.ai.chat.dialect.AbstractChatDialect

buildAssistantMessageByToolMessages, buildAssistantMessageNodeDo, buildChatMessageNode, buildReqToolsNode, buildReqToolsNodeDo, buildSystemMessageNodeDo, buildToolMessageNodeDo, buildUserMessageNodeDo, hasNestedJsonBlock, parseAssistantMessageContent, parseToolCall, parseToolCalls

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.chat.dialect.ChatDialect

isDefault

构造器详细资料

GeminiChatDialect

public GeminiChatDialect()

方法详细资料

getInstance

public static GeminiChatDialect getInstance()

matched

public boolean matched(ChatConfig config)

匹配检测

参数:

config - 聊天配置

createHttpUtils

public org.noear.solon.net.http.HttpUtils createHttpUtils(ChatConfig config)

从接口复制的说明: ChatDialect

创建 http 工具

指定者:

createHttpUtils 在接口中 ChatDialect

覆盖:

createHttpUtils 在类中 AbstractChatDialect

参数:

config - 聊天配置

createHttpUtils

public org.noear.solon.net.http.HttpUtils createHttpUtils(ChatConfig config,
                                                          boolean isStream)

从接口复制的说明: ChatDialect

创建 http 工具

参数:

config - 聊天配置

isStream - 是否流式获取

parseResponseJson

public boolean parseResponseJson(ChatConfig config,
                                 ChatResponseDefault resp,
                                 java.lang.String json)

从接口复制的说明: ChatDialect

分析响应数据

参数:

config - 聊天配置

resp - 响应体

json - 响应数据

buildRequestJson

public java.lang.String buildRequestJson(ChatConfig config,
                                         ChatOptions options,
                                         java.util.List<ChatMessage> messages,
                                         boolean isStream)

构建符合 Gemini API 规范的请求 JSON

主要处理逻辑：

• 构建 contents 数组，包含对话历史
• 处理 generationConfig 配置，特别是类型转换

类型转换说明：由于 YAML 配置文件读取的值都是字符串， 需要在此处进行类型转换以符合 Gemini API 的要求：

• temperature 和 topP 转换为 Double 类型（范围 0-1 的小数）
• thinkingBudget 转换为 Integer 类型（思考token预算）
• thinkingConfig 中的 includeThoughts 转换为 Boolean 类型

指定者:

buildRequestJson 在接口中 ChatDialect

覆盖:

buildRequestJson 在类中 AbstractChatDialect

参数:

config - 聊天配置

options - 聊天选项

messages - 对话消息列表

isStream - 是否使用流式模式

返回:

符合 Gemini API 规范的 JSON 字符串

buildAssistantToolCallMessageNode

public org.noear.snack4.ONode buildAssistantToolCallMessageNode(ChatResponseDefault resp,
                                                                java.util.Map<java.lang.String,ToolCallBuilder> toolCallBuilders)

从接口复制的说明: ChatDialect

构建助理消息节点

指定者:

buildAssistantToolCallMessageNode 在接口中 ChatDialect

覆盖:

buildAssistantToolCallMessageNode 在类中 AbstractChatDialect

toolCallBuilders - 工具调用构建器集合

parseAssistantMessage

public java.util.List<AssistantMessage> parseAssistantMessage(ChatResponseDefault resp,
                                                              org.noear.snack4.ONode oMessage)

从接口复制的说明: ChatDialect

分析工具调用

指定者:

parseAssistantMessage 在接口中 ChatDialect

覆盖:

parseAssistantMessage 在类中 AbstractChatDialect

参数:

resp - 响应体

oMessage - 消息节点