4.3 KiB
@deepseek-ai/dsh-web-search-perplexity
English | 中文
由 Perplexity 支持的 WebSearchProvider，用于 harness web 能力 seam（ctx.web）。它调用 Perplexity 的 OpenAI 兼容 POST /chat/completions 端点，把生成答案与引用映射为 seam 规范化的 WebSearchResult。
这是一个实现包（package）：它向 ctx.web 注册提供方，不拥有该键，也不注册面向模型的工具。与 @deepseek-ai/dsh-llm-deepseek 一样，它是函数／命名空间插件（inject: ['web']）。OpenAI 兼容协议格式（wire format）是提供方私有细节，并不使该提供方依赖 ctx.llm。
配置
| 配置键 | 默认值 | 含义 |
|---|---|---|
apiKey |
$PERPLEXITY_API_KEY |
Perplexity API 密钥。为空或缺失时提供方不可用。 |
baseURL |
https://api.perplexity.ai |
端点基址；追加 /chat/completions。无法解析时提供方不可用。 |
model |
sonar |
搜索模型名称。 |
maxTokens |
1024 |
生成答案 token 上限（max_tokens）。必须是正整数。 |
searchRecency |
（未设置） | 以 search_recency_filter 发送的新近程度窗口：day、week、month 或 year。未设置时不发送过滤条件。 |
- id: web-search-perplexity
name: '@deepseek-ai/dsh-web-search-perplexity'
config:
apiKey: !!js process.env.PERPLEXITY_API_KEY
映射
content ← choices[0].message.content（生成答案）。sources[] 优先使用结构化 search_results[]（url、title、snippet、publishedAt ← date），否则回退到只含 URL 的 citations[] 数组；仅当不存在 search_results 时才采取这条回退路径。这些源只携带 url，因此 seam 上的 title／snippet／publishedAt 是可选字段。提供方失败以 WebError WEB_PROVIDER_ERROR 呈现；中止请求以 WEB_ABORTED 呈现。HTTP 重定向会在访问 Location 指向的目标之前被拒绝，并以 WEB_PROVIDER_ERROR 呈现。Perplexity 没有结果数量控制，因此 seam 会强制执行 maxResults（截断 sources[] 并设置 truncated）。
模型体验
辅助 Perplexity 请求
模型看到的内容
独立的 Perplexity 模型通过 chat-completions 端点将 <query> 原样作为唯一用户消息接收。该请求不属于会话模型上下文。
Token 影响
每次搜索会产生独立的提供方 token；maxTokens 限制生成答案。
KV Cache 影响
与会话请求缓存相互独立。同一模型路由下的相同查询可能复用提供方缓存；查询或路由改变会建立不同前缀。
间接的会话工具结果
模型看到的内容
通过 dsh-tool-web，会话模型会看到生成答案及结构化结果元数据，或只含 URL 的引用。该提供方确切的错误消息为 Perplexity search aborted、Perplexity search request failed: <error> 和 Perplexity returned an unprocessable response body: <error>；HTTP 失败保留提供方消息。错误包装层属于消费方。
Token 影响
注册不会直接产生会话 token。答案与源 token 取决于数据，源数量受 seam 限制；保留的结果或错误会重复发送，直到发生 compaction（上下文压缩）。
KV Cache 影响
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
已知限制与暂缓事项
- 引用回退源只含 URL：Perplexity 省略结构化
search_results[]时，源不含title／snippet／publishedAt，因此工具只渲染纯主机名标签。 - 超量返回的来源仍会增加 token 消耗和延迟：协议没有结果数量控制，
maxResults只能由 seam 在事后截断。 - 只公开
model／maxTokens／searchRecency：Perplexity 的其他搜索控制项（域名过滤条件、web_search_options上下文大小、图片）等待提供方无关 seam 字段（见 seam Agent Note（agent 决策记录））。 - 按错误形状分类中止：只有
DOMException且名为AbortError时才映射为WEB_ABORTED；携带自定义原因的中止（例如dsh-timeout的TimeoutReason）会呈现为WEB_PROVIDER_ERROR。