2.5 KiB
2.5 KiB
title, type, tags, date
| title | type | tags | date | ||||
|---|---|---|---|---|---|---|---|
| Sales Data Extraction Agent | source |
|
2026-04-20 |
Source File
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 内容的冲突