ContextFragmentUsage

CORE · interface · 类型合同

Accounting entry reported for one fragment that actually entered the context.

导入

TypeScript

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

JavaScript

/** @typedef {import('@jangts/agent-core/context').ContextFragmentUsage} ContextFragmentUsage */

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

定义

interface ContextFragmentUsage

字段结构

字段	类型	必需	说明
id	string	必需	见类型定义及调用场景。
sourceId	string	必需	见类型定义及调用场景。
trust	ContextTrust	必需	见类型定义及调用场景。
lifetime	ContextLifetime	必需	见类型定义及调用场景。
chars	number	必需	Characters consumed after formatting.
maxChars	number	必需	Budget that applied to this fragment.

使用示例

• 上下文片段：明确来源、信任和预算：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);

相关策略源码

• 片段校验与预算拒绝

相关定义

• ContextLifetime
• ContextTrust