selectContextSteps

SUPPORT · function · 运行时值

Choose steps that fit the remaining call budget.

Feasibility uses exact trim previews and declared call ceilings; the reply reserve and the selector's own allowance are subtracted before candidates are considered, so neither can be spent on reductions.

导入

TypeScript

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

JavaScript

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

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

定义

调用

selectContextSteps(input: SelectionInput): Promise<SelectionResult>

Choose steps that fit the remaining call budget.

Feasibility uses exact trim previews and declared call ceilings; the reply reserve and the selector's own allowance are subtracted before candidates are considered, so neither can be spent on reductions.

参数	类型	传递	说明
input	SelectionInput	必需	—

input 的字段

字段	类型	必需	说明
signal	AbortSignal	必需	只读。见类型定义及调用场景。
diagnostics	DiagnosticContext | undefined	可省略	见类型定义及调用场景。
selection	ContextSelection	必需	见类型定义及调用场景。
selectors	readonly ContextSelector[]	必需	见类型定义及调用场景。
stageId	string	必需	只读。见类型定义及调用场景。
candidates	readonly ContextSelectionCandidate[]	必需	Reducible candidates, already filtered and measured.
fragments	readonly ContextFragment[]	必需	Only reducible fragments; never protected request or system fragments.
currentTokens	number | undefined	可省略	Current input tokens, when a token budget applies.
requiredReductionTokens	number | undefined	可省略	Tokens that must be removed to satisfy the token budget.
currentChars	number	必需	见类型定义及调用场景。
requiredReductionChars	number	必需	Characters that must be removed to satisfy the character budget.
remainingCalls	number	必需	Calls the selector may still spend through callModel.
callModel	ContextModelCall	必需	见类型定义及调用场景。

返回： Promise<SelectionResult>。

等待后的值： SelectionResult。

返回值结构

字段	类型	必需	说明
stepIds	string[]	必需	见类型定义及调用场景。
reason	string	必需	见类型定义及调用场景。

使用示例

• 选择缩减步骤：顺序、固定、自动或模型：一套类型化策略表达多种场景，保留精确参数与 App 自定义选择。

按已登记顺序处理

入门 · Node.js

TypeScript

import { Support } from '@jangts/agent-core';
Support.validateContextSelection({ mode: 'sequence' }, []);
console.log(Object.keys(Support.contextSelectionCatalog));

JavaScript

import { Support } from '@jangts/agent-core';
Support.validateContextSelection({ mode: 'sequence' }, []);
console.log(Object.keys(Support.contextSelectionCatalog));

按场景选择策略并精确覆盖

配置 · Node.js

TypeScript

import { Support } from '@jangts/agent-core';
const localOnly = { mode: 'fixed' as const, kind: 'trim' as const };
const preserveMore = { mode: 'auto' as const, maxTrimLossRatio: 0.1, reserveCalls: 2 };
Support.validateContextSelection(localOnly, []);
Support.validateContextSelection(preserveMore, []);
console.log(localOnly, preserveMore);

JavaScript

import { Support } from '@jangts/agent-core';
const localOnly = { mode: 'fixed', kind: 'trim' };
const preserveMore = { mode: 'auto', maxTrimLossRatio: 0.1, reserveCalls: 2 };
Support.validateContextSelection(localOnly, []);
Support.validateContextSelection(preserveMore, []);
console.log(localOnly, preserveMore);

相关策略源码

• 选择策略目录、保留额度及可行性筛选