fix(orchestration,loop): 子代理现在真的收到任务(P0)+ 工具白名单 + 超时可配(裁决 02.4.2/02.4.1/02.4.4)
执行方案阶段 2 · P2-1。**02.4.2 是最伤的一条 P0**:`spawntool` 从不填 `AgentSpec.Context`、
`scheduler` 把 nil 交给 loop ⇒ 子代理模型上下文 = 角色 system + 记忆召回 + **0 条消息**,
goal/attach_info/data 一个字都到不了模型(此前测试用 mock adapter 恒答固定文本,测不出)。
- **02.4.2**:新增 `taskContext/taskUserMessage`(`spec.go`)把 **goal 正文 + attach_info + data
渲染成同一条 user 消息**(`[任务目标]/[附加信息]/[任务数据]` 独立段落);`Spawn()` 设
`Context: taskContext(spec)`;**system 只保留角色指令**,任务绝不进 system。
真断言(捕获请求体的 adapter + 真 loop/agent):首请求恰好 **1 条 user 消息**、同时含 goal 与
attach_info,且**所有 system 消息不含 goal 文本**。
- **02.4.1**:`AgentSpec.ToolWhitelist`(nil/空 = 继承全量);schema 增 `tool_whitelist`
(顶层 + 每 task 条目,task 未带时继承批次级);`scheduler.run()` 经 ctx 传递 +
`scopedRunner` 派生;`loop/options.go` **纯增量(+75 / −0)**:`WithToolWhitelist`/
`ToolWhitelistFrom` + `(*Loop).WithToolWhitelist` 派生副本(浅拷贝仅替换 `hooks.CallAdmit`,
链式保留原钩子),名单外调用否决为**软结果**回灌模型。
- **02.4.4**:`SUBAGENT_TIMEOUT_SEC`(默认 600)入 `internal/config` + `.env.example`;
优先级 = 按调用 `timeout_seconds`(1s–24h 校验)> `WithSpawnTimeout`(生产由 cfg 填充)>
调度器 `PerAgentTimeout`(`wire*.go` 仍是 10min 常量,未动);迟到 span 续根由测试锁定。
验证:**全树 `go build`/`go vet`/`go test ./... -count=1` = 58 包 ok / 0 FAIL**;
`GOOS=linux/amd64` + `GOOS=darwin/arm64` 交叉编译绿;前端 `tsc --noEmit` + `npm run build` 绿;
本批文件全部 ≤500 行、函数 ≤80 行。
变异验证(四条,均带还原证明):① `Context` 改回 `cloneMessages(spec.Context)` →
「1 条 user 消息」断言 FAIL(`user messages = 0`,即 P0 症状);② `WithToolWhitelist` 原样返回 →
显式白名单测试 FAIL(`alpha executed 1 times despite not being whitelisted`);
③ `subCtx` 改回全局默认 → 3 个超时测试 FAIL;④ `foldSpanFinish` 丢掉 `SpanFinished` →
迟到 span 状态断言 FAIL。
⚠️ 已知缺口(**登记,未假装已解决**):① 无真实模型端到端(全部捕获请求体 mock);
② 白名单**只挡执行、不过滤工具广告面**(模型仍能看见未列工具,调用即被拒并拿到可读原因;
过滤需改 `loop/request.go`);③ **迟到 span 的"新一轮已开始"窗口未修**(`loop/flow.go` 的
`StartRound` 会整体替换 `graphs[session]` ⇒ 新轮开始后迟到的 span 仍落进新轮图;需按轮键控图,
属后续);④ per-role 超时覆盖未实现(需 persona 旋钮管道)。
This commit is contained in:
1 parent
6e7ec56f9a
commit
7e7f53bb41
15 files changed
+974
-50
No files matched your search
@@ -1,8 +1,10 @@
|
||||
package orchestration
|
||||
|
||||
import (
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/model"
|
||||
)
|
||||
@@ -67,6 +69,13 @@ type AgentSpec struct {
|
||||
ParentSession string
|
||||
// Data carries an optional structured payload for the caller's use.
|
||||
Data any
|
||||
// ToolWhitelist 限定该子代理可执行的工具集合(design/05 §7 裁决 02.4.1):
|
||||
// 缺省(nil/空)=继承主 agent 的全量工具集;显式列出=只放行所列工具,
|
||||
// 名单外的调用在工具循环层被否决并以软结果回灌。它只收缩能力面,绝不扩展。
|
||||
ToolWhitelist []string
|
||||
// Timeout 覆盖该子代理的运行时限(design/05 §7 裁决 02.4.4 的按调用覆盖)。
|
||||
// 非正时回退到调度器的 Options.PerAgentTimeout。
|
||||
Timeout time.Duration
|
||||
}
|
||||
|
||||
// Progress event names published on the agent-to-agent bus via the Scheduler's
|
||||
@@ -159,3 +168,74 @@ func compactText(s string, n int) string {
|
||||
}
|
||||
return string(r[:n]) + "…"
|
||||
}
|
||||
|
||||
// taskContext 返回子代理的隔离上下文:调用方显式给出的消息在前(深拷贝),
|
||||
// 任务本身作为最后一条 user 消息注入。裁决 2026-10-04:goal 正文 +
|
||||
// attach_info/data 作为同一条 user 消息内的独立段落;system 只承载角色与
|
||||
// 安全约束(循环前置的 agent 指令),绝不把任务塞进 system——否则子代理
|
||||
// 的模型上下文里没有任何一轮用户消息,任务一个字都到不了模型。
|
||||
func taskContext(spec AgentSpec) []model.Message {
|
||||
return append(cloneMessages(spec.Context), taskUserMessage(spec))
|
||||
}
|
||||
|
||||
// taskUserMessage 把任务渲染为一条 user 消息(裁决 2026-10-04):
|
||||
// [任务目标] 段固定存在(Spawn 已保证 goal 非空),[附加信息] 与
|
||||
// [任务数据] 段仅在对应字段非空时出现;Data 以 JSON 编码,编码失败时
|
||||
// 整段跳过——宁可少一段噪声,不注入一段坏文本。
|
||||
func taskUserMessage(spec AgentSpec) model.Message {
|
||||
var b strings.Builder
|
||||
b.WriteString("[任务目标]\n")
|
||||
b.WriteString(spec.Goal)
|
||||
if spec.AttachInfo != "" {
|
||||
b.WriteString("\n\n[附加信息]\n")
|
||||
b.WriteString(spec.AttachInfo)
|
||||
}
|
||||
if spec.Data != nil {
|
||||
if data, err := json.Marshal(spec.Data); err == nil {
|
||||
b.WriteString("\n\n[任务数据]\n")
|
||||
b.Write(data)
|
||||
}
|
||||
}
|
||||
return model.TextMessage(model.RoleUser, b.String())
|
||||
}
|
||||
|
||||
// cloneStrings 返回 names 的拷贝,使子代理持有的白名单与调用方的切片
|
||||
// 不共享内存。nil 进 nil 出。
|
||||
func cloneStrings(names []string) []string {
|
||||
if names == nil {
|
||||
return nil
|
||||
}
|
||||
return append([]string(nil), names...)
|
||||
}
|
||||
|
||||
// stringListArg 读取字符串数组参数:容忍缺失/非数组/非字符串元素,
|
||||
// 逐项去空白并丢弃空项,使名单恒为「显式列出的工具名」。缺失返回 nil(全开)。
|
||||
func stringListArg(m map[string]any, key string) []string {
|
||||
raw, ok := m[key].([]any)
|
||||
if !ok {
|
||||
return nil
|
||||
}
|
||||
out := make([]string, 0, len(raw))
|
||||
for _, v := range raw {
|
||||
s, _ := v.(string)
|
||||
if s = strings.TrimSpace(s); s != "" {
|
||||
out = append(out, s)
|
||||
}
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// timeoutArg 读取 timeout_seconds 按调用覆盖(JSON 解码为 float64):
|
||||
// 缺失/非数/越界(<1s 或 >24h)视为未提供并沿用 dft;越界值不静默夹取——
|
||||
// 回退到默认而不是替模型猜一个邻近值。
|
||||
func timeoutArg(m map[string]any, key string, dft time.Duration) time.Duration {
|
||||
f, ok := m[key].(float64)
|
||||
if !ok {
|
||||
return dft
|
||||
}
|
||||
sec := int64(f)
|
||||
if sec < minSpawnTimeoutSeconds || sec > maxSpawnTimeoutSeconds {
|
||||
return dft
|
||||
}
|
||||
return time.Duration(sec) * time.Second
|
||||
}
|
||||
Reference in new issue
Block a user