Agent Harness 记忆压缩实战：函数结果压缩了，为什么 Token 还是一路上涨？

var compactionStrategy =
    new ToolResultCompactionStrategy(
        trigger: CompactionTriggers.TokensExceed(1000),
        minimumPreservedGroups: 3);

using AIConfig;
using Azure;
using Azure.AI.OpenAI;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.Compaction;
using Microsoft.Extensions.AI;
using System.ClientModel;
using System.ComponentModel;
using System.Text.Json;
#pragma warning disable
var aiConfig = new AzureOpenAIConfig("gpt-5.6-luna");
var credential = new ApiKeyCredential(aiConfig.Key);
var options = new JsonSerializerOptions()
{
    WriteIndented = true,
    Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping
};
// 分别创建主对话模型与摘要/压缩相关模型客户端。
var agentChatClient = new AzureOpenAIClient(new Uri(aiConfig.Endpoint), credential)
    .GetChatClient(aiConfig.DeploymentName)
    .AsIChatClient();
//将较旧的工具调用组折叠为压缩摘要消息，从而保留可读跟踪，而不会造成完整的消息开销。
var compactionStrategy = new ToolResultCompactionStrategy(trigger: CompactionTriggers.TokensExceed(1000), minimumPreservedGroups: 3);
// 构建带有上下文压缩能力的智能体，并注册获取小说内容的工具函数。
var agent = agentChatClient
        .AsBuilder()
        .UseAIContextProviders(new CompactionProvider(compactionStrategy))
        .BuildAIAgent(
            new ChatClientAgentOptions
            {
                Name = "Assistant",
                ChatOptions = new()
                {
                    Instructions = "你是一个友好的助手。",
                    Tools = [AIFunctionFactory.Create(GetNovel, nameof(GetNovel))]
                }
            });
