> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acturehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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            | 查询收入看板与交易流水            |

## 诊断主链路

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

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