AgentbaseDocs
文档目录

经验与技能蒸馏演进

功能概述与核心场景

经验与技能演进(Memory Evolution,控制台页签为 经验与技能)是 Agentbase Memory(v2.10.0)实现智能体“从实战中自我学习与沉淀知识”的核心能力。在企业级客服与运维排障场景中,智能体每天执行大量多轮对话与工具调用(Tool Execution)。普通记忆(Memories)侧重记录“关于用户的客观事实与偏好”,而经验与技能蒸馏(Distillation)则从真实的任务执行轨迹与排障对话证据中,提炼出跨会话可复用的排障经验(Experience)与标准化操作技能(Skill)。

在 Agentbase 企业智能中台(69c6d1aa00062e6bb60)的标杆项目 **企业智能客服与知识中台**(enterprise-ai-hub-210)中,系统通过蒸馏流水线(调用 dashscope-prod 的 qwen-plus 与 text-embedding-v3)完成了两项典型生产蒸馏任务(dst_3e5b09f456c5d5c332507ec1dbe3eb6d 与 dst_adc2cfda21c940fb5d5e4a3263ae56f9):


核心概念与架构

经验与技能蒸馏从原始对话或工具轨迹中抽取候选知识,经过与存量知识的语义去重合并、模型自洽验证以及激活门槛校验(或人工二次确认),最终构建向量索引供在线检索与统一召回使用。

flowchart TB
    subgraph EvidenceInput["1. 执行证据提交 (POST /v1/memory/memories/distillations)"]
        InputPayload["对话与工具执行轨迹\nmessages (user / assistant / system / tool)\n归属范围: user / agent / project"]
        WaitMode{"执行模式 mode"}
        AsyncResp["mode = async\n持久化后立即返回 HTTP 202"]
        WaitResp["mode = wait (最长等待 20s)\n20s 内终态返回 200;超时返回 202 + waitTimedOut:true"]
    end

    subgraph DistillationPipeline["2. 经验与技能蒸馏 Pipeline (scenario=distillation)"]
        SkillExt["技能抽取 (skill_extraction)\n提炼触发条件、前置检查与可执行步骤"]
        SkillMerge["技能合并 (skill_merge)\n召回 Top 1-20 候选,按 mergeThreshold 去重合并"]
        ExpExt["经验抽取 (experience_extraction)\n提炼问题情境、根因洞察、成功做法与避坑指南"]
        ExpMerge["经验合并 (experience_merge)\n与存量 Experience 语义合并并累加独立会话证据"]
        Validate["模型质量验证 (validation)\n核验步骤自洽性、证据支持度与置信度评分"]
        KnowledgeOp["知识落库与索引投影 (knowledge_operation)\n生成不可变 Revision 与 1024维向量索引"]
    end

    subgraph GovernanceGate["3. 激活策略与二次确认门禁 (shadow -> active)"]
        ConfirmSwitch{"开启自进化二次确认?\nevolution.requireConfirmation"}
        AutoPolicy["自动激活策略校验 (evolution.activation)\n• minConfidence\n• minIndependentSessionsForAgent\n• requireVerifiedSuccess"]
        HumanReview["人工版本与确认 (/knowledge/reviews)\n查看 Diff & 来源 -> 在线编辑候选 -> 批准 (approve) / 拒绝 (reject)"]
        ShadowState["候选态 (shadow)\n继续积累多会话独立来源证据"]
        ActiveState["生效态 (active)\n正式对外提供检索与统一 Recall"]
    end

    InputPayload --> WaitMode
    WaitMode --> AsyncResp
    WaitMode --> WaitResp
    AsyncResp --> SkillExt
    WaitResp --> SkillExt
    SkillExt --> SkillMerge
    SkillMerge --> ExpExt
    ExpExt --> ExpMerge
    ExpMerge --> Validate
    Validate --> KnowledgeOp
    KnowledgeOp --> ConfirmSwitch
    ConfirmSwitch -->|"false (默认自动判断)"| AutoPolicy
    ConfirmSwitch -->|"true (强制人工审批)"| HumanReview
    AutoPolicy -->|"满足全部门槛"| ActiveState
    AutoPolicy -->|"暂未达标"| ShadowState
    HumanReview -->|"管理员批准"| ActiveState

