Agent Group Map

6+1 Agent 分组 × Sub-Agent 清单 × 每个 Action 的 API 可用性审计

2026-03-19 · Based on 1,133 backend API endpoints
72
Actions 已有 API ✅
11
Actions 部分可用 ⚠️
23
Actions 需要新建 ❌
15
Sub-Agents 总计
✅ API 已有，可直接封装为 Tool ⚠️ 部分可用，需要扩展 ❌ 不存在，需要新建 API 🆕 新 Agent 能力，非传统 API
Architecture Hierarchy
🏢 Multi-Store Orchestrator (多店编排层)
│
🎯 Supervisor Agent (每店一个)
┌──────────┬──────────┬──────────┬──────────┬──────────┐
⚙️ 日常运维
📈 获客增长
❤️ 客户留存
📦 选品库存
👥 人才标准化
🛡️ 合规风控
Appt · Finance · SOP
Campaign · Referral
Lifecycle · Loyalty
Inventory · Supplier
Schedule · Training · Perf
Labor · Tax · License

⚙️ 日常运维组 — Daily Operations

3 Sub-Agents · 31 Actions −
⚡ Appointment → Payment Agent P0 MVP
处理从 Service 完成到支付结算的完整流程。覆盖标准结算（SOP）和非标场景（LLM）。
Action (Tool)调用的 API说明
✅get_appointment_detailsGET /api/appointments/:id获取预约详情、服务项目、客户信息
✅update_appointment_statusPUT /api/appointments/:id/status更新状态：completed, no-show 等
✅calculate_checkoutGET /api/checkout/calculate计算总价、税、折扣、小费
✅create_payment_intentPOST /api/checkout/payment-intentStripe 支付意向（PCI-compliant）
✅process_split_paymentPOST /api/checkout/split多种支付方式分账
✅apply_discountPOST /api/discounts/apply应用折扣/优惠券
✅apply_gift_cardPOST /api/gift-cards/redeem抵扣礼品卡余额
✅generate_invoicePOST /api/invoices生成发票/收据
✅process_refundPOST /api/refunds全额/部分退款
✅record_manual_paymentPOST /api/checkout/manual现金/支票等手动记录
✅handle_walk_inPOST /api/appointments (walk-in flag)Walk-in 快速创建预约
⚠️suggest_checkout_action需要新逻辑：结合客户画像 + 活动 + 库存LLM 生成结算建议（非标场景）
💰 Finance & Tips Agent P0 MVP
Day-End 对账、现金管理、小费分配、异常检测。95% 规则引擎，5% LLM 解释。
Action (Tool)调用的 API说明
✅get_daily_transactionsGET /api/closeout/summary获取今日所有交易
✅get_cash_drawer_statusGET /api/cash-drawer/current当前钱箱状态
✅open_cash_drawerPOST /api/cash-drawer/openDay Start 开启钱箱
✅close_cash_drawerPOST /api/cash-drawer/closeDay End 关闭钱箱
✅get_tip_summaryGET /api/payroll/tips今日小费汇总
✅calculate_tip_distributionGET /api/payroll/tip-distribution按店铺规则计算分配
✅get_closeout_reportGET /api/closeout/report日结报告
✅get_financial_kpisGET /api/reports/finance/*营收/均单/利润 KPI
❌reconcile_pos_vs_payment新建：POS 记录 × Stripe 记录自动匹配核心对账逻辑，需对接 Stripe webhook 数据
❌detect_payment_anomalies新建：规则引擎检测异常（金额不匹配、重复支付等）规则引擎，不是 LLM
🆕explain_anomalyLLM：基于异常数据生成自然语言解释Sonnet 调用，给店长看的解释文本
🆕generate_daily_narrativeLLM：生成今日经营叙述性总结"今日营收$2840，较上周同期+12%..."
📋 Day Start / Day End SOP Engine P0 MVP
标准 Checklist 流程，无 LLM。异常情况 escalate 给对应 Agent。
Action (Tool)调用的 API说明
✅get_today_scheduleGET /api/schedules/daily今日排班
✅check_employee_attendanceGET /api/employees/attendance在岗员工列表
✅get_today_appointmentsGET /api/appointments?date=today今日预约列表
✅open_cash_drawerPOST /api/cash-drawer/open复用 Finance Agent tool
❌run_day_start_checklist新建：结构化 checklist 引擎 + 状态追踪SOP 引擎核心：checklist 定义 + 进度追踪
❌run_day_end_checklist新建：触发所有 day-end 子流程的编排器按顺序触发：对账 → 小费 → 钱箱 → 日报
⚠️check_inventory_levels部分：有产品目录，无库存水位追踪Day Start 快速检查关键耗材

📈 获客增长组 — Customer Acquisition

2 Sub-Agents · 16 Actions −
📣 Marketing Campaign Agent P1
基于门店状态和客户数据，生成并执行营销活动。LLM 负责方案生成，API 负责执行。
Action (Tool)调用的 API说明
✅list_campaignsGET /api/marketing/campaigns当前活动列表
✅create_campaignPOST /api/marketing/campaigns创建新营销活动
✅get_audience_segmentGET /api/marketing/segments目标受众筛选
✅send_email_campaignPOST /api/promotion/email/send发送邮件（SES/Resend）
✅send_sms_campaignPOST /api/promotion/sms/send发送短信（Twilio/Telnyx）
✅create_discountPOST /api/discounts创建折扣码
✅get_campaign_analyticsGET /api/marketing/analytics活动效果数据
✅ab_test_campaignPOST /api/promotion/email/ab-testA/B 测试
🆕generate_campaign_planLLM：基于门店数据 + 客户画像生成完整营销方案含受众、渠道、内容、预算建议
❌track_campaign_attribution新建：追踪哪个活动带来了哪个预约Campaign → Booking 归因链路
🤝 Referral Agent P2
推荐奖励管理：生成推荐链接、追踪转化、自动发放奖励。
Action (Tool)调用的 API说明
✅generate_referral_linkPOST /api/referrals/link生成客户专属推荐链接
✅track_referral_conversionGET /api/referrals/conversions推荐转化追踪
⚠️auto_reward_referrer部分：积分系统存在，但无自动触发逻辑推荐成功 → 自动给推荐人发奖励
❌get_referral_leaderboard新建：推荐排行榜（谁带来最多新客）激励高推荐率客户
🆕suggest_referral_incentiveLLM：根据客户画像建议个性化推荐奖励VIP → 高奖励，新客 → 标准奖励
❌multi_tier_referral新建：多级推荐（A推B, B推C, A也得奖励）后期考虑

❤️ 客户留存组 — Customer Retention

2 Sub-Agents · 18 Actions −
👤 Customer Lifecycle Agent P1
管理客户全生命周期：新客 → 活跃 → 流失风险 → 挽回。LLM 预测行为、生成个性化触达。
Action (Tool)调用的 API说明
✅get_customer_profileGET /api/guests/:id完整客户档案
✅get_visit_historyGET /api/guests/:id/appointments历史到访记录
✅get_preferred_timeGET /api/guests/:id/preferences (ML)ML 推断的偏好时间
✅update_customer_tagsPUT /api/guests/:id/tagsVIP / 流失风险 / 高价值 标签
✅send_personalized_messagePOST /api/promotion/email/send发送个性化邮件/短信
❌calculate_churn_risk新建：基于到访频率/间隔/消费趋势预测流失风险规则+ML 混合模型
❌calculate_customer_health_score新建：综合得分（频次 × 消费 × 活跃度 × 推荐）类似 NPS 但更细颗粒
❌trigger_winback_flow新建：自动触发挽回流程（流失30天/60天/90天）时间触发 + 内容个性化
🆕generate_followup_messageLLM：基于客户历史生成个性化跟进内容"Lisa，上次做的渐变甲效果怎么样？"
⚠️request_review部分：有短信能力，无结构化 review 请求流服务后自动请求 Google/Yelp 评价
🏆 Loyalty Agent P1
积分、会员等级、套餐、礼品卡的智能管理。规则引擎为主，LLM 建议升级策略。
Action (Tool)调用的 API说明
✅get_points_balanceGET /api/loyalty/points/:guestId积分余额
✅earn_pointsPOST /api/loyalty/points/earn消费积分
✅redeem_pointsPOST /api/loyalty/points/redeem兑换积分
✅get_subscription_statusGET /api/subscriptions/:guestId会员订阅状态
✅manage_gift_cardsGET/POST /api/gift-cards/*礼品卡 CRUD
✅get_package_usageGET /api/packages/:id/usage套餐使用进度
❌auto_tier_upgrade新建：基于消费自动升降会员等级消费满$500 → 自动升金卡
🆕suggest_loyalty_actionLLM：建议个性化忠诚度策略"这位客户即将流失，建议发放20%折扣券"

📦 选品与库存组 — Product & Inventory

1 Sub-Agent · 8 Actions −
📦 Inventory Agent P2
库存水位监控、服务耗材追踪、自动补货建议。目前后端几乎没有库存相关 API，需要从头建设。
Action (Tool)调用的 API说明
✅list_productsGET /api/services (产品目录已有)服务和零售产品目录
❌get_stock_levels新建：产品库存水位查询新表：product_inventory
❌track_usage_per_service新建：每次服务消耗的产品量Gel Manicure = 2ml gel + 1 file + ...
❌set_reorder_threshold新建：设置补货阈值低于阈值 → 自动告警
❌create_purchase_order新建：采购单管理向供应商下单
❌receive_shipment新建：入库确认收货后更新库存
🆕predict_usageLLM/ML：基于历史消耗预测未来需求"下周预计需要 50ml Gel Polish Red"
🆕suggest_reorderLLM：生成智能补货建议考虑供应商交期、价格、当前库存

👥 人才与标准化组 — Talent & Standardization

3 Sub-Agents · 21 Actions −
🗓️ Schedule Agent P1
智能排班：需求预测 + 多约束优化 + 临时调配。连锁扩张的核心能力之一。
Action (Tool)调用的 API说明
✅get_weekly_scheduleGET /api/schedules/weekly周排班表
✅update_employee_schedulePUT /api/schedules/:employeeId修改个人排班
✅bulk_update_schedulesPUT /api/schedules/bulk批量排班更新
✅get_employee_availabilityGET /api/employee-availability员工可用性（含偏好）
✅apply_schedule_templatePOST /api/schedules/template/apply应用排班模版
❌predict_demand新建：基于历史客流预测下周/下月需求ML 模型：weekday × hour × season
❌auto_generate_schedule新建：基于需求 + 可用性自动生成排班约束求解 / LLM 辅助
❌handle_callout新建：员工请假 → 自动寻找替代查可用员工 → 推送请求 → 确认
🎓 Training & Quality Agent P2
SOP 合规监控、服务质量评分、新员工培训路径。帮助连锁标准化复制。
Action (Tool)调用的 API说明
✅get_employee_performanceGET /api/reports/employee-performance均单、推销率、返客率
✅get_employee_targetsGET /api/employees/:id/targets个人目标完成率
✅get_leaderboardGET /api/reports/leaderboard员工排行榜
❌track_sop_compliance新建：监控"Do As Suggested"接受率 per employee从 agent_decisions 表聚合
❌get_quality_score新建：综合质量得分（评价 + 返客 + 投诉 + SOP合规）加权评分模型
❌create_training_path新建：新员工培训 SOP + 进度追踪Day1: 收银流程 → Day3: 服务流程 → ...
🆕generate_coaching_insightLLM：基于绩效趋势生成个性化辅导建议"小李的推销率在下降，建议..."
📊 Performance Agent P2
员工绩效趋势分析、目标设定辅助、薪酬/提成优化建议。
Action (Tool)调用的 API说明
✅get_commission_historyGET /api/payroll/commission/:employeeId提成历史
✅get_working_hoursGET /api/reports/working-hours工时统计
✅get_revenue_per_employeeGET /api/reports/employee-revenue人效
✅export_payrollGET /api/payroll/export薪酬导出（CSV/PDF）
❌detect_performance_trend新建：绩效趋势告警（连续下降 → 预警）规则引擎：3周连续下降 → alert
🆕suggest_target_adjustmentLLM：基于历史和同行对比建议目标调整"建议将小王月目标从$8K调到$10K"

🛡️ 合规与风控组 — Compliance & Risk

1 Sub-Agent · 8 Actions −
🛡️ Compliance Agent P2
劳动法合规、税务申报辅助、执照管理。企业级客户的硬需求。大部分是规则引擎。
Action (Tool)调用的 API说明
✅get_working_hoursGET /api/reports/working-hours复用：工时数据（检测加班）
✅get_tip_recordsGET /api/payroll/tips复用：小费记录（IRS 申报）
✅get_audit_logGET /api/admin/audit操作审计日志
❌check_overtime_compliance新建：按州法律检测加班违规NY: >40h/week, CA: >8h/day 不同规则
❌check_break_compliance新建：检测是否满足法定休息时间CA: 5h+ 需30min break
❌track_license_expiration新建：美容执照到期提醒新表：employee_licenses
❌generate_tip_tax_report新建：IRS 8027 表格数据准备大型雇主必须申报 tip income
🆕explain_compliance_issueLLM：用自然语言解释合规问题和修正建议"小张本周已工作42小时，超出NY法定..."

🏢 多店编排层 — Multi-Store Orchestrator

Supervisor 之上 · 10 Actions −
🎯 Supervisor Agent (每店一个) P0 MVP
聚合本店所有 Sub-Agent 汇报，跨域决策，升级问题给 Owner。每 2 小时或按需批量处理。
Action (Tool)调用的 API说明
⚠️get_store_realtime_status部分：各模块 API 拼接，需要统一聚合层当前在忙/空闲、队列长度、今日进度
✅get_store_kpisGET /api/reports/business/dashboard门店 KPI 仪表盘
❌get_agent_reports新建：从 agent_events 聚合各 Agent 汇报Supervisor 的核心输入
❌evaluate_escalation新建：规则 + LLM 判断是否需要通知 Ownerover-escalate 比漏报安全
🆕generate_owner_briefingLLM：生成 Owner 日报/周报营收、异常、建议，自然语言叙述
🏢 Multi-Store Orchestrator P3
跨店协调层。当连锁达到 5+ 家店时变成刚需。在所有 Supervisor 之上。
Action (Tool)调用的 API说明
✅list_storesGET /api/centers门店列表
⚠️get_cross_store_report部分：单店报表存在，缺横向对比多店 KPI 并排对比
❌redirect_booking新建：A店满 → 推荐B店，含空闲时段跨店预约引导
❌transfer_employee新建：跨店借调员工（含排班同步）C店缺人 → 从A店借调 2 天
❌clone_store_config新建：复制门店配置到新店排班模版 + 服务菜单 + 定价 + SOP
🆕benchmark_storesLLM：跨店横向分析，找出最佳实践和落后店"Store B 的返客率比其他店低 15%..."
🆕generate_expansion_planLLM：新店开业方案（选址建议、初始配置、人员需求）基于现有店铺数据推算
Missing APIs Summary — 需要新建的 23 个 API

按 Agent 优先级排序。P0 的缺失 API 必须在 MVP 前补上。

APIDescriptionPriority
❌reconcile_pos_vs_paymentPOS 记录 × Stripe 记录自动匹配对账P0
❌detect_payment_anomalies规则引擎检测支付异常P0
❌run_day_start_checklist结构化 checklist 引擎 + 状态追踪P0
❌run_day_end_checklistDay-end 子流程编排器P0
❌get_agent_reports从 agent_events 聚合各 Agent 汇报P0
❌evaluate_escalation升级决策引擎（规则 + LLM）P0
❌calculate_churn_risk客户流失风险预测P1
❌calculate_customer_health_score客户健康度综合评分P1
❌trigger_winback_flow自动触发流失客户挽回流程P1
❌track_campaign_attribution营销活动 → 预约归因P1
❌predict_demand客流需求预测（排班依据）P1
❌auto_generate_schedule智能自动排班P1
❌handle_callout员工请假自动调配P1
❌auto_tier_upgrade会员等级自动升降P1
❌track_sop_compliance员工 SOP 执行率监控P2
❌get_quality_score服务质量综合得分P2
❌create_training_path新员工培训路径管理P2
❌detect_performance_trend绩效趋势告警P2
❌check_overtime_compliance加班合规检测（按州）P2
❌check_break_compliance休息时间合规检测P2
❌track_license_expiration美容执照到期管理P2
❌generate_tip_tax_reportIRS 8027 小费税务报表P2
❌get_stock_levels + 5 more完整库存管理系统（6 个 API）P2
❌redirect_booking跨店预约引导P3
❌transfer_employee跨店员工借调P3
❌clone_store_config新店配置克隆P3

★ Key Takeaway

现有 API 已经覆盖了 68% 的 Agent Actions。

P0 MVP 只需要新建 6 个 API（对账、异常检测、checklist 引擎、Agent 汇报聚合、升级决策）。 这些都是纯后端逻辑，不涉及新的外部集成。

最大的 API 缺口在库存管理（需要从头建）和合规检测（需要各州法律规则库）——但这些都是 P2/P3，不阻塞 MVP。

优先级建议：先用现有 72 个 API 把日常运维组跑通，再逐步补缺。