用途:Provenance 留痕 Skill(太史阁)收集系统全链路操作日志,生成可追溯的执行证据链与向量索引,作为多智能体系统可观测性与安全审计的底座。
主要能力:由各官署在关键操作节点调用或通过事件总线异步推送,写入证据链;提供按 trace_id、时间窗、官署维度的检索接口,支撑审计面板与回滚定位。输入为 event(含 actor 官署名、action、target、timestamp、trace_id)与可选 payload(关联结构化产物引用);输出为按 trace_id 串联的 evidence_chain、用于语义检索的 vector_index 条目,以及按条件检索历史证据的 query_api 接口描述。
使用方式:由各官署在关键操作节点调用或经事件总线异步推送。复赛代码包真实入口为 scripts/run_provenance.py,执行等价于 core.runtime.AgentSession.run_stage("provenance"),调用 memory.taishige.TaiShiGeAgent.writeback,把全链路事件与四色卡片回流证据链,纯 Python 可离线。运行:python skills/provenance/scripts/run_provenance.py。产物位于 examples/snse_survey/provenance/(trace.jsonl + trace_summary.json,含每一条军机处派发与官署执行事件)。
依赖:Qdrant(向量存储,经 MCP 接入)、SQLite(结构化事件落地,本地兜底)、各官署的事件上报协议(统一 schema)。
失败处理:向量库写入失败时本地 SQLite 缓存事件,恢复后异步补写,不阻塞主流程;单条事件 schema 非法则记录并丢弃该条,不影响整链写入;检索超时返回最近一次成功快照并标注 stale。
适用场景与限制:适用于任何多 Agent 系统的审计与回放,契合 Agent Infra 赛道工程落地与运行验证及安全审计维度。资料未提供收费、价格、平台与效果等信息。