Repository navigation
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 兼容的向量服务只用本地假服务测过。