ModelInputMeasurement

CORE · interface · 类型合同

Exact prepared-request accounting; token values exist only with an explicit model counter.

导入

TypeScript

import type { ModelInputMeasurement } from '@jangts/agent-core/model';

JavaScript

/** @typedef {import('@jangts/agent-core/model').ModelInputMeasurement} ModelInputMeasurement */

其他公开入口：@jangts/agent-core、@jangts/agent-core/model、@jangts/agent-core/types、@jangts/agent-core/structs。

定义

interface ModelInputMeasurement

字段结构

字段	类型	必需	说明
messageChars	number	必需	只读。Characters of the message content.
instructionChars	number	必需	只读。Characters of the instruction text.
schemaChars	number	必需	只读。Characters of the compiled capability schemas.
transportChars	number	必需	只读。Characters the transport itself contributes (for example framing).
inputChars	number	必需	只读。Sum of the character components above.
maxInputChars	number	必需	只读。Character budget the input was compared against.
maxSchemaChars	number	必需	只读。Schema budget the input was compared against.
maxOutputTokens	number	必需	只读。Output tokens reserved for this call, which reduces the token input ceiling.
counterId	string | undefined	可省略	只读。Tokenizer identity; present only when a token budget applies.
inputTokens	number | undefined	可省略	只读。Measured input tokens.
inputTokenLimit	number | undefined	可省略	只读。Token ceiling after reserving output and the safety margin.
withinBudget	boolean	必需	只读。True when every applicable character and token budget accepted the input.

使用示例

• 实际请求测量与同次准备快照：需要提前处理上下文时才 prepare；多次测量与最终发送复用同一次传输准备。

普通调用仍然只有 invoke

入门 · Node.js

TypeScript

import { ModelRunner } from '@jangts/agent-core/model';
const provider = {
  async *stream(messages: readonly { content: string }[]) {
    yield '收到：' + messages.at(-1)!.content;
  },
};
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);

JavaScript

import { ModelRunner } from '@jangts/agent-core/model';
const provider = {
    async *stream(messages) {
        yield '收到：' + messages.at(-1).content;
    },
};
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);

只在需要测量时准备一次

配置 · Node.js

TypeScript

import { ModelRunner } from '@jangts/agent-core/model';
const provider = {
  async *stream(messages: readonly { content: string }[]) {
    yield '收到：' + messages.at(-1)!.content;
  },
};
const runner = new ModelRunner({ provider, maxInputChars: 1000 });
const prepared = runner.prepare({ stageId: 'reply', maxOutputTokens: 400 });
const input = '你好，解释这次服务状态';
console.log(prepared.measure(input));
const result = await runner.invoke({ input, prepared });
console.log(result.value);

JavaScript

import { ModelRunner } from '@jangts/agent-core/model';
const provider = {
    async *stream(messages) {
        yield '收到：' + messages.at(-1).content;
    },
};
const runner = new ModelRunner({ provider, maxInputChars: 1000 });
const prepared = runner.prepare({ stageId: 'reply', maxOutputTokens: 400 });
const input = '你好，解释这次服务状态';
console.log(prepared.measure(input));
const result = await runner.invoke({ input, prepared });
console.log(result.value);

相关策略源码

• 同次准备与真实输入计量