Struct ContextBudget 

pub struct ContextBudget {
    pub max_tokens: usize,
    pub warning_ratio: f32,
    pub keep_recent_turns: usize,
    pub max_tool_result_chars: usize,
}

上下文预算配置。

控制 Agent Loop 中消息历史的 Token 上限与压缩行为。

Fields

max_tokens: usize

消息历史的最大 Token 数（默认 128k）。

v0.1: 固定默认值 128k，适用于大多数模型 v0.2: 从 ResolvedModel.context_window 自动推导（window * 0.8）

warning_ratio: f32

达到此占比时触发压缩（默认 0.8 = 80%）

keep_recent_turns: usize

压缩时保留最近多少个 Turn（默认 5）

max_tool_result_chars: usize

单条工具结果的最大字符数（默认 4096）

Implementations

impl ContextBudget

pub fn should_compact(&self, current_tokens: usize) -> bool

判断是否需要压缩。

pub fn truncate_tool_result(&self, text: String) -> String

截断单条工具结果，防止单条响应撑爆上下文。

pub fn truncate_tool_result_blocks( &self, content: &[ContentBlock], ) -> Vec<ContentBlock>

截断 ContentBlock 列表中的文本内容（用于非流式路径）。

Trait Implementations

impl Clone for ContextBudget

fn clone(&self) -> ContextBudget

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContextBudget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ContextBudget

fn default() -> Self

Returns the “default value” for a type.