// 创建会话，并连续发送多轮查询以观察压缩效果。
var session = await agent.CreateSessionAsync();
var list = new List<string>
{
    "我想找小说《雾港来信》",
    "我想找小说《纸月亮》",
    "我想找小说《第七座花园》",
    "我想找小说《雨中棋局》",
    "我想找小说《星火列车》"
};
foreach (var input in list)
{
    Console.WriteLine("您说：" + input);
    var response = await agent.RunAsync(input, session);
    Console.WriteLine("助手说：");
    Console.WriteLine(response.Text);
    Console.ForegroundColor = ConsoleColor.Yellow;
    Console.WriteLine($"总 Token 数:{response.Usage.TotalTokenCount}\n 输入 Token 数：{response.Usage.InputTokenCount}\n 输出 Token 数：{response.Usage.OutputTokenCount}\n 缓存输入 Token 数：{response.Usage.CachedInputTokenCount}\n 推理 Token 数：{response.Usage.ReasoningTokenCount}");
    Console.ResetColor();
}
var serializedSession = await agent.SerializeSessionAsync(session);
//Console.WriteLine(JsonSerializer.Serialize(serializedSession, options: options));
PrintMessageGroups(serializedSession, options, "ToolResultCompactionStrategy");
void PrintMessageGroups(JsonElement serializedSession, JsonSerializerOptions options, string propertyName)
{
    if (serializedSession.TryGetProperty("stateBag", out var stateBag) &&
        stateBag.TryGetProperty(propertyName, out var strategy) &&
        strategy.TryGetProperty("messagegroups", out var messageGroups) &&
        messageGroups.ValueKind == JsonValueKind.Array)
    {
        foreach (var item in messageGroups.EnumerateArray())
        {
            if (item.TryGetProperty("isExcluded", out var isExcluded) && isExcluded.GetBoolean())
            {
                Console.ForegroundColor = ConsoleColor.Red;
            }
            else
            {
                Console.ForegroundColor = ConsoleColor.Green;
            }
            Console.WriteLine(JsonSerializer.Serialize(item, options));
        }
    }
    Console.ResetColor();
}
[Description("按名称获取一部小说")]
// 提供给智能体调用的工具函数：按名称返回预置小说内容。
static string GetNovel([Description("名称（带书名号）")] string name)
{
    var novels = new Dictionary<string, string>
    {
        {
            "《雾港来信》",
            "清晨的雾把海港裹得像一封未拆的信。林澈在旧邮局值夜，发现一只没有邮戳的蓝色信封，收信人竟是三十年前失踪的母亲。信里只有一句话：别让灯塔熄灭。当晚，废弃灯塔忽然亮    起，海面传来熟悉的歌声。林澈循声而去，看见母亲年轻时的身影站在浪尖。她告诉他，港口每隔三十年会吞下一段记忆，而灯塔能照回被遗忘的人。天亮前，林澈必须选择：留 住 母  亲，还是救回整座城市失去的过去。"
        },
        {
            "《纸月亮》",
            "小镇上空每晚都会升起一轮纸做的月亮，薄得能看见背后的星光。阿眠是镇上唯一的修月师，她用银线缝补月面的裂痕。一天，她在裂缝里发现一座倒悬的城市，那里的人白天生活，  夜  晚化作影子。城市少年纪南请求她剪断月亮，因为他们被困在纸背面已百年。可若月亮坠落，小镇将永远失去夜晚。阿眠把自己的影子送进裂缝，让它替纪南托住城市。此后纸 月依旧 升 起，只是月光里多了一个女孩缝线的身影。"
        },
        {
            "《第七座花园》",
            "王宫后有六座花园，四季不败，唯独传说中的第七座无人见过。园丁少年陆安在修剪玫瑰时，听见墙内有人呼唤他的名字。他推开爬满藤蔓的小门，进入一片没有颜色的花海。守园的  盲  眼公主说，这里收藏着世人放弃的愿望，只有找回颜色，花园才会重返人间。陆安把自己的梦想一朵朵讲给花听，白花渐渐染上晨霞、湖水与火焰的色彩。最后一朵花却需要他 的未 来。陆安笑着种下种子，醒来时已成老者，手中握着一瓣金色花瓣。"
        },
        {
            "《雨中棋局》",
            "江南连下七日雨，茶馆里来了一位不带伞的老人。他摆开棋盘，说谁能赢他，便能换回一件失去之物。许多人输掉回忆，唯有卖伞女苏青坐下不走。她想换回战死兄长的最后一句话。  棋  至中盘，雨声忽变成马蹄声，棋子化作沙场上的兵甲。苏青看见兄长被困阵中，才明白老人并非赌徒，而是替亡魂寻归路的引棋人。她弃车保帅，让黑子冲出重围。棋局终了，老人消  失，伞下落下一声轻叹：好好活着，别再等雨停。"
        },
        {
            "《星火列车》",
            "午夜零点，废弃车站会停下一列没有车票的列车，车窗里盛满星光。少年迟野为寻找离家的父亲，偷偷登上最后一节车厢。列车长告诉他，这趟车只载未完成的告别，每到一站，乘客  便  能见到想念之人一分钟。迟野穿过流星隧道，看见父亲坐在煤炉旁修理怀表。父亲说自己并未离开，只是成了驱动车轮的星火，守着儿子长大。终点前，迟野把怀表还给他。列 车再次 启 程，天边多了一颗微亮的新星，而迟野终于学会回家。"
        }
    };
    return novels.TryGetValue(name, out var novel) ? novel : "没有找到这部小说。";
}

