Skip to content

feat(sdk): llm 文本调用支持 webSearch 开关 - #8

Merged
redreamality merged 2 commits into
mainfrom
feat/llm-web-search
Nov 13, 2026
Merged

redreamality merged 2 commits into
mainfrom
feat/llm-web-search

Conversation

@redreamality

Copy link
Copy Markdown
Contributor

背景

「实时应答助手」工作台需要在回答时事类问题时联网。各家模型供应商(Gemini grounding、OpenAI/Claude 的 web search 工具、Kimi、豆包等)都有自带的联网搜索,但当前 Host 的 llm.generateText / llm.streamText 没有开关:输入 schema 是 additionalProperties: false,多传字段会被直接拒收。工作台只能自己挂 web_search 工具,再让用户另外申请 Tavily / Exa 等 connector 的 API key。

改动

在 SDK 契约里给文本调用加一个开关,接入方式与 reasoning 相同:

  • sdk/host-contracts.mts:TextModelInput 新增 webSearch?: boolean,默认 false,模型不支持时 Host 按 false 处理。generateObject 不加。
  • tooling/compiler/host-operations.ts、tooling/contracts/workbenchOperations.ts:服务端代码里的文本调用用到 webSearch 时,构建把 llm.webSearch 写入 manifest.requires.operations,旧客户端会提示升级,而不是在运行时拒收参数。
  • references/llm.md:说明用法,并建议把联网作为用户可选项,因为它会增加延迟和费用。
  • tests/authoring.test.mjs:requires 扫描用例覆盖 webSearch。

需要桌面端配套

只合并这个 PR,联网不会生效。 参数校验和模型调用都在 Floatboat 桌面端,需要:

  1. 在 llm.generateText / llm.streamText 的输入 schema 里接受 webSearch。
  2. 按供应商把它映射到各自的原生联网能力;不支持的模型静默忽略。
  3. 在 capabilities.list 里声明 llm.webSearch,listModels 最好能标出哪些模型支持联网。
  4. 可以考虑在结果里附带引用来源,这个 PR 没有定义返回字段,留给桌面端设计。

验证

在 Windows 上,Node 22.23.4:

  • pnpm workbench:check、pnpm test 通过。
  • tooling:sdk-boundary、agent-stream、catalog、host-connection、skills、workspaces、pack-cli、runtime-package、live-preview 全部通过;authoring.test.mjs 中 requires 扫描用例(含本次新增断言)通过。
  • authoring.test.mjs 另有两项失败,在未改动的 main 上同样失败,与本 PR 无关:一项因为 Windows 没有符号链接权限(EPERM);「平台未连接」一项在本机开着 Floatboat 时超时。
  • pnpm skills:check 在 Windows 检出时报 SKILL_ENTRY_STALE,原因是 CRLF 换行,main 上同样如此;内容没有差异,所以没有提交生成的入口文件。

🤖 Generated with Claude Code

redreamality and others added 2 commits November 12, 2026 18:30
TextModelInput 新增 webSearch?: boolean,使用模型供应商自带的联网搜索;
构建扫描到该字段时写入 requires.operations 的 llm.webSearch。
需要桌面端在输入 schema 与模型路由中配套实现。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
桌面端 listModels 的文本条目已返回 webSearch(AOE-HQ/aoe-desktop#2742),
SDK 类型与创作指引同步:说明未标注时按不支持处理,Gemini 同时传 tools 时降级。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@redreamality
redreamality merged commit 5b0b379 into main Nov 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant