2026-09-30 11:00:36 +00:00
4 changed files with 23 additions and 2 deletions
@@ -31,3 +31,4 @@
 | 同步前验收 | 20675f7442fd0592d473b715812c50e8cdfeade7 | 8ce9ddb5f27d0dc549051848cd233106ed6d7a89 | 2026-09-30T10:02:23Z |
 | 同步前验收 | 45e6a07626bc1d709624d5e3e37ba7556198d509 | ca2ff2d6a40d54f6d0d2cf73f2e9bd5c783f65e8 | 2026-09-30T10:36:13Z |
 | 同步前验收 | 81e4a3447a1daf743d88a7e7bc70e97cf9cac0c7 | 0d84b1d68f160999eedf315ea98156b850b76008 | 2026-09-30T10:44:54Z |
+| 同步前验收 | b71ef3e9a857646aec7e46839914f6cc0af1cc9f | 1634b42df094257fec61d475a9c0fac65bad6ab5 | 2026-09-30T11:00:17Z |
@@ -0,0 +1,20 @@
+# feature/tavily-search-tool 任务卡
+
+任务主记录：<PR 链接，task-finish 时填写>；状态：已完成；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0 = b71ef3e9a857646aec7e46839914f6cc0af1cc9f
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-tavily-search-tool；分支：feature/tavily-search-tool
+- 授权与交付终点：用户确认 Agent-Native 有 Tavily 集成并要求补上提示词 → 接线工具承载 + 补 tool.* 模块，自主闭环合入。
+
+## 目标与非目标
+
+- 目标：① 后端注册 tavily_search/web_search（桥接 Agent-Native TavilyProvider，密钥池轮换）；② 设置项 tools.tavily.apiKeys/endpoint（未配密钥不注册）；③ 提示词库补 tool.tavily_search/tool.web_search（含引用纪律：引用必附来源、失败回退指引）；④ 指南处置表更新（WebSearch 从"不移植"移入"已移植"）。
+- 非目标：不做 HITL 强制确认（只读外部检索，与目录语义一致）；不改 agent-native 仓。
+
+## 结果与验证
+
+- 结果：backend（tools/search.go 桥接 + 设置默认/Schema + app 装配 + 2 个库模块 + 库下限 46）；documents（处置表 WebSearch 行改移植）。
+- 验证：`go test ./...` 16 包 ok（新增 4 组搜索工具测试：注册/格式化/空查询/失败降级——降级文案承载在 error 内以适配注册表回灌语义）；运行时：未配密钥启动不注册（仅 knowledge_search）；配 2 密钥重启日志 "tavily_search/web_search registered (2 key(s))"，/api/tools 双工具在列，/api/prompts 46 模块。
+- 影响与剩余项：真实 Tavily 调用需用户在设置页配置密钥（EffectRestart）；库文案在模型侧 decl 组装时覆盖注册表默认描述（已有单测覆盖）。