langchain-perplexity 1.4.2 发布：保留 Agent API 搜索结果并修复缓存统计

langchain-ai于上海时间2026年10月22日01时31分通过GitHub Release发布langchain-perplexity 1.4.2正式补丁，对应接口published_at为2026年10月21日17时31分04秒，发布提交时间为同日17时26分02秒，PyPI轮子包与源码包上传时间为17时30分48秒与49秒，均落在当日00时00分至23时59分窗口内。仓库归属为langchain-ai组织下的langchain公开仓库，包名为langchain-perplexity，对接Perplexity模型与搜索能力，中国开发者可通过公开仓库查看发布页并经PyPI升级验证。本次对比基线为langchain-perplexity 1.4.1，非预发布，发布说明未声明许可证变更与安全修复，沿用当日拉取确认的MIT条件。

关键变化

• 对比区间为1.4.1至1.4.2，发布提交为release(perplexity): 1.4.2；保留Agent API搜索结果，修复代理模式下搜索结果丢失问题；将Responses API缓存词元映射入input_token_details，便于用量与计费统计对齐；修复_astream中search_context_size逐块重复发送，改为每条流仅发送一次；刷新模型画像数据并升级certifi、urllib3与anyio等依赖，同步修复部分伙伴包依赖声明

适用对象与兼容性

本次主要面向已在Python侧通过langchain-perplexity接入Perplexity的开发者与团队，特别是使用ChatPerplexity、Agent API搜索与流式输出的场景。保留搜索结果修复有助于依赖搜索上下文做引用与追溯的问答流程，缓存词元映射有助于核对输入缓存与账单，流式计数修复有助于正确解析search_context_size。兼容性方面，本次为常规补丁，未声明破坏性接口变更；PyPI元数据显示需要Python大于等于3.10且小于4.0，分类器覆盖3.10至3.14，许可证为MIT；运行依赖包括langchain-core小于2.0且大于等于1.6.12、perplexityai小于1.0且大于等于0.34.1。安装沿用PyPI体系，可执行pip install -U langchain-perplexity==1.4.2，需公网访问GitHub与PyPI，内网环境需提前同步轮子包与源码包。

限制与注意事项

发布说明仅列出上述功能与依赖调整，未提供基准性能、成功率或成本对比数据，不应理解为性能提升承诺。错误修复生效范围限于当前包内Agent API与Responses API路径，实际模型可用范围、区域、配额与计费以后端Perplexity服务与账户权限为准。未将本次列为安全修复版本，不改变已知安全边界；许可证效果、长期维护与后续版本兼容不作超出发布说明的保证。国内用户需自行解决GitHub与PyPI网络可达性，并核对自身langchain-core与perplexityai版本是否满足约束。

下一步

已接入该包的项目可将版本固定至1.4.2，在预发环境验证Agent搜索问答、流式输出解析、缓存词元统计与现有异常重试流程后发布。未接入的团队可按仓库说明完成初始化与密钥配置，参考发布页中的变更列表与文档中的ChatPerplexity示例。后续进展以同一仓库发布页与PyPI历史为准，不以搜索片段或转载为准。