Auto-sync: 2026-04-21 00:02

wiki/sources/sales-data-extraction-agent.md

@@ -0,0 +1,43 @@
+---
+title: "Sales Data Extraction Agent"
+type: source
+tags: [agent, sales, data-extraction, the-agency]
+date: 2026-04-20
+---
+
+## Source File
+- [[raw/Agent/agency-agents/specialized/sales-data-extraction-agent.md]]
+
+## Summary
+Sales Data Extraction Agent 是 The Agency 项目中的专业化 AI 智能体，专注于监控 Excel 文件目录并提取关键销售指标（MTD、YTD、Year End）。通过文件系统监视器实时检测新文件或更新文件，解析 Excel 工作簿，灵活映射列名（revenue/sales/total_sales、units/qty/quantity），并自动计算配额完成率。数据通过 PostgreSQL 事务原子性持久化，确保完整审计追踪。
+
+## Key Claims
+- 文件监视器通过忽略临时 Excel 锁文件（`~$`）避免处理不完整文件
+- 灵活列名匹配机制（fuzzy column mapping）处理不同 Excel 格式的变体
+- 通过 email 或全名匹配销售代表，未匹配行记录 warning 并跳过
+- 从 sheet 名称自动检测指标类型（MTD、YTD、Year End），并带有 sensible defaults
+- 所有导入操作记录：文件名、处理行数、失败行数、时间戳
+- 处理时间目标：每文件 < 5 秒
+
+## Key Quotes
+> "You are the Sales Data Extraction Agent — an intelligent data pipeline specialist who monitors, parses, and extracts sales metrics from Excel files in real time. You are meticulous, accurate, and never drop a data point."
+
+## Key Concepts
+- [[Filesystem Watcher]]：监视目录中 `.xlsx` 和 `.xls` 文件的机制，忽略 `~$` 临时锁文件
+- [[Fuzzy Column Mapping]]：通过模糊匹配列名处理不同 Excel 格式（revenue/sales/total_sales、units/qty/quantity）
+- [[Metric Type Detection]]：从 sheet 名称自动识别 MTD、YTD、Year End 指标类型
+- [[Quota Attainment]]：当 quota 和 revenue 同时存在时自动计算配额完成率
+- [[Audit Trail]]：每条 metric 记录源文件，实现完整数据溯源
+
+## Key Entities
+- [[PostgreSQL]]：数据持久化目标数据库，支持事务原子性
+- [[The Agency]]：开源 AI 智能体集合项目，本智能体为其 specialized 部门成员
+
+## Connections
+- [[Pipeline Analyst]] ← shares_domain ← [[Sales Data Extraction Agent]]（均属 The Agency 销售相关 Agent）
+- [[PostgreSQL]] ← stores ← [[Sales Data Extraction Agent]]（数据持久化目标）
+- [[Filesystem Watcher]] ← implements ← [[Sales Data Extraction Agent]]（文件监控机制）
+- [[Data Pipeline]] ← is_type ← [[Sales Data Extraction Agent]]（核心职责是数据管道）
+
+## Contradictions
+- 未发现与现有 wiki 内容的冲突