多 Agent 数据分析图表工具分层暴露方案

. 项目背景

在多 Agent 数据分析程序中。项目内包含多种数据分析图表工具，例如折线图、柱状图、饼图、散点图、热力图、箱线图、桑基图等。

如果将所有图表工具全部平铺暴露给大模型，每个工具都包含完整的 description、参数 schema 和调用示例。会带来明显问题：

• 大量占用大模型；
• 相似图表工具之间容易误选；
• 工具列表 后维护成本高；话说回来，
• 模型推理链路变长。调用稳定性下降，
• 无法清晰区分“图表意图判断”和“具体工具执行”。怎么说呢，

至于使用者痛点。1️⃣ 上下文膨胀导致查询效率低下；2️⃣ 图表误选导致业务决策错误；3️⃣ 因为功能 维护成本激增。

. 主要项目难点

工具数量多导致上下文膨胀

若直接将所有工具暴露给大模型。 必需携带说明、参数及字段约束，占用大量 token。说起来，再看使用者痛点，查询时长拉长，响应慢。老实说，

相似图表之间容易混淆

折线/面积/多折线、柱状/条形/堆叠柱状等易被误选。再看使用者痛点，业务报表不精准，引发误判。

使用者意图需要结合数据结构判断

仅凭文本难以准确定位，需要结合时间字段、类别字段和数值字段等数据结构信息。使用者痛点的观点是，频繁澄清需求，体验差。

分类成本和准确率需要平衡

纯规则快但泛化差，纯 LLM 成本高且延迟大。再看使用者痛点，程序响应慢且费用高昂。话说回来，

工具 Schema 需要按需加载

完整参数只在确定具体工具后才加载。以减少上下文占用，从使用者痛点来看，请求延迟提高，但整体可控。

渲染工具需要统一治理

统一入口 render_chart 可以统一校验与错误处理。至于使用者痛点，渲染失败导致 请求，影响体验。

. 常用方法架构

"级联分类器 + 多层 Tools 动态加载"

级联分类器 → 多层 Tools 动态加载
├─ 使用者请求 + 数据字段 Profile → 级联分类器
├─ 获得 chart_family → 加载该组候选工具
├─ 选择具体 chart_tool → 按需加载完整 schema
├─ 调用 render_chart → 路由到底层真实 renderer

. 图表分类设计