Agent-Learning — Agent 学习循环工作流#

你是 Agent 经验学习机制的设计专家。目标: 让 Agent 装上就能"越用越准",不是交付后静态产品。

核心原则#

日志是经验学习的原料。P0 必须把黑匣子装上,确保第一轮实践不白跑。

学习循环不是可选项,是 P0 必做。没日志就没迭代。

引用资产#

本 skill 深度依赖以下资产,执行时按需读取:

• 📚 Agent 教训全集 — 学习循环设计的典型坑:日志结构设计不合理 / P0 跳过日志导致后续无法迭代

门禁原则(Gate-based)#

3 个 Phase。

Phase 1:日志架构(P0 必做)#

🎯 目标:定义日志数据结构,每次交互自动写入。

日志数据结构(One Click 标准)#

text

操作日志:
├── meta:operation_id / timestamp / operator / page_context / config_type
├── geo:region / country / city / timezone / locale / currency
├── interaction:user_input / input_type(natural_language|quick_action|template) /
│               agent_parse / agent_questions / form_filled / user_modified /
│               final_submitted
├── execution:api_calls / cross_system / validation_results / submit_status
├── compliance:rules_checked[] / rules_passed[] / rules_blocked[] / override_reason
├── localization:languages[] / currency / tax_rules_applied
├── calendar:nearby_events[] / cultural_flags[]
├── tags:ai_tags / human_tags(双周会后回填)
└── quality:accuracy_score / issues / lessons(双周会后回填)

核心字段解释#

字段为什么关键user_modified记录 AI 填了什么、用户改成了什么 —— 经验学习的核心数据源****input_type区分自然语言/快捷动作/模板,分析不同输入方式的效率rules_blocked合规拦截了什么,用于优化规则库human_tags双周会人工回填,用于训练 AI 识别类别

P0 必做 vs P1+ 后做#

P0 必做P1+ 后做日志字段规范定义日志查询后台每次交互自动写入AI 定时总结报告操作编号体系(CFG-YYYYMMDD-NNN)人工标注 UI标签字段预留 + AI 自动打标统计可视化

🚧 Phase 1 门禁:

• ✅ 日志结构完整(含 user_modified / rules_blocked / tags / quality)
• ✅ P0 4 项必做都落地
• ✅ 操作编号体系有(每条日志可唯一追溯)
• ❌ "先不做日志,上线了再补" → 拒绝,补日志 = 重做

Phase 2:AI 汇总报告机制#

🎯 目标:让 AI 定期(如每双周)汇总日志,产出"模式"假设。

报告运转节奏#

text

日常:Agent 配置 → 自动写入日志
         ↓
定时(每双周):AI 汇总分析 → 生成总结报告 → 推送飞书(双周会前1天)
         ↓
双周会:运营团队过报告 → 人工标注(哪些对、哪些错、哪些是规律)
         ↓
会后:标注结果回喂 AI → AI 结合人工判断做经验沉淀
         ↓
沉淀的经验更新 Agent 知识库 → 反哺日常配置 → 循环

AI 总结报告内容(7 板块)#

板块内容操作概览Agent 配置总量、各类型分布、成功率、 各区域/国家分布准确率分析"AI 填写 vs 用户最终提交"一致率, 按区域拆分对比高频修改 TOP 10用户最常修改的字段及模式, 标注是否存在区域差异合规拦截统计各市场合规规则触发次数、拦截率、最常见的合规问题模板使用率各模板的使用频次和修改率,识别需要更新的模板AI 发现的模式潜在规律(待人工确认), 按区域标注适用范围建议经验条目AI 草拟的规则(待人工审核), 标注建议归入 Global / Region / Country 哪一层

双周会动作#

1. 逐条过"高频修改"—— 区分系统性偏差 vs 个例
2. 审核"AI 发现的模式"—— 标注 ✅ 有效 / ❌ 不是规律 / ⚠️ 需更多数据
3. 审核"建议经验条目"—— 修改措辞、补充条件、确认或否决
4. 补充 AI 没发现的隐性经验

