用途:为多智能体系统提供全链路可观测与安全审计的留痕能力,适合软件开发工程师与信息安全分析师在构建 Agent 系统时挂载使用。
主要能力:由各官署在关键操作节点调用,或通过事件总线异步推送事件写入证据链;提供按 trace_id、时间窗、官署维度的检索接口,支撑审计面板与回滚定位。输入为 event(含 actor 官署名、action、target、timestamp、trace_id)与可选 payload(结构化产物引用)。输出为 evidence_chain(按 trace_id 串联的证据链)、vector_index(语义检索向量索引条目)和 query_api(条件检索历史证据的接口描述)。
依赖:Qdrant(向量存储,经 MCP 接入)、SQLite(结构化事件落地,本地兜底)、各官署统一 schema 的事件上报协议。
失败处理:向量库写入失败时先本地 SQLite 缓存事件,恢复后异步补写,不阻塞主流程;单条事件 schema 非法时记录并丢弃该条,不影响整链写入;检索超时返回最近一次成功快照并标注 stale。
运行:真实入口为 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。
限制:未提供收费、价格、平台与性能指标等信息;具体部署细节以实际环境为准。