{
"stateBag": {
"identifier": "00001",
"InMemoryChatHistoryProvider": {
"messages": [{
"role": "user",
"contents": [{
"$type": "text",
"text": "你好，我有什么证书"
				}]
			}, {
"role": "system",
"contents": [{
"$type": "text",
"text": "**李明 | Backend Software Engineer**  \r\n\uD83D\uDCCD 上海，中国 | ✉️ liming@example.com | [GitHub](https://github.com/liming) | [LinkedIn](https://linkedin.com/in/liming)\r\n\r\n---\r\n\r\n### **个人简介**\r\n性别：男，1988 年出生，计算机科学与技术专业毕业。3 年后端开发经验，精通 Java 和 Python，擅长系统设计、API 开发及性能优化。具备良好的工程思维和团队协作能力，热爱编写高质量、可扩展的代码。熟悉微服务架构，致力于用技术解决实际业务问题。\r\n\r\n---\r\n\r\n### **技能清单**\r\n- **编程语言：** Java, Python, Go, SQL\r\n- **框架与技术：** Spring Boot, Django, FastAPI, gRPC, Redis, Kafka\r\n- **数据库：** MySQL, PostgreSQL, MongoDB\r\n- **其他：** 设计模式，RESTful API 设计，负载均衡，缓存优化\r\n\r\n---\r\n\r\n### **工作经历**\r\n\r\n**后端软件工程师 | 字节跳动 | 2022.05 - 现今 | 上海**\r\n- 负责短视频推送系统的后端开发，设计并优化了推荐服务接口，系统 QPS 提升 30%。\r\n- 主导基于 Spring Cloud 的微服务拆分项目，缩短了服务发布周期 20%。\r\n- 使用 Redis + Kafka 实现消息缓存和异步处理，系统稳定性提升至 99.99%。\r\n- 编写详细的技术文档并培训新人，协助团队代码评审，保证代码质量。\r\n\r\n**后端开发实习生 | 腾讯 | 2021.01 - 2021.08 | 深圳**\r\n- 参与企业微信后台服务开发，使用 Django 开发内部管理工具，减少手工操作时间约 40%。\r\n- 优化 SQL 查询，平均响应时间降低 20%，为后续大规模推广打下基础。\r\n- 与前端工程师协作，完成多个功能模块的 API 接口设计与联调。\r\n\r\n---\r\n\r\n### **项目经历**\r\n\r\n**高并发电商秒杀系统（个人项目）**\r\n- 使用 Spring Boot + Redis + RabbitMQ 设计秒杀服务，支撑 10W+ 并发用户抢购。\r\n- 实现了库存预扣减、异步下单、消息补偿机制，有效防止超卖问题。\r\n\r\n**智能客服系统（团队项目）**\r\n- 基于 FastAPI 搭建后端服务，接入外部 AI 问答引擎，平均响应时间控制在 100ms 以内。\r\n- 设计了模块化接口，方便前端快速对接，提升产品开发效率。\r\n\r\n---\r\n\r\n### **教育背景**\r\n\r\n**上海交通大学 | 计算机科学与技术 | 本科 | 2017 - 2021**\r\n\r\n- 主修课程：数据结构与算法、数据库系统、操作系统、计算机网络\r\n- 获奖情况：ACM 程序设计竞赛校级二等奖\r\n\r\n---\r\n\r\n### **证书**\r\n- 阿里云 ACP 认证：云计算工程师（2023）\r\n- Oracle 认证 Java 程序员（OCP, 2022)"
				}],
"additionalProperties": {
"_attribution": {
"sourceType": {
"value": "ChatHistory"
						},
"sourceId": "Microsoft.Agents.AI.InMemoryChatHistoryProvider"
					}
				}
			}, {
"authorName": "WorkMate",
"createdAt": "2026-07-24T06:33:41+00:00",
"role": "assistant",
"contents": [{
"$type": "text",
"text": "你有以下两项证书：\n\n1. **阿里云 ACP 认证：云计算工程师**（2023 年）\n2. **Oracle 认证 Java 程序员（OCP）**（2022 年）"
				}],
"messageId": "chatcmpl-E53lVGwQOlhDSUdwGczdDfLLcn7Fy"
			}, {
"role": "user",
"contents": [{
"$type": "text",
"text": "我最近考下来日语二级证书了"
				}]
			}, {
"authorName": "WorkMate",
"createdAt": "2026-07-24T06:33:55+00:00",
"role": "assistant",
"contents": [{
"$type": "text",
"text": "恭喜你！你最近取得了**日语能力考试 N2 证书**。\n\n目前你的证书包括：\n\n1. **日语能力考试 N2 证书**（最近取得）\n2. **阿里云 ACP 认证：云计算工程师**（2023 年）\n3. **Oracle 认证 Java 程序员（OCP）**（2022 年）"
				}],
"messageId": "chatcmpl-E53ljo7x8f1Y7W6ZNseegQLF5vWOy"
			}]
		},
"session_id": "dddadf86-f9d8-4e0c-a651-ec1be0457fe9"
	}
}

