Perplexity Agent API 正式上线 Batch 批量接口，单个文件最高支持 5 万条请求任务

Perplexity 正式为 Agent API 推出全新 Batch 批量任务接口，这项新能力把单文件任务上限提升至 5 万条请求，彻底解决了以往单条串行调用带来的效率瓶颈，开发者可以一次性上传批量任务文件，系统自动排队异步执行全部 Agent 任务，不用循环调用接口、反复维护请求队列，大幅降低大批量智能代理任务的开发工作量，同时还能平稳管控并发流量，把大规模数据处理、批量网页检索、多批次智能推理这类业务的运行成本控制在合理区间，让 Agent API 可以直接承接企业级海量数据批量处理场景，补齐了 Perplexity 智能代理接口在离线批量作业上的短板。在 Batch 接口上线之前，开发者只能使用同步单条调用模式，一次只能提交一条 Agent 请求，一旦需要处理上万条检索、问答、网页抓取任务，就必须自行编写循环脚本、做请求限流、捕获网络异常，不仅代码开发成本很高，还容易触发 API 调用频率限制，大批量任务只能拆分多天分批运行，整体执行周期很长。同时同步调用会持续占用连接资源，一旦任务量突破几千条，就会出现请求拥堵、任务排队超时等问题。针对这些痛点，Perplexity 专门为 Agent API 打造了 Batch 批量处理能力，把单次文件请求量级拉高到 5 万条，采用异步离线调度机制，任务提交之后由服务端统一调度算力资源，自动分配执行顺序，开发者只需要轮询任务状态，等待批量结果打包返回，不再需要手动管控每一条请求的调用节奏，完美适配离线批量数据处理业务。

一、Batch API 核心技术参数清单

表格

二、Batch API 相比同步单条调用的核心优势

1. 大幅简化开发代码，不用编写循环调用、重试机制、限流脚本，只需要上传任务文件 + 轮询任务状态，几十行代码就能完成数万条任务提交。
2. 规避调用频率限制，批量任务由服务端自动做流量削峰，不会触发每分钟请求上限，数万条任务可以一次性提交，不用人为拆分任务批次。
3. 降低网络资源开销，不需要持续保持网络连接，提交文件之后客户端可以断开网络，等待任务完成再获取结果，减少网络波动带来的任务失败。
4. 算力资源自动调度，系统根据整体负载自动调节任务执行速度，业务高峰期自动降速排队，空闲时段全速运行，保障大批量任务稳定跑完。
5. 任务全链路可追溯，每一条批量子任务都会保留独立日志，支持单独查看单条请求的执行结果与调用记录，方便排查异常任务。

三、使用 Batch API 执行批量 Agent 任务的分步操作流程

第一步：整理批量任务数据，按照 JSONL 格式编写任务文件，每一行写入一条符合 Agent API 规范的请求体，确保单文件内总请求条数不超过 5 万条，校验格式无语法错误。

第二步：调用 Batch 任务提交接口，上传 JSONL 任务文件，接口会即时返回唯一批量任务 ID，同时返回任务排队状态，此时任务进入后台调度队列。

第三步：定时调用任务状态查询接口，通过任务 ID 轮询进度，实时查看已完成条数、排队条数、失败条数，不需要持续轮询，设置几分钟轮询一次即可。

第四步：批量任务全部执行完毕后，接口会返回结果文件下载地址，直接下载打包后的结果文件，文件内会按任务顺序返回每一条 Agent 请求对应的响应内容。

第五步：对执行失败的少量任务做二次处理，把失败请求单独提取出来，重新生成小型 JSONL 文件再次提交批量任务，完成全量数据处理。

四、Batch API 适配的主流业务场景

1. 批量网页信息调研：一次性提交数万条行业检索请求，调用 Agent 网页搜索工具，批量抓取全网公开资讯，完成行业舆情、竞品信息的离线整理。
2. 海量文本智能分析：对数万条文本内容批量调用 Agent 推理，自动完成内容摘要、信息提取、分类打标，不用逐条发送同步请求。
3. 批量网页内容抓取：调用 fetch_url 工具，一次性提交大量网页链接，批量提取网页正文内容，形成结构化数据集。
4. 数据集批量清洗与标注：借助 Agent 的推理能力，批量对原始文本数据做清洗、去重、内容校验，自动生成标注结果，快速构建训练数据集。
5. 批量金融数据检索：批量发起企业财报、行业行情检索任务，一次性获取大批量金融公开信息，支撑量化投研的数据准备工作。

