Files
api_health/agent/infra/history.js
T
lik 9825ac376f refactor(agent): 抽出 guard/history/reference 共享模块并补测试
- guard.js:流式输出护栏,跨 chunk 禁用词拦截并在句末截断超长回复

- history.js:tool 结果入历史前截断、历史按完整轮次裁剪,避免断链与上下文挤占

- reference.js:服务项目/协议改为可读文本渲染,替代裸 JSON 误导模型

- 临时脚本 test_restricted_backend.mjs 转为 test/restricted_fs_backend.test.js
2026-11-01 11:42:11 +08:00

62 lines
2.1 KiB
JavaScript

import { HumanMessage } from "@langchain/core/messages";
import logger from "../../utils/logger.js";
/**
* 对话历史管理(主 agent 与管理 agent 共用)
*
* 两个约束同时存在:
* 1. tool 结果必须并入历史,否则下一轮会出现 tool_calls 缺少 tool 结果的断链;
* 2. tool 结果往往是网页正文/数据库全量字段,原样保留会挤掉真正的人机对话,
* 导致 agent 忘记用户说过的医院、日期,表现为重复提问。
* 因此 tool 结果入历史前统一截断,只保留开头关键信息。
*/
// tool 结果保留的字符数,超出部分以标记代替
export const TOOL_RESULT_MAX_CHARS = 300;
export function truncateToolResult(content, max = TOOL_RESULT_MAX_CHARS) {
if (typeof content !== "string") return content;
if (content.length <= max) return content;
return `${content.slice(0, max)}…(原结果 ${content.length} 字,已截断)`;
}
// 截断后并入历史,返回实际写入的消息
export function appendToolMessage(messages, msg, max = TOOL_RESULT_MAX_CHARS) {
if (msg && typeof msg.content === "string") {
msg.content = truncateToolResult(msg.content, max);
}
messages.push(msg);
return msg;
}
/**
* 按字符数裁剪历史:只以 HumanMessage 为界从头部删除完整轮次,
* 避免切断 AI(tool_calls) -> Tool 的链式结构;永远保留最新一轮。
* 返回裁剪后的新数组,由调用方赋值。
*/
export function trimHistory(messages, maxChars) {
const size = (msgs) => msgs.reduce((sum, m) => sum + (m.text?.length ?? 0), 0);
if (size(messages) <= maxChars) {
return messages;
}
const starts = [];
messages.forEach((m, i) => {
if (HumanMessage.isInstance(m)) starts.push(i);
});
if (starts.length < 2) {
return messages;
}
let cut = 0;
for (let i = 0; i < starts.length - 1; i++) {
cut = starts[i + 1];
if (size(messages.slice(cut)) <= maxChars) {
break;
}
}
const trimmed = messages.slice(cut);
logger.info(`History trimmed to ${trimmed.length} messages, ${size(trimmed)} chars`);
return trimmed;
}