"isExcluded": true,
"excludeReason": "Collapsed by ToolResultCompactionStrategy"

[Tool Calls]
GetNovel:
  - 清晨的雾把海港裹得像一封未拆的信……

agent.RunAsync(input, session)

CompactionTriggers.TokensExceed(1000)

minimumPreservedGroups: 3

"isExcluded": false

[Tool Calls]
GetNovel:
  - 清晨的雾把海港裹得像一封未拆的信……

response.Usage.TotalTokenCount
response.Usage.InputTokenCount
response.Usage.OutputTokenCount

stateBag
  └─ ToolResultCompactionStrategy
       └─ messagegroups

static (int StoredTokens, int IncludedTokens, int ExcludedTokens)
    GetCompactionTokenStats(
        JsonElement serializedSession,
        string propertyName)
{
    var storedTokens = 0;
    var includedTokens = 0;
    if (!serializedSession.TryGetProperty("stateBag", out var stateBag) ||
        !stateBag.TryGetProperty(propertyName, out var strategy) ||
        !strategy.TryGetProperty("messagegroups", out var messageGroups) ||
        messageGroups.ValueKind != JsonValueKind.Array)
    {
        return (0, 0, 0);
    }
    foreach (var group in messageGroups.EnumerateArray())
    {
        var tokenCount =
            group.TryGetProperty("tokenCount", out var tokenElement)
                ? tokenElement.GetInt32()
                : 0;
        var isExcluded =
            group.TryGetProperty("isExcluded", out var excludedElement) &&
            excludedElement.GetBoolean();
        storedTokens += tokenCount;
        if (!isExcluded)
        {
            includedTokens += tokenCount;
        }
    }
    return (
        StoredTokens: storedTokens,
        IncludedTokens: includedTokens,
        ExcludedTokens: storedTokens - includedTokens);
}

var stats = GetCompactionTokenStats(
    serializedSession,
    "ToolResultCompactionStrategy");
Console.WriteLine($"压缩索引中的全部分组 Token：{stats.StoredTokens}");
Console.WriteLine($"预计继续参与上下文的 Token：{stats.IncludedTokens}");
Console.WriteLine($"已排除分组的 Token：{stats.ExcludedTokens}");

Func<CompactionMessageGroup, string>

var compactionStrategy =
    new ToolResultCompactionStrategy(
        trigger: CompactionTriggers.TokensExceed(4000),
        minimumPreservedGroups: 6,
        target: CompactionTriggers.TokensBelow(2500))
    {
        ToolCallFormatter = group =>
        {
            var text =
                ToolResultCompactionStrategy
                    .DefaultToolCallFormatter(group);
            const int maxChars = 400;
            if (text.Length <= maxChars)
            {
                return text;
            }
            return text[..maxChars] +
                   "\n  - [旧工具结果已截断，仅保留前 400 个字符]";
        }
    };

target: CompactionTriggers.TokensBelow(2500)

调用工具：GetNovel
小说名称：《雾港来信》
调用结果：成功
内容主题：少年通过灯塔寻找失踪的母亲
完整正文：已省略

先压工具结果
    ↓
再总结旧对话
    ↓
最后截断低价值历史