Update nexus wiki content

wiki/sources/report-distribution-agent.md

@@ -1,46 +1,49 @@
----
-title: "Report Distribution Agent"
-type: source
-tags: []
-date: 2026-04-25
----
-
-## Source File
-- [[raw/Agent/agency-agents/specialized/report-distribution-agent.md]]
-
-## Summary（用中文描述）
-- 核心主题：销售报告自动分发 AI Agent，专为 STGCRM 系统设计
-- 问题域：企业销售团队需要按时、按区域将合并报告精准送达对应业务员和管理层
-- 方法/机制：基于区域参数路由 + SMTP 邮件发送 + 全程分发日志审计
-- 结论/价值：实现 99%+ 定时送达率，零错误区域分发，完全可追溯的分发历史
-
-## Key Claims（用中文描述）
-- Report Distribution Agent 通过区域路由确保每个业务员仅接收其负责区域的数据
-- 管理员和经理接收公司级汇总报告，而非区域明细
-- 每次分发尝试均记录状态（sent/failed）和时间戳，支撑合规审计
-- 每日报告于工作日 8:00 AM 发送，每周汇总于周一 7:00 AM 发送
-- 发送失败时记录错误并继续分发，不中断其他接收者
-
-## Key Quotes
-> "You are the Report Distribution Agent — a reliable communications coordinator who ensures the right reports reach the right people at the right time." — Agent 身份定义
-> "Territory-based routing: reps only receive reports for their assigned territory" — 核心路由规则
-> "Graceful failures: log errors per recipient, continue distributing to others" — 容错设计
-
-## Key Concepts
-- [[Territory Routing]]：基于销售区域参数进行路由分发，每个业务员仅接收其分配区域的数据报告
-- [[SMTP Transport]]：通过 SMTP 协议传输 HTML 格式邮件报告的底层技术机制
-- [[Audit Trail]]：分发日志记录，含接收人、区域、状态、时间戳，支持合规查询
-- [[Scheduled Distribution]]：定时任务触发机制（工作日 8:00 AM / 周一 7:00 AM），支持手动按需分发
-
-## Key Entities
-- [[Data Consolidation Agent]]：为 Report Distribution Agent 提供区域报告和公司汇总报告的数据来源
-- [[STGCRM]]：该 Agent 所服务的企业 CRM 系统品牌，提供区域分配数据和邮件路由规则
-
-## Connections
-- [[Data Consolidation Agent]] ← feeds_data ← [[Report Distribution Agent]]
-- [[Report Distribution Agent]] ← distributes_to ← [[Sales Representative]]
-- [[Report Distribution Agent]] ← audit_trail ← [[Compliance System]]
-
-## Contradictions
-- 与 [[Sales Data Extraction Agent]]：Sales Data Extraction Agent 负责原始销售数据提取，Report Distribution Agent 负责报告分发；两者在数据管道中为上下游关系，不存在冲突
-
+---
+title: "Report Distribution Agent"
+type: source
+tags: [agent, sales, automation, distribution, reporting, stgcrm]
+sources: []
+last_updated: 2026-05-01
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/report-distribution-agent.md]]
+
+## Summary（用中文描述）
+- 核心主题：销售报告自动化分发 Agent，基于区域参数将整合后的销售报告精准发送给对应业务员
+- 问题域：销售报告的手动分发效率低、易出错、无法追踪；不同区域业务员只需看自己区域的数据
+- 方法/机制：基于区域（Territory）的路由规则 + SMTP 邮件发送 + 分布审计日志；支持定时调度（每日/每周）和手动触发
+- 结论/价值：实现 99%+ 的定时投递率，所有分发操作可审计，失败发送 5 分钟内告警，零错误区域报告
+
+## Key Claims（用中文描述）
+- Report Distribution Agent 基于区域参数将报告精准路由到对应业务员，确保业务员只收到其负责区域的数据
+- 管理员和经理收到公司级别的汇总报告（Company-wide Roll-ups）
+- 每次分发操作均记录状态（sent/failed）和时间戳，形成可查询的分发历史
+- 每日区域报告在周一至周五 8:00 AM 发送；每周汇总在每周一 7:00 AM 发送
+- 分发失败时记录错误信息，继续向其他收件人发送，绝不静默丢弃报告
+- Agent 与 Data Consolidation Agent 协作生成报告内容
+
+## Key Quotes
+> "You are the Report Distribution Agent — a reliable communications coordinator who ensures the right reports reach the right people at the right time. You are punctual, organized, and meticulous about delivery confirmation." — Agent 身份定义
+> "Territory-based routing: reps only receive reports for their assigned territory" — 核心路由原则
+> "Graceful failures: log errors per recipient, continue distributing to others" — 失败处理策略
+
+## Key Concepts
+- [[Territory-Based Routing]]：基于销售区域的报告路由策略，确保业务员只收到其Assigned Territory 相关数据
+- [[Scheduled Distribution]]：定时调度分发，支持每日（工作日早8点）和每周（周一早7点）自动化发送
+- [[Audit Trail]]：所有分发操作均记录收件人、区域、状态、时间戳，支持合规查询
+- [[HTML Email Reports]]：HTML 格式的区域报告含业务员绩效表格；公司汇总含区域对比表格
+- [[SMTP Transport]]：通过 SMTP 协议发送邮件
+
+## Key Entities
+- [[Data Consolidation Agent]]：负责生成整合后的区域报告或公司汇总报告，Report Distribution Agent 调用其能力
+- [[Sales Representative]]：最终收件人，基于Assigned Territory 接收对应区域报告
+- [[STGCRM]]：品牌标识，HTML 报告样式遵循其 Branding 规范
+
+## Connections
+- [[Data Consolidation Agent]] ← generates report content for ← [[Report Distribution Agent]]
+- [[Report Distribution Agent]] ← delivers reports to ← [[Sales Representative]]
+- [[Report Distribution Agent]] ← writes distribution log to ← [[Audit Trail]]
+
+## Contradictions
+- （暂无发现冲突）