@flink-app/ gemini- 适应器

Google 双子座适配器 Flink AI框架,基于 @google/genai SDK(双子座开发者 API). SDK是一个正常的依赖, 不需要其他安装.

安装

npm install @flink-app/gemini-adapter

使用量

import { GeminiAdapter } from "@flink-app/gemini-adapter";
import { FlinkApp } from "@flink-app/flink";

const app = new FlinkApp({
  ai: {
    llms: {
      default: new GeminiAdapter({
        apiKey: process.env.GOOGLE_AI_API_KEY!,
        model: "gemini-2.0-flash",
      }),
    },
  },
});

配置

支持的模式

• gemini-2.0-flash - 快速、有成本效益(建议默认)
• gemini-1.5-pro - 能力高,背景长
• gemini-1.5-flash - 快速、平衡的能力
• gemini-2.5-pro-preview-03-25 - 最新预览模式

思考

思维模型(Gemini 2.5 / 3 系列)配置 thinkingConfig,通过逐字记录 config.thinkingConfig数字 :

const adapter = new GeminiAdapter({
  apiKey: process.env.GOOGLE_AI_API_KEY!,
  model: "gemini-2.5-pro",
  thinkingConfig: { includeThoughts: true, thinkingBudget: 2048 }, // optional
});

• 与 includeThoughts: true,思考摘要作为 reasoning 块并被物剂浮出水面 reasoning_delta 活动 fullStream。它们从未出现在 textStream 或者说 result.message。摘要不发回双子座.
• 思想签名 文本返回,函数调用部分被捕获(providerData.gemini.signatures),并在后回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回 双子座 3 拒绝工具调用续作, 当第一个函数调用的签名缺失时为 400 , 所以不管发生 thinkingConfig。 。 。 .
• 思考符号thoughtsTokenCount)列入报告 outputTokens。 。 。 .

结构化输出和工具选择

经纪人的 model.structuredOutput 以 config.responseMimeType: "application/json" 加号 responseSchema双子座取了JSON Schema的OpenAPI风格子集,所以 $schema, (中文(简体) ), $ref, (中文(简体) ), $defs, (中文(简体) ), additionalProperties 财务报告和审定财务报表 default 被剥去(同样的消毒工具计划)。 解析后的答复如下: result.structured。 。 。 .

双子座不接受反应计划与函数声明. 在携带工具的步骤上,通过系统指令请求 schema 代替,而 Flink 验证答案;一旦一个步骤没有工具,即使用 原生反应 schema .

model.toolChoice 以 toolConfig.functionCallingConfig数字 : "auto" → AUTO, (中文(简体) ), "none" → NONE, (中文(简体) ), "required" → ANY, (中文(简体) ), { type: "tool", name } → ANY 与 allowedFunctionNames: [name]。只有当请求带有工具时才发出.

图像模型

GeminiImageModel 执行 Flink 的 ImageModel 具有图像能力的双子座模型的接口(gemini-3.1-flash-image, (中文(简体) ), gemini-3-pro-image, (中文(简体) ), gemini-3.1-flash-lite-image)通过 generateContent 带有图像响应模式.

import { GeminiImageModel } from "@flink-app/gemini-adapter";

const app = new FlinkApp<AppCtx>({
    ai: {
        images: {
            default: new GeminiImageModel({ apiKey: process.env.GEMINI_API_KEY!, model: "gemini-3.1-flash-image", imageSize: "2K" }),
        },
    },
});

const { images } = await ctx.ai.images.default.edit({
    prompt: "Make it night time, keep the car unchanged",
    images: [imageFromBuffer(file, "image/png")],
});

• 编辑是即时驱动的:双子座不带口罩(capabilities.mask 假的, 面具失败 unsupported(中文(简体) )
• size 减为带警告的宽度比; n 上面有一个由平行请求提供
• 文本与图像一起返回 providerMetadata.gemini.text· ; providerOptions.gemini 合并到请求中 config
• 见 图像模型指南

特征

• QQ 工具调用支持
• * 思考(thinkingConfig (通过) reasoning_delta,在转弯时重放签名
• * 流式反应(SSE/NDJSON)
• QQ 转向执行( 连续的相同作用信息合并)
• 系统指令处理
• JSON Schema 为双子座兼容性进行消毒
• QQ 调用跟踪
• 调试日志

使用 FlinkAgent

import { FlinkAgent } from "@flink-app/flink";
import { GeminiAdapter } from "@flink-app/gemini-adapter";

export default class CarAgent extends FlinkAgent<AppContext> {
  instructions = "You are a helpful car assistant.";
  llm = new GeminiAdapter({
    apiKey: process.env.GOOGLE_AI_API_KEY!,
    model: "gemini-2.0-flash",
  });
}

许可证

麻省理工学院