Update nexus wiki content

wiki/sources/data-consolidation-agent.md

@@ -2,47 +2,50 @@
 title: "Data Consolidation Agent"
 type: source
 tags: []
-date: 2026-04-20
+date: 2026-04-30
 ---
 
 ## Source File
-- [[raw/Agent/agency-agents/specialized/data-consolidation-agent.md]]
+- [[Agent/agency-agents/specialized/data-consolidation-agent.md]]
 
 ## Summary（用中文描述）
-- 核心主题：AI Agent 将分散的销售提取数据整合为实时报告仪表盘
-- 问题域：销售团队缺乏统一视图查看各地区、销售代表和管道的实时业绩数据
-- 方法/机制：并行多维度查询 → 聚合计算派生指标 → Dashboard 友好 JSON 结构化输出 → 含时间戳的实时刷新机制
-- 结论/价值：< 1 秒仪表盘加载、60 秒自动刷新、零数据不一致
+- 核心主题：AI Agent 将分散的销售数据聚合为实时仪表盘报告，支持地域、代表、管道多维度视图
+- 问题域：销售团队需要统一的实时数据视图，替代手动 Excel 汇总，消除数据孤岛
+- 方法/机制：接收仪表盘或地域报告请求 → 并行查询所有数据维度 → 聚合计算派生指标 → 结构化为 Dashboard-friendly JSON 输出 → 含生成时间戳用于陈旧度检测
+- 结论/价值：实现 < 1 秒仪表盘加载、60 秒自动刷新、零数据不一致，支持 MTD/YTD/Year End 多视图
 
 ## Key Claims（用中文描述）
-- Data Consolidation Agent 通过并行查询所有数据维度，将原始销售指标聚合为可操作的实时仪表盘
-- Agent 始终使用最新数据（按 type 取最新的 metric_date），确保数据时效性
-- 达成率计算：revenue / quota * 100，并处理除零错误
-- 按地区聚合数据，提供区域级别可见性，整合管道数据形成完整销售视图
-- 支持 MTD/YTD/Year End 多时间维度视图
+- Data Consolidation Agent 始终查询每个类型最新 metric_date 的数据，保证所有视图使用最新指标
+- 达成率（Attainment）计算公式为 revenue / quota * 100，需处理除零边界情况
+- 管道数据（Pipeline）与销售指标合并，提供从线索到成交的完整数据图景
+- 仪表盘交付物包含 6 类报告：地域绩效汇总、个人代表绩效、管道快照、6 个月趋势数据、Top 5 绩效代表、地域详细报告
+- 地域报告包含该地域内所有代表及其最新指标，以及最近 50 条指标历史记录
+- 成功指标：仪表盘加载 < 1 秒、报告每 60 秒自动刷新、100% 代表和活跃地域覆盖、详情视图与汇总视图零数据不一致
 
 ## Key Quotes
-> "You are the **Data Consolidation Agent** — a strategic data synthesizer who transforms raw sales metrics into actionable, real-time dashboards. You see the big picture and surface insights that drive decisions." — Agent 身份定义
+> "You are the **Data Consolidation Agent** — a strategic data synthesizer who transforms raw sales metrics into actionable, real-time dashboards." — Agent 身份定义，战略定位为"数据综合者"而非数据搬运工
 
-> "Zero data inconsistencies between detail and summary views" — 数据质量核心承诺
+> "Calculate attainment accurately: revenue / quota * 100, handle division by zero" — 核心计算规则，除零处理是防止报告崩溃的关键
+
+> "Include pipeline data: merge lead pipeline with sales metrics for full picture" — 管道数据合并策略，提供从线索到成交的全链路视图
 
 ## Key Concepts
-- [[Dashboard Report]]：含地区业绩摘要（YTD/MTD）、代表排名、管道快照、6 个月趋势、Top 5 业绩者
-- [[Territory Report]]：地区级深度分析，含该地区所有代表及其指标及最近 50 条历史记录
-- [[Sales Attainment]]：达成率 = revenue / quota * 100，处理除零错误
-- [[Pipeline Snapshot]]：按阶段聚合（数量/价值/加权价值）的管道数据快照
-- [[Metric Aggregation]]：多维度并行查询后聚合计算派生指标的工作流
+- [[Territory-Performance]]：按地域聚合的销售绩效指标汇总，含 YTD/MTD 收入、达成率、代表人数
+- [[Quota-Attainment]]：销售配额达成率，计算公式：revenue / quota * 100，处理除零边界
+- [[Pipeline-Metrics]]：销售管道各阶段（数量、价值、加权价值）的快照数据
+- [[MTD-YTD]]：Month-to-Date / Year-to-Date 两种时间维度汇总视图
+- [[Dashboard-Friendly-JSON]]：结构化 JSON 输出格式，专为仪表盘消费设计，含时间戳元数据
+- [[Trend-Analysis]]：过去 6 个月的趋势数据分析
 
 ## Key Entities
-- [[Sales Data Extraction Agent]]：上游数据提取 Agent，为 Data Consolidation Agent 提供原始销售指标数据
-- [[Report Distribution Agent]]：下游分发 Agent，接收整合后的仪表盘数据进行分发推送
+- [[Data-Consolidation-Agent]]：The Agency Specialized 部门的数据综合专家 Agent，专注于销售数据聚合与实时仪表盘
+- [[Sales-Data-Extraction-Agent]]：上游数据提取 Agent，监控文件系统并从 Excel 中提取销售指标，为本 Agent 提供数据源
 
 ## Connections
-- [[Sales Data Extraction Agent]] → produces → raw sales metrics
-- [[Data Consolidation Agent]] ← consumes ← [[Sales Data Extraction Agent]]
-- [[Report Distribution Agent]] ← consumes ← [[Data Consolidation Agent]] (Dashboard Report / Territory Report)
-- [[Sales Pipeline Analyst]] ← shares pipeline data sources with → [[Data Consolidation Agent]]
-- [[Sales Coach Agent]] ← consumes ← [[Data Consolidation Agent]] (Top 5 performers)
+- [[Sales-Data-Extraction-Agent]] ← upstream_data ← [[Data-Consolidation-Agent]]（数据提取后由本 Agent 进行聚合与展示）
+- [[Report-Distribution-Agent]] ← downstream_report ← [[Data-Consolidation-Agent]]（聚合后的报告传递给分发 Agent）
+- [[Sales-Pipeline-Analyst]] ← pipeline_insights ← [[Data-Consolidation-Agent]]（管道快照数据为管道分析提供输入）
+- [[Sales-Account-Strategist]] ← territory_data ← [[Data-Consolidation-Agent]]（地域绩效数据支持账户策略决策）
 
 ## Contradictions
-- 无已知内容冲突。该 Agent 与 [[Sales Pipeline Analyst]] 共享数据源但职责互补（分析 vs 整合），与 [[Report Distribution Agent]] 构成顺序管道关系。
+- 无已知内容冲突。Data Consolidation Agent 与 [[Sales-Data-Extraction-Agent]] 为上下游关系（非竞争），与 [[Report-Distribution-Agent]] 协同完成数据到用户的完整链路。