MockGPTOptions

KIT · interface · 类型合同

Construction options of a MockGPT instance.

导入

TypeScript

import type { MockGPTOptions } from '@jangts/agent-core/mock';

JavaScript

/** @typedef {import('@jangts/agent-core/mock').MockGPTOptions} MockGPTOptions */

其他公开入口：@jangts/agent-core/mock。

定义

interface MockGPTOptions

字段结构

字段	类型	必需	说明
rules	readonly Rule[]	必需	Ordered rules; the first rule whose filters all pass wins, so order is significant.
fallback	Generator | undefined	可省略	Generator used when no rule matches; absent makes an unmatched call a MOCK_RULE_NOT_FOUND error.
selectPrompt	((request: ModelRequest) => string) | undefined	可省略	Overrides prompt extraction; must return a string synchronously; default is the last user text.
stream	Pick<OutputOptions, "chunkSize" | "intervalMs" | "wireChunkSize"> | undefined	可省略	Defaults merged under every generated output; explicit output fields take precedence.
seed	number | undefined	可省略	Seed for the deterministic PRNG (0-0xffffffff); default 1, so identical call sequences repeat.
clock	(() => number) | undefined	可省略	Millisecond timestamp source for date generators and response created; must be finite.
recordLimit	number | undefined	可省略	Ring-buffer size of records; 0 disables recording; max 10 000; default 100.
maxBodyBytes	number | undefined	可省略	Maximum accepted request body in bytes for fetch; default 1 MiB.
maxOutputChars	number | undefined	可省略	Maximum generated content in code points plus serialized tool calls; default 1 000 000.

使用示例

• MockGPT：直接生成与 Provider 注入：直接取得字符串或 JSON；需要检验模型通信时，将同一个实例注入 Provider。

直接生成原生 JSON

入门 · Node.js

TypeScript

import { MockGPT } from '@jangts/agent-core/mock';
const mock = new MockGPT({ rules: [{ prompt: '服务状态', generator: { online: true, source: 'fixture' } }] });
const value = await mock.generate({ model: 'demo', messages: [{ role: 'user', content: '服务状态' }] });
console.log(value); // { online: true, source: 'fixture' }
console.log(mock.counts, mock.records);

JavaScript

import { MockGPT } from '@jangts/agent-core/mock';
const mock = new MockGPT({ rules: [{ prompt: '服务状态', generator: { online: true, source: 'fixture' } }] });
const value = await mock.generate({ model: 'demo', messages: [{ role: 'user', content: '服务状态' }] });
console.log(value); // { online: true, source: 'fixture' }
console.log(mock.counts, mock.records);

同一实例注入真实 Core 模型边界

配置 · Node.js

TypeScript

import { ModelRunner, Support } from '@jangts/agent-core';
import { MockGPT, responses } from '@jangts/agent-core/mock';
const mock = new MockGPT({ rules: [{ prompt: '服务状态', generator: responses.text('服务在线。', { chunkSize: 2, wireChunkSize: 3 }) }] });
const provider = new Support.CompatibleModelProvider({
  config: { baseUrl: 'https://mock.local/v1', apiKey: 'offline-example', model: 'demo' },
  ports: { request: mock.fetch },
});
const result = await new ModelRunner({ provider, maxCalls: 1 }).invoke('服务状态');
console.log(result.value, result.invocation.status);

JavaScript

import { ModelRunner, Support } from '@jangts/agent-core';
import { MockGPT, responses } from '@jangts/agent-core/mock';
const mock = new MockGPT({ rules: [{ prompt: '服务状态', generator: responses.text('服务在线。', { chunkSize: 2, wireChunkSize: 3 }) }] });
const provider = new Support.CompatibleModelProvider({
    config: { baseUrl: 'https://mock.local/v1', apiKey: 'offline-example', model: 'demo' },
    ports: { request: mock.fetch },
});
const result = await new ModelRunner({ provider, maxCalls: 1 }).invoke('服务状态');
console.log(result.value, result.invocation.status);

相关定义

• Generator
• JsonValue
• ModelRequest
• OutputOptions
• ResponseDescription
• Rule