feat(trace,loop,orchestration): memory/guardrail/orchestration 真 span + 参数摘要脱敏 + Guardrail 输出侧异步(裁决 11.4.2/11.4.3/13.4.1)
- 11.4.2:三类节点首次真进图 —— memory.recall/memory.write(loop/memory.go 召回与写入点)、 guardrail.input/output(流式主路径两侧 + agent.RunStep 静音路径)、orchestration.spawn (scheduler 每次派发/收束);新增 trace.ChildSpan 让不持有 Tracer 的叶子包也能开子 span - 11.4.3(设计先行,规格先写进 design/19 §1.1):tool 节点参数摘要 —— 放行表 argValueKeys + trace.IsSecretKey 统一判据(密钥类键不给值)+ 单值 80 rune / ≤24 条 + 出图前再清洗; 前端 NodeDetail 新增「参数摘要」区,未放行键显示「值未展示」 - 13.4.1:流式主路径输出侧护栏改后台 goroutine(脱离 context、30s 兜底、不阻塞回合), 输入侧仍在模型调用前同步拦下;拦截闭环到 guardrail 节点 + 审计事件 - 拆文件:scheduler.go 加 span 后 546 行 → 编排 span 助手拆出 scheduler_spans.go(回到 492) - 契约:无帧名/事件形状变化;graph_update 节点 props 新增**可选**键(tool args_keys/args_summary、 guardrail action/allow/elapsed_ms、memory action/scope/hits/…、orchestration subagent/persona), 文档同步由主会话统一落
This commit is contained in:
1 parent
0dfad675b8
commit
b99268d019
14 files changed
+1396
-42
No files matched your search
@@ -39,6 +39,17 @@ func safeSpanProps(rec SpanRecord) map[string]any {
|
||||
|
||||
// safePropKeys are the span prop keys forwarded to a node's props.
|
||||
//
|
||||
// 键分五类,全部非敏感(值仍会逐个经 redactValue 清洗):
|
||||
//
|
||||
// - 既有:stop_reason / step / error / error_kind / tool / persona;
|
||||
// - tool 参数摘要(裁决 11.4.3):args_keys(全量参数名)、args_summary
|
||||
// (仅放行键的值,长度已在 loop/spanlog.go 侧截断),密钥类键的值绝不在其中;
|
||||
// - guardrail(裁决 11.4.2):allow(裁决结果)、action(检查名)、elapsed_ms(耗时);
|
||||
// - memory(裁决 11.4.2):hits / count / failed(命中、写入与失败条数)、
|
||||
// bytes(注入块字节数)、scope / action(记忆作用域与操作名)—— 只记元数据,
|
||||
// 不含任何记忆正文;
|
||||
// - orchestration(裁决 11.4.2):subagent(被派发的子代理 id)。
|
||||
//
|
||||
// persona 是子代理分支根节点上的「目标角色 id」:orchestration/scheduler.go 只在
|
||||
// subagent_spawn 显式指定角色时才设置它,且该 id 必须先通过角色注册表校验
|
||||
// (ErrUnknownPersona 会拒绝未注册的 id,orchestration/persona.go),因此它是注册表里
|
||||
@@ -46,7 +57,13 @@ func safeSpanProps(rec SpanRecord) map[string]any {
|
||||
// 与会话材料对外可见。它是 Docs/api-client.md §3.5(v0.47)对客户端的承诺
|
||||
// (design/22 §8-2:让流程图显示「这个子代理是以谁的身份在替班」),漏出白名单就会被
|
||||
// safeSpanProps 静默丢掉。未指定角色派发时该键不存在,符合 v0.47「纯增量」的约定。
|
||||
var safePropKeys = []string{"stop_reason", "step", "error", "error_kind", "tool", "persona"}
|
||||
var safePropKeys = []string{
|
||||
"stop_reason", "step", "error", "error_kind", "tool", "persona",
|
||||
"args_keys", "args_summary",
|
||||
"allow", "action", "elapsed_ms",
|
||||
"hits", "count", "failed", "bytes", "scope",
|
||||
"subagent",
|
||||
}
|
||||
|
||||
// summarize renders an arbitrary value as a short text string for a prop summary.
|
||||
func summarize(v any) string {
|
||||
|
||||
Reference in new issue
Block a user