@atrib/摘要
MCP 服务器显示 summarize 用于 Atrib 可核查的动作层的工具。 它使用一个OpenAI相容的LLM来合成一个跨越N记录的叙述.
在npm上贬值. summarize 没有后续形状 recall 动词 (D164电话:读取的表面返回已核实的材料而调用者合成. 工具通过别名窗口挂起 .
关闭消费方的认知空间 原始伴侣 atrib-trace: track 返回所声明的关联路径; 总结返回所选记录上被合成的含义. 两者都读取同一个本地镜像,包括可选的 _local 侧车.
安装
pnpm add @atrib/summarize
验证本地建筑 pnpm --filter @atrib/summarize test。 。 。 .
工具
mcp__atrib-summarize__summarize({
context_id?: string, // 32-hex trace; summarize all records in it
record_hashes?: string[], // explicit list; unioned with context_id
focus?: string, // optional steering for the synthesis
max_records?: number, // cap on records fed to LLM (default 50, max 200)
model?: string // override model from env
})
→ {
narrative: string | null,
cited_record_hashes: string[],
records_summarized: number,
records_skipped: number, // beyond max_records
records_with_sidecar: number, // had semantic content
records_without_sidecar: number, // legacy bare records, impoverished input
model_used: string | null,
warnings: string[]
}
LLM 提供者
OpenAI-相容的HTTP. NVIDIA NIM 默认为 qwen/qwen3.5-397b-a17b。通过掩体或每个呼叫覆盖 model 输入 :
| 新闻 var | 默认 |
|---|---|
ATRIB_SUMMARIZE_API_KEY | 返回到提供者内/缓存 |
ATRIB_SUMMARIZE_BASE_URL | https://integrate.api.nvidia.com/v1 |
ATRIB_SUMMARIZE_MODEL | qwen/qwen3.5-397b-a17b |
ATRIB_SUMMARIZE_MAX_TOKENS | 4000 |
ATRIB_SUMMARIZE_TEMPERATURE | 0.3 |
ATRIB_SUMMARIZE_TIMEOUT_MS | 120000 |
提供者掩体/缓存回落 :
| 提供方 URL 包含 | 新闻 var | 快取文件 |
|---|---|---|
integrate.api.nvidia.com | NVIDIA_API_KEY | ~/.atrib/secrets/nvidia-api-key |
api.cerebras.ai | CEREBRAS_API_KEY | ~/.atrib/secrets/cerebras-api-key |
cloudflare.com | CLOUDFLARE_API_KEY | ~/.atrib/secrets/cloudflare-api-key |
没有 API 密钥, 工具将返回每个 第5.8节 优雅的降级合同.
读取
与 @atrib/trace: 每一个 *.jsonl 镜像下方 ~/.atrib/records/ (通过 ATRIB_RECORDS_DIR) (中文(简体) ). 容忍留下的光记录和当前信封形状.
总结为: _local.content 首先,在需要时,从遗留的包装或OpenInference侧车场获得相同的内容形状。 OpenInform 内容可以将跨类型/名称,工具/代理/模型,即时标识符和模板,输入/输出,使用,成本,分数,元数据,以及专题等添加到合成快取. 这些田地保持本地侧车载荷/ D108级;它们不被提升到已签名的协议字段.
当一个记录缺少可用的本地内容(legacy accord)时,提示包括一个标记告诉LLM输入贫穷,只有事件 类型+密码元数据可用,因此合成可以诚实地说明漏洞. 产出报告 records_with_sidecar 财务报告和审定财务报表 records_without_sidecar 算来算来算来算来算来算来算去的.
行为
- 选择数字 :
record_hashes记录 - 匹配 -context_id,被贬损. - 绑架:按时间顺序递升排序,然后取
max_records。浮出水面了. - 真实输入标记: 即时标记记录中的每行记录缺少语义内容;系统即时指示LLM不要发明语义.
- 仅在 LLM 呼叫时访问网络: 存储已读是本地的, 但所选的记录内容会被发送到所配置的 LLM 端点(默认情况下是 NVIDIA NIM) 来生成叙述. 这个读取原始的 发送镜像内容的机器。 点
ATRIB_SUMMARIZE_BASE_URL在自动托管或本地模式中保存记录内容。 测试使用与其余工作空间相同的FORBIDDEN HOSTS后卫来防止固定泄漏. - 没有重试 LLM 失败: 显示错误
warnings并返回无效的叙述。 呼叫者决定是否用较小的重试max_records或不同的型号. - 仪器 D084级 水面6级:每通电话都会写一个每通电话jsonl条目
~/.atrib/state/read-primitives/calls.jsonl用于统一环闭分析器. 包括elapsed_ms覆盖全部 LLM 往返加码errored: truelLM 失败路径。 静默失败者 第5.8节; 仪器从不阻断摘要响应.ATRIB_READ_PRIMITIVES_LOG覆盖测试的默认路径.
接线
添加到您的 MCP 主机配置 :
{
"atrib-summarize": {
"command": "npx",
"args": ["-y", "@atrib/summarize"],
"env": {
"ATRIB_SUMMARIZE_MODEL": "qwen/qwen3.5-397b-a17b"
}
}
}
从单列波检出, 使用 "command": "node" 与
"args": ["/path/to/atrib-summarize/dist/main.js"] 换句话说 API 密钥可以
生活在主机内或上面的缓存文件中。 不写入秘密值
输入共享的 MCP 配置 .
与证明/召回名称的关系D164电话(中文(简体) )
summarize 没有后续形状 recall 动词. recall 返回时
经核实的材料; 调用器合成. npm 软件包不设条件
替换指针; 工具通过别名窗口挂起.
状态
出版并维护. 单位测试涵盖记录选择(通过散列,按上下文,结合,缺失-skip)和退化路径(没有输入,没有API密钥). 对真实的LLM进行集成测试的门是后面的 ATRIB_SUMMARIZE_API_KEY 而不是在CI运行.
伴侣 atrib-trace 是结构原始的;它们共同关闭了认知循环的消费方.
部分笔记
atrib是可核查剂动作的开放式协议. 每个动作都变成一个签名的连锁记录,任何人都可以对照一个公开的默克勒日志进行验证,没有操作员可以信任. 这个包是一个切入点。 见 全包家族 编辑 协议光谱。 。 。 .