Experience 与 Skill 的核心区别与属性表

对比维度经验(Experience)技能(Skill)
定位与形态可复用的情境洞察与避坑经验:记录“在什么场景下遇到什么问题、哪些做法有效、哪些做法会导致失败”。可复用的标准化操作步骤(SOP):记录“为达成某类明确目标,应按什么顺序执行哪些检查、命令或工具调用”。
核心结构化字段标题(title)、摘要(summary)、适用情境(context)、关键洞察/建议(insights / lesson)、置信度(confidence)、标签(tags)。名称(name)、描述(description)、触发条件(triggers)、有序步骤列表(steps,含动作说明与 inputs 参数模板)、验证标准(verification)。
**归属范围 (scope)**支持 user(用户级)、agent(智能体级,需指定 agentId)、project(项目全局级)。支持 user、agent、project;Agent 级技能要求满足跨多个独立会话(minIndependentSessionsForAgent)的复现验证才自动激活。
生命周期状态shadow(候选观察态,未达激活门槛或待人工确认) -> active(已激活生效) -> forgotten(已遗忘停止召回)。shadow -> active -> forgotten;且当某项经验依赖某个未批准的 Skill 版本时,会触发 skill_dependency_not_approved 阻塞保护。
检索与溯源接口GET /v1/memory/memories/experiences、POST .../experiences/search、GET .../experiences/{knowledgeId}/sourcesGET /v1/memory/memories/skills、POST .../skills/search、GET .../skills/{knowledgeId}/sources

功能入口与权限矩阵

控制台入口与 API 权限矩阵

控制台入口位于:**项目 enterprise-ai-hub-210 → 记忆(Memory) → 经验与技能** 页签。

功能模块控制台操作入口REST API 路径所需权限与认证要求
提交蒸馏任务手动蒸馏 区域 → 提交蒸馏POST /v1/memory/memories/distillationsmemories.write
查询与重放蒸馏任务蒸馏任务列表GET /v1/memory/memories/distillations、GET .../{distillationId}、POST .../{distillationId}/replaymemories.read / memories.write
查询与检索经验/技能经验 / 技能 列表与搜索框GET/POST /v1/memory/memories/experiences(/search)、GET/POST /v1/memory/memories/skills(/search)memories.read
查询知识来源证据展开经验/技能详情 → 来源证据GET /v1/memory/memories/experiences/{knowledgeId}/sources、/skills/{knowledgeId}/sourcesmemories.read
版本对比与人工二次确认版本与确认 子页签GET/PATCH /v1/memory/memories/knowledge/reviews/{reviewId}、POST .../approve、POST .../reject、POST .../{knowledgeId}/rollback必须使用具备项目管理权限的真实用户凭据(Console 会话或管理员 JWT)+ memories.write;普通无主体 API Key 不可代替人工审批人
停止复用(遗忘知识)经验/技能行尾 遗忘 按钮DELETE /v1/memory/memories/experiences/{knowledgeId}、/skills/{knowledgeId}memories.delete

功能详解与操作指南

1. 选择归属范围并提交执行证据蒸馏(POST /v1/memory/memories/distillations)

截图未公开:原图可能包含账号或资源标识。

界面参考:沿用已登记的历史截图,演示数据与当前项目可能不同;本次未重新取图。

# 提交工单 TK-20261022-001 的排障轨迹进行经验与技能蒸馏 (mode=wait)
curl -fsS -X POST "https://appbuild.oceanbase.com/v1/memory/memories/distillations" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  -H "X-Appwrite-Key: <APPBASE_API_KEY>" \
  -H "Idempotency-Key: distill-ticket-20261022-001" \
  -H "Content-Type: application/json" \
  --data '{
    "userId": "user_zhangwei_001",
    "agentId": "enterprise-support-agent",
    "scope": "user",
    "sessionId": "sess_ticket_TK_20261022_001",
    "runId": "run_9f8e7d6c5b4a",
    "mode": "wait",
    "verifiedSuccess": true,
    "messages": [
      {
        "role": "user",
        "content": "工单 TK-20261022-001:OceanBase Shared V2 表在写入 1024 维向量时报错 OB_ALLOCATE_MEMORY_FAILED (错误码 -4013),如何快速恢复?"
      },
      {
        "role": "tool",
        "content": "{\"tool\":\"sql_diagnostics\",\"output\":\"tenant_vector_memory_limit_percentage=10%, current usage=98.7%\"}"
      },
      {
        "role": "assistant",
        "content": "经排查为租户向量内存池配额不足。标准处置步骤:1. 查询 GV$OB_VECTOR_MEMORY_INFO 核实当前租户向量内存水位;2. 将 ob_vector_memory_limit_percentage 从 10 调升至 30;3. 重新触发增量向量索引构建并核验 schema.status=ready。已执行验证恢复成功。"
      }
    ]
  }' | jq .