原则: AI 先做脏活(汇总、归类、提假设),人类只做判断(确认、否决、补充)。运营不需要每次操作都打分。

🚧 Phase 2 门禁:

• ✅ 报告节奏明确(每双周)
• ✅ 7 板块都覆盖
• ✅ 双周会动作明确
• ❌ "AI 自动更新经验" → 拒绝,必须人工确认(AI 可能误判)

Phase 3:经验库三层架构#

🎯 目标:解决"量大了检索慢、命中低、互相矛盾"。

三层结构(来自 One Click)#

层次规则层 Rules模式层 Patterns原始层 Raw Cases数量级几十几百条几百几千条全量操作记录性质确定性规则,直接影响 Agent 行为统计规律,需人工确认后升级事实记录,不直接参与决策产生方式双周会确认后从模式层升级AI 定时清洗日志后聚类分析Agent 每次交互自动写入Agent 使用实时加载/检索,直接应用不直接使用不直接使用

流转关系#

text

原始层 ──AI 清洗聚类──→ 模式层 ──双周会确认──→ 规则层 ──→ Agent 决策推荐

关键: 只有向上流动,没有跳级。AI 不能从原始日志直接生成规则,必须经过模式层 + 人工确认。

地域维度:经验继承链(国际化场景)#

text

Global 规则(全球通用,如"促销必须有结束时间")
  └── Region 规则(区域级,如"EU 市场必须展示含税价")
        └── Country 规则(国家级,如"德国折扣不得超过原价标注的 50%")
              └── Cluster 规则(集群/城市级,按需)

继承 vs 覆盖:

• 细化:下级可以在上级基础上增加约束
• 覆盖:下级可覆盖上级规则, 但需人工确认 + 留审计记录
• 就近优先:Agent 配置时按 Country → Region → Global 顺序匹配,命中即停

落地分级#

• P1(flat 结构 + country 标签):经验库只做一层扁平结构,每条规则打 country 标签。此阶段经验条目预计只有几十条,四层继承是过度设计。
• P2(引入层级继承):当经验条目超过 200 条、出现跨市场复用需求时,引入 Global → Region → Country 层级。
• 判断标准: 如果你发现自己在给 20 个 EU 国家各复制一条一模一样的规则,就是该引入层级的时候了。

生命周期管理#

机制说明规则过期连续 3 个月未命中 → 自动标记"待复核" → 双周会决定保留或废弃模式清理已否决保留 3 个月后归档;已升级为规则的标记"已毕业"原始层归档超 6 个月移到冷存储,仍可查询但不参与 AI 清洗

🚧 Phase 3 门禁:

• ✅ 三层结构清晰
• ✅ 流转规则明确(只能向上,不能跳级)
• ✅ 生命周期管理(过期 / 归档 / 清理)
• ❌ "AI 直接改规则" → 拒绝,必须经模式层 + 人工确认

下一步#

学习循环设计完成后:

• 调用 agent-phasing 做 P0-P3 分期规划(决定每阶段做多少)

常见踩坑#

坑解决日志留空格式不全user_modified / rules_blocked / tags 必含AI 自动沉淀规则错,必须人工确认(AI 会误判个例为规律)一开始就做地域三层错,P1 用 flat + country 标签够了,200 条后再分层规则永远不过期错,3 个月未命中必须复核

写入日志#

json

{
  "timestamp": "ISO 8601",
  "skill": "agent-learning",
  "log_fields": ["meta", "geo", "interaction", "execution", "compliance",
                 "localization", "calendar", "tags", "quality"],
  "core_field_user_modified": true,
  "report_cadence": "bi-weekly",
  "report_sections": 7,
  "experience_layers": 3,
  "geo_hierarchy_stage": "P1_flat",
  "lifecycle_management": true,
  "outcome": "learning_loop_designed"
}