如何从云浏览器取回文件并显式结束运行

远程浏览器的文件不会自动出现在 Agent 本地。下载后，要在这次运行仍有效时从制品接口取回文件并核对完整性；随后显式结束运行，确认浏览器释放与费用结算。

先取回文件

页面触发下载后，查询当前运行的下载制品列表。
等对应条目进入 ready，再用它的 id 请求内容；未就绪时只做有界等待。
把返回字节保存到 Agent 所在环境，并核对长度与 SHA-256。
取回成功后再结束运行。结束或到期后，旧下载不能继续取回。

不要把远端 Playwright Download.path() 当成本地文件路径。完整字段与限制见接入参考。

再结束运行

由当前 Agent 创建的运行，正常与异常路径都应调用结束接口，查询到 released 才能确认浏览器已关闭。状态保存是否成功看最终 save_status，实际费用是否结算看 billing.status；三者分别报告。若 Agent 只接入了别的流程拥有的运行，结束责任应按任务约定处理。

HTTP 路径示意 · 请按线上合同补齐鉴权与错误处理

GET    /openapi/v1/browser/sessions/{id}/downloads
GET    /openapi/v1/browser/sessions/{id}/downloads/{download_id}/content
DELETE /openapi/v1/browser/sessions/{id}
GET    /openapi/v1/browser/sessions/{id}

断开 CDP 客户端、关闭人工页面或离开本站，都不会替你结束云端运行。