ModelBudgetStrategy

SUPPORT · type · 类型合同

Preset name, or an explicit partial set of Core runner settings.

导入

TypeScript

import type { ModelBudgetStrategy } from '@jangts/agent-core/support';

JavaScript

/** @typedef {import('@jangts/agent-core/support').ModelBudgetStrategy} ModelBudgetStrategy */

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

定义

类型： ModelBudgetStrategy

类型表达式

type ModelBudgetStrategy = keyof typeof modelBudgetStrategies | Partial<ModelRunnerSettings>;

联合分支结构

ModelBudgetStrategy的可选结构： 选择其中一种结构，各分支的字段要求分别列出。

分支 1

"small"

分支 2

"medium"

分支 3

"large"

分支 4

字段	类型	必需	说明
children	ModelChildPolicy | undefined	可省略	只读。见类型定义及调用场景。
maxInputChars	number | undefined	可省略	Character budget for the assembled input.
maxSchemaChars	number | undefined	可省略	Character allowance for registered capability schemas.
tokenBudget	ModelTokenBudget | undefined	可省略	见类型定义及调用场景。
maxOutputTokens	number | undefined	可省略	Default output reservation; invoke can override it for one call.
maxCalls	number | undefined	可省略	Calls allowed for the whole request, including descendant runners' reservations.
callTimeoutMs	number | undefined	可省略	Deadline for one provider call, in milliseconds.
maxOutputChars	number | undefined	可省略	Cap on streamed output characters; exceeding it fails the call.
usage	boolean | undefined	可省略	Request and record provider usage for each call.

使用示例

• 模型策略：显式选择与推荐预算：从已登记的模型和推理配置中选择，以本地预算档位补全 Core 设置，并保留逐字段精确覆盖。

短任务使用小预算，增加需求仍沿用同一 Core 构造

入门 · Node.js

TypeScript

import { AgentCoreEngine, ModelRunner, Support } from '@jangts/agent-core';
const provider = { async *stream() { yield '服务在线。'; } };
const config = Support.createModelStrategy({ model: { provider }, budget: 'small' });
const model = new ModelRunner(config);
console.log((await model.invoke('服务状态？')).value);
const agent = new AgentCoreEngine({ model: config });
console.log(agent.branch.agentId);

JavaScript

import { AgentCoreEngine, ModelRunner, Support } from '@jangts/agent-core';
const provider = { async *stream() { yield '服务在线。'; } };
const config = Support.createModelStrategy({ model: { provider }, budget: 'small' });
const model = new ModelRunner(config);
console.log((await model.invoke('服务状态？')).value);
const agent = new AgentCoreEngine({ model: config });
console.log(agent.branch.agentId);

已有模型用 ID 代指，推理方案显式登记

配置 · Node.js

示例 Provider 完全离线。实际供应商的推理参数由各 Provider 的显式配置实现。

TypeScript

import { ModelRunner, Support } from '@jangts/agent-core';
const fast = { async *stream() { yield '简短回答'; } };
const reasoned = { async *stream() { yield '经过复核的回答'; } };
const models = { fast: { provider: fast }, thorough: { provider: reasoned } };
const config = Support.createModelStrategy({ model: 'fast', models, budget: 'small',
  reasoning: 'high', reasoningOptions: { high: { provider: reasoned } },
  maxCalls: 1, maxOutputTokens: 1200,
});
console.log((await new ModelRunner(config).invoke('检查资料')).value);

JavaScript

import { ModelRunner, Support } from '@jangts/agent-core';
const fast = { async *stream() { yield '简短回答'; } };
const reasoned = { async *stream() { yield '经过复核的回答'; } };
const models = { fast: { provider: fast }, thorough: { provider: reasoned } };
const config = Support.createModelStrategy({ model: 'fast', models, budget: 'small',
    reasoning: 'high', reasoningOptions: { high: { provider: reasoned } },
    maxCalls: 1, maxOutputTokens: 1200,
});
console.log((await new ModelRunner(config).invoke('检查资料')).value);

相关策略源码

• 推荐预算、同合同补全和覆盖顺序

相关定义

• modelBudgetStrategies
• ModelRunnerSettings