Message

KIT · type · 类型合同

One entry of an OpenAI chat conversation.

The runtime validates role against the OpenAI role set and validates the outer shape of content; every other field is retained verbatim so vendor extensions flow through.

导入

TypeScript

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

JavaScript

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

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

定义

类型： Message

类型表达式

type Message = Readonly<{
  /**
   * `system`, `developer`, `user`, `assistant`, `tool` or `function`; anything else is rejected.
   */
  role: string;
  /** Text, a multimodal content-block array or null; numbers and objects are rejected. */
  content?: unknown;
  /** Opaque tool-call array from a previous assistant turn; never interpreted here. */
  tool_calls?: unknown;
  /** Correlates a `tool` message with the assistant tool call it answers. */
  tool_call_id?: string;
  /** Vendor extensions are snapshotted and preserved but never interpreted by the runtime. */
  [key: string]: unknown;
}>;

字段结构

字段	类型	必需	说明
role	string	必需	system, developer, user, assistant, tool or function; anything else is rejected.
content	unknown	可省略	Text, a multimodal content-block array or null; numbers and objects are rejected.
tool_calls	unknown	可省略	Opaque tool-call array from a previous assistant turn; never interpreted here.
tool_call_id	string | undefined	可省略	Correlates a tool message with the assistant tool call it answers.

索引结构

字段	类型	必需	说明
[key: string]	unknown	必需	只读。索引项。

使用示例

• MockGPT：直接生成与 Provider 注入：直接取得字符串或 JSON；需要检验模型通信时，将同一个实例注入 Provider。
• MockGPT：响应描述与场景生成器：固定结果用于严格回归，输入相关生成器用于探索接线，显式响应描述用于故障和流式场景。

直接生成原生 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);