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
@@ -42,8 +42,10 @@ var secretKeyNames = map[string]bool{
|
||||
// secretKeySuffixes catch prefixed variants such as openai_api_key.
|
||||
var secretKeySuffixes = []string{"_api_key", "_access_token", "_auth_token", "_secret", "_token"}
|
||||
|
||||
// isSecretKey reports whether a map key names a credential.
|
||||
func isSecretKey(key string) bool {
|
||||
// IsSecretKey 报告某个 map 键是否命名了一个凭据。它是「密钥类键」的唯一判据:
|
||||
// 出图前的清洗与参数摘要的生产者(loop/spanlog.go,裁决 11.4.3「密钥类参数
|
||||
// 一律不显示值」)共用它,因此生产侧与最后一道防线不可能判得不一致。
|
||||
func IsSecretKey(key string) bool {
|
||||
k := strings.NewReplacer("-", "_", ".", "_").Replace(strings.ToLower(strings.TrimSpace(key)))
|
||||
if secretKeyNames[k] {
|
||||
return true
|
||||
@@ -80,7 +82,7 @@ func RedactEvent(ev Event) Event {
|
||||
func redactProps(props map[string]any) map[string]any {
|
||||
out := make(map[string]any, len(props))
|
||||
for k, v := range props {
|
||||
if isSecretKey(k) {
|
||||
if IsSecretKey(k) {
|
||||
out[k] = redactedMarker
|
||||
continue
|
||||
}
|
||||
@@ -135,6 +137,18 @@ func redactValue(v any) any {
|
||||
out[i] = RedactText(item)
|
||||
}
|
||||
return out
|
||||
case map[string]string:
|
||||
// 参数摘要以 map[string]string 生产时也必须逐键清洗,
|
||||
// 否则密钥会绕过键名规则原样出图(裁决 11.4.3 红线)。
|
||||
out := make(map[string]any, len(x))
|
||||
for k, v := range x {
|
||||
if IsSecretKey(k) {
|
||||
out[k] = redactedMarker
|
||||
continue
|
||||
}
|
||||
out[k] = RedactText(v)
|
||||
}
|
||||
return out
|
||||
default:
|
||||
return v
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user