2. 激活策略配置(evolution.activation)与 shadow -> active 生命周期

新蒸馏出的知识默认是否立即变为 active,由 记忆 → 配置 → 基础配置 中的 evolution 命名空间控制:

配置字段路径类型默认值 / 取值范围作用与激活判定逻辑
evolution.enabledbooleantrue是否启用项目级经验与技能演进能力。
evolution.autoDistillEnabledbooleanfalse是否在常规会话写入时自动触发后台知识蒸馏。
evolution.requireConfirmationbooleanfalse自进化二次确认开关。开启后,所有新增或合并更新的知识候选均保持 shadow 状态并生成待审批确认单(pending),必须由项目管理员人工批准后才跃迁为 active。
evolution.allowSingleVerifiedUserActivationbooleantrue在 user 作用域下,是否允许单次已验证成功的任务直接激活个人经验与技能。
evolution.activation.minConfidencenumber0.0 ~ 1.0(如 0.8)模型验证阶段给出的置信度评分必须不低于该阈值,否则留在 shadow 态。
evolution.activation.minIndependentSessionsForAgentinteger正整数(如 2 或 3)针对 agent 作用域知识,要求至少在 N 个**不同的独立 sessionId** 中被反复蒸馏印证后,才允许从 shadow 晋升为 active,防止单次偶发对话污染全局 Agent 技能库。
evolution.activation.requireVerifiedSuccessbooleantrue是否要求提交蒸馏的源任务必须带有明确的验证成功标记(verifiedSuccess: true)。

3. 版本对比、人工二次确认与回滚(版本与确认)

当开启 **自进化二次确认(evolution.requireConfirmation: true)** 或管理员主动发起知识修订时:

4. 检索经验与技能及溯源查询(agentbase-node-sdk@2.10.0)

应用可通过专用搜索接口或统一召回(recall)在智能体推理前检索匹配的 active 经验与技能,并随时核查其来源证据:

// 使用官方服务端 SDK: agentbase-node-sdk@2.10.0
import { Client, Memory } from 'agentbase-node-sdk';

const client = new Client()
    .setEndpoint('https://appbuild.oceanbase.com/v1')
    .setProject('enterprise-ai-hub-210')
    .setKey(process.env.APPBASE_API_KEY);

const memory = new Memory(client);

// 1. 语义检索已激活的排障经验 (Experiences)
const expResults = await memory.searchExperiences({
    userId: 'user_zhangwei_001',
    scope: 'user',
    query: 'OceanBase 向量索引构建内存不足 -4013 排障经验',
    limit: 5
});

// 2. 语义检索已激活的标准化技能 (Skills)
const skillResults = await memory.searchSkills({
    userId: 'user_zhangwei_001',
    scope: 'user',
    query: 'AI 网关 429 限流与故障转移配置步骤',
    limit: 5
});

// 3. 查询某条技能的不可变来源证据链 (Provenance Sources)
if (skillResults.items?.length > 0) {
    const provenance = await memory.listSkillSources({
        knowledgeId: skillResults.items[0].knowledgeId,
        limit: 20
    });
    console.log('支撑该技能的原始会话来源数:', provenance.total);
}

常见问题与排障(FAQ)

1. 为什么蒸馏任务状态显示 succeeded,但在 active 经验与技能列表中看不到新记录?

2. 在“版本与确认”中点击批准时,为什么按钮禁用并提示 projections_not_ready 或 source_set_changed?

3. 关闭“自进化二次确认(evolution.requireConfirmation)”开关后,之前积压的待确认候选会自动发布吗?


相关文档