validateContextFragment

CORE · function · 运行时值

Validate one fragment and return the text it contributes to the model input.

导入

TypeScript

import { validateContextFragment } from '@jangts/agent-core/context';

JavaScript

import { validateContextFragment } from '@jangts/agent-core/context';

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

定义

调用

validateContextFragment(fragment: ContextFragment, ids?: Set<string>, checkBudget?: boolean): string

Validate one fragment and return the text it contributes to the model input.

参数	类型	传递	说明
fragment	ContextFragment	必需	—
ids	Set<string>	可省略	—
checkBudget	boolean	可省略	—

fragment 的字段

字段	类型	必需	说明
id	string	必需	Unique, stable id matching ^[a-z][a-zA-Z0-9:._-]*$; duplicates are rejected.
sourceId	string	必需	Owning source (module or registration) used to explain where the content came from.
trust	ContextTrust	必需	Producer trust level. user and tool content cannot become a system message.
lifetime	ContextLifetime	必需	Declared validity window of this content.
maxChars	number	必需	Hard upper bound in JSON characters; must be a positive safe integer.
role	"system" | "user"	必需	Message slot the fragment occupies when assembled.
value	string | Record<string, unknown>	必需	Rendered content. A system message accepts a string only, never a record.

返回： string。

使用示例

• 上下文片段：明确来源、信任和预算：Core 识别片段与装配合同，校验来源元数据和预算，不内置业务压缩算法。

用裸配置装配一份输入

入门 · Node.js

TypeScript

import { assembleFragments } from '@jangts/agent-core/context';
const input = assembleFragments([{ id: 'question', sourceId: 'request', trust: 'user',
  lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }], 2000);
console.log(input.messages, input.fragmentUsage);

JavaScript

import { assembleFragments } from '@jangts/agent-core/context';
const input = assembleFragments([{ id: 'question', sourceId: 'request', trust: 'user',
        lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }], 2000);
console.log(input.messages, input.fragmentUsage);

增加候选计划与最终审计

配置 · Node.js

可变片段列表为空，表示不允许修改原片段；不会自动授权一个压缩步骤。

TypeScript

import { assembleContextPlan } from '@jangts/agent-core/context';
import type { ContextFragment } from '@jangts/agent-core/types';
const fragments: ContextFragment[] = [{ id: 'question', sourceId: 'request', trust: 'user',
  lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }];
const input = assembleContextPlan({ fragments, originalFragments: fragments, mutableFragmentIds: [], maxInputChars: 2000 });
console.log(input.inputChars);

JavaScript

import { assembleContextPlan } from '@jangts/agent-core/context';
const fragments = [{ id: 'question', sourceId: 'request', trust: 'user',
        lifetime: 'turn', maxChars: 1000, role: 'user', value: '现在服务状态怎样？' }];
const input = assembleContextPlan({ fragments, originalFragments: fragments, mutableFragmentIds: [], maxInputChars: 2000 });
console.log(input.inputChars);

相关策略源码

• 片段校验与预算拒绝

相关定义

• ContextFragment