五、批量任务运行的优化配置清单

1. 严格控制单文件上限，单个 JSONL 文件保持在 5 万条以内，超大任务拆分成多个批量文件，避免单个任务体量过大影响排队优先级。
2. 开启任务失败自动重试，在提交参数里配置重试次数，针对网络波动导致的临时失败，由服务端自动重新执行该条请求。
3. 合理拆分任务粒度，不要把超长复杂推理任务和简单检索任务混在同一个批量文件里，分开提交可以提升整体执行效率。
4. 优先选择非高峰时段提交超大批量任务，夜间系统算力资源更充足，数万条任务的整体执行时长会明显缩短。
5. 开启结果分片存储，超大批量任务可以设置结果分片，避免单个结果文件体积过大，方便分段下载与数据解析。

六、Batch 接口上线带来的业务价值

1. 突破同步调用的数量限制，单文件支持 5 万条请求，把 Agent API 从少量实时问答场景，拓展到企业级离线海量数据处理场景。
2. 降低整体开发与运维成本，减少大量循环调用代码的编写，同时规避限流报错，大幅降低大批量任务的维护工作量。
3. 提升任务执行稳定性，异步排队机制把流量平缓释放，不会出现瞬时高并发导致的服务拥堵，数万条任务可以平稳跑完。
4. 打通 Agent 全场景使用链路，实时业务用同步接口，离线大批量数据处理用 Batch 批量接口，一套 Agent API 同时覆盖线上实时服务与线下数据加工两大业务。

【相关 FAQ】

问题 1：Perplexity Agent API 上线 Batch API，单文件支持 5 万条请求，这个批量接口和原来同步单条调用有什么区别？

回答 1：Perplexity Agent API 上线 Batch API，单文件支持 5 万条请求，原来的同步调用一次只能提交一条 Agent 请求，大批量任务需要自行写循环脚本，还容易触发调用限流；Batch API 采用异步离线模式，一次性上传最多 5 万条请求的 JSONL 文件，服务端自动排队调度，客户端只需要轮询任务进度，不用管控单条请求的调用节奏，更加适合数万条规模的离线批量作业。

问题 2：使用 Perplexity Agent API 的 Batch 批量接口，单文件最多可以提交多少条请求，文件格式有什么硬性要求？

回答 2：使用 Perplexity Agent API 的 Batch 批量接口，单个任务文件最多支持 5 万条 Agent 请求，文件必须采用 JSONL 单行格式，每一行对应一条标准 Agent 请求体，不能使用普通 JSON 数组格式，同时要保证文件内请求条数不突破 5 万条上限。

问题 3：Perplexity Agent API 的 Batch 批量任务执行完成后，如何获取 5 万条请求对应的返回结果？

回答 3：Perplexity Agent API 的 Batch 批量任务执行完成后，系统会自动生成打包后的结果文件，同时返回在线下载链接，结果文件会严格按照任务文件内请求顺序逐条返回 Agent 响应内容，开发者直接下载文件就能批量读取全部 5 万条请求的运行结果。

【数据来源】

[2026-10-23] Perplexity Agent API 上线 Batch API，单文件支持 5 万条请求 机器之心

[2026-10-23] Perplexity 推出 Agent 批量任务接口，单文件上限 5 万条异步请求 InfoQ

[2026-10-23] Perplexity API 更新：Agent 接口新增 Batch 批量异步作业能力 Perplexity 开发者博客

[2026-10-23] Perplexity Batch API 技术规范：文件格式、任务上限与调度规则 AI 开发周刊

免责声明：本文内容全部基于 Perplexity 官方发布的 Batch API 公开技术文档与行业资讯整理而成，不构成项目开发、接口调用与业务架构选型的最终方案；Batch API 的任务条数上限、并发配额、调用资费以 Perplexity 开发者平台最新公示内容为准；批量任务的执行时长受平台算力负载影响，实际运行速度以线上环境为准。