BP-Agent Open API 概览

了解 BP-Agent 对外 API 的能力边界、鉴权方式和主要模块。

BP-Agent Open API 为合作方提供 PDF 上传、异步诊断、任务状态查询、结果文件下载，以及部分专项业务能力。

所有对外接口使用 /api/open/* 路径，并通过租户 API Token 隔离数据。

当前模块

模块	主要能力
Uploads	上传 PDF 并取得临时 file_id
Runs	创建、查询、重跑和取消诊断任务
Files	下载输入文件与输出产物
Pipeline Logs	查询任务阶段日志
Investor Products	创建和查询 N2 深度分析
Investor Rehearsal	获取对练上下文并回写报告
Finance	查询收入看板与交易流水

诊断主链路

API Token
  → 初始化上传
  → 上传 PDF
  → 完成上传并取得 file_id
  → 创建诊断任务
  → 查询任务状态
  → 从 output_files 定位产物
  → 下载 JSON、PDF 或 DOCX

API Token 只允许访问 /api/open/*。后台管理、租户管理和内部流水线接口不属于本开放协议。