Skip to content

v3.0.0

Latest

Choose a tag to compare

@sinabs sinabs released this 13 Nov 02:16
7893ba6

Yoke 3.0.0

给 Agent 装上工具和知识库,接入外部 MCP 服务,并重新开放子 Agent。每多开放一种能力,权限边界就多一块,所以这一版的重点是在不放松边界的前提下把能力装上去。

行为变化

  • 模型能看到的工具从 4 个变成 14 个。 新增 calculate、get_current_time、list_my_notes、retrieve,以及子 Agent 相关的 agent_spawn、agent_send、agent_list、task_output、task_cancel、task_list。联网、文件、shell 和读类的记忆与会话工具仍然被拒绝,子 Agent 同样拿不到;ToolPermissionTests、SubagentTests 用精确集合守着主 Agent 和各子 Agent 能看到的工具。
  • 子 Agent 重新开放。 代码里声明 summarizer,工作区文件声明 kb-researcher;代码和工作区文件声明同一个 id 时,AgentScope 静默以文件为准,现在改为启动即失败,扫描以工作区目录里实际存在的文件为准。
  • MCP 默认一个都不接。 配置 yoke.mcp.servers 才会接入;配置了但连不上,应用启动失败。
  • 向量检索默认关闭。 没配 yoke.knowledge.embedding 的模型名和密钥时,检索只用关键词,应用照常启动。

新功能

  • 工具:calculate 用手写递归下降解析器(不用脚本引擎,限制长度、嵌套深度、数字位数,除零明确报错);get_current_time 带时区;list_my_notes 的当前用户由 RuntimeContext 按类型注入,不进工具 Schema,模型看不到也伪造不了,取不到就拒绝。
  • 知识库检索 retrieve:检索放在应用层的 RetrievePort 后面(knowledge 包不依赖框架),做成一个工具、只走一条通道。关键词(BM25,永远可用)、向量(带最低相似度)、RRF 融合三层,两路并发,一路失败退回另一路,全部失败才报错;应用就绪后在后台预建向量索引。
  • 引用编号:每条资料带稳定的片段编号(文档名加正文哈希前 8 位),多次检索不会重复,重启和重新部署后同一个编号仍指向同一段正文。
  • 向量化客户端:OpenAI 兼容的 /embeddings,以及火山方舟多模态的 /embeddings/multimodal(一条文本一次请求),由 yoke.knowledge.embedding.protocol 选择;local 环境接方舟,复用 ARK_API_KEY。
  • MCP:只允许 HTTP 传输(sse、streamable-http),stdio 在配置绑定阶段就拒绝;只注册服务端声明了 readOnlyHint 的工具;工具名与已有工具或 Harness 内置工具重名时启动失败;连接按相反顺序释放,报错里不带地址中的令牌。

修复

  • 知识文档切片时,围栏代码块里以 # 开头的行不再被当成标题。
  • 两篇同名知识文档不再悄悄互相覆盖,加载时直接失败。
  • BM25 的片段长度只算一次,不再每次查询重算。

其他

  • 包结构整理:检索实现在 knowledge.retrieve,向量化客户端在 knowledge.embed,Passage、UserContext 在 model,SharedToolkit 在 tool。
  • 版本号 2.0.0 → 3.0.0;清理 IDEA 警告,README 中英同步。
  • 测试 332 个,全部通过。

已知限制

  • 流式接口的请求体里没有用户标识,所有调用方归属 default 用户,共用同一份笔记和长期记忆。
  • 第三方 MCP 服务(TLS、鉴权失败、断线重连)和 OpenAI 兼容的向量服务只用本地假服务测过。