Model Adapter (OpenAI / Gemini)

createOpenAIAdapter（@rejelly/adapter-openai）与 createGeminiAdapter（@rejelly/adapter-gemini）负责把 provider 模型包装成 Rejelly 的 ModelAdapter，并把 promptAgent(schema) 的 JSON Schema 交给底层模型。

多模态工具结果的发送侧契约见 Adapter · 多模态工具结果。

创建模型适配器

OpenAI

import { createOpenAIAdapter } from '@rejelly/adapter-openai';

const model = createOpenAIAdapter({
  modelId: 'gpt-5.6-luna',
  apiKey: process.env.OPENAI_API_KEY,
  schemaMode: 'json_schema',
});

createOpenAIAdapter 也可接 OpenAI-compatible provider：

import { createOpenAIAdapter } from '@rejelly/adapter-openai';

const model = createOpenAIAdapter({
  id: 'deepseek-chat',
  provider: 'deepseek',
  modelId: 'deepseek-chat',
  apiKey: process.env.DEEPSEEK_API_KEY,
  baseURL: 'https://api.deepseek.com',
  schemaMode: 'json_object',
  chatCompletionParams: {
    temperature: 0.2,
  },
  requestOption: {
    timeout: 60_000,
  },
});

响应头等待与流式空闲超时

requestOption.timeout 是 OpenAI SDK 等待响应头的预算。流式请求收到 HTTP 响应头后就停止计时，并不是整次生成的总时限。网关可能等到上游首个 SSE 事件后才发送响应头。

通过 streamIdleTimeoutMs 单独限制收到响应头后等待下一个 SDK 协议事件的时间。Chat Completions 和 Responses 均支持；元数据事件和内容事件都会重置等待，不计算消费方处理事件的时间。不设置时不增加空闲时限。只有 SSE 注释、没有 SDK 协议事件的心跳不会重置等待。

const model = createOpenAIAdapter({
  modelId: 'gpt-5.6-luna',
  requestOption: { timeout: 300_000, maxRetries: 0 },
  streamIdleTimeoutMs: 300_000,
});

流式空闲超时会中止上游请求，归类为 code 为 timeout 的 ModelCallError，错误消息会区分响应头等待超时和流中途停滞。用户取消仍按取消处理。

Gemini

import { createGeminiAdapter } from '@rejelly/adapter-gemini';

const model = createGeminiAdapter({
  modelId: 'gemini-2.5-pro',
  apiKey: process.env.GEMINI_API_KEY,
  schemaMode: 'json_schema',
});

Gemini 在 Node 环境下若未显式传 apiKey，会读取 GEMINI_API_KEY 或 GOOGLE_API_KEY；浏览器环境应显式传入。需要透传 Gemini 请求参数时使用 generateContentParams：

import { createGeminiAdapter } from '@rejelly/adapter-gemini';

const model = createGeminiAdapter({
  modelId: 'gemini-2.5-flash',
  schemaMode: 'prompt',
  generateContentParams: {
    temperature: 0.3,
  },
});

在 Agent 中使用

创建出的对象就是 Rejelly ModelAdapter，可直接放进 createAgent({ model })，或通过 runWith 的模型注册表统一注入。

import { createAgent, promptAgent } from '@rejelly/core';
import { createOpenAIAdapter } from '@rejelly/adapter-openai';
import { z } from 'zod';

const model = createOpenAIAdapter({
  modelId: 'gpt-5.6-luna',
  apiKey: process.env.OPENAI_API_KEY,
});

const AnswerSchema = z.object({
  answer: z.string(),
});

export const AnswerAgent = createAgent({
  id: 'answer',
  model,
  handler: async () => {
    return await promptAgent(AnswerSchema);
  },
});

费用统计

如果要让 Budget 机制记录真实费用，在 adapter 上提供 calculateCost。返回值使用整数单位，例如 micro_usd。

import { createOpenAIAdapter } from '@rejelly/adapter-openai';

const model = createOpenAIAdapter({
  modelId: 'gpt-5.6-luna',
  apiKey: process.env.OPENAI_API_KEY,
  calculateCost: (usage) => ({
    micro_usd:
      Math.ceil(usage.promptTokens * 1) +
      Math.ceil(usage.completionTokens * 6),
  }),
});

Prompt 注入 schema

通过 schemaMode 选择 schema 交付方式：

• "prompt"：把 schema 注入 system prompt，兼容最广（OpenAI 默认）。
• "json_object"：OpenAI Chat Completions 使用 response_format: { type: "json_object" }，OpenAI Responses API 使用等价的 text.format: { type: "json_object" }，Gemini 使用 responseMimeType: "application/json"；同时仍注入 schema 到 prompt 补字段约束。适合有 JSON 模式但无严格 schema 的模型（如 DeepSeek）。
• "json_schema"：原生 Structured Outputs（OpenAI strict / Gemini responseSchema），由模型强约束字段（Gemini 默认）。