# Acture 文档中心

> Acture 对接指南与 API Reference

- [Acture 文档中心](https://docs.acturehub.com/index.md): 面向合作方和内部开发团队的统一接入文档。
- [BP-Agent Open API 概览](https://docs.acturehub.com/bp-agent/overview.md): 了解 BP-Agent 对外 API 的能力边界、鉴权方式和主要模块。
- [快速接入](https://docs.acturehub.com/bp-agent/quickstart.md): 使用 relay 上传 PDF、创建完整诊断任务并读取任务状态。
- [鉴权](https://docs.acturehub.com/bp-agent/authentication.md): 使用租户 API Token 调用 BP-Agent Open API。
- [环境与地址](https://docs.acturehub.com/bp-agent/environments.md): BP-Agent 测试、生产环境及其存储能力差异。
- [上传 PDF](https://docs.acturehub.com/bp-agent/upload.md): 比较 relay 与 STS 直传，并说明上传会话和 file_id 的约束。
- [创建诊断任务](https://docs.acturehub.com/bp-agent/diagnosis-flow.md): 使用上传返回的 file_id 创建 BP 诊断流水线。
- [任务状态与轮询](https://docs.acturehub.com/bp-agent/task-status.md): 正确处理 BP-Agent 异步任务状态和终态。
- [结果文件](https://docs.acturehub.com/bp-agent/result-files.md): 从任务详情定位并下载 JSON、PDF 和 DOCX 产物。
- [错误处理](https://docs.acturehub.com/bp-agent/error-handling.md): BP-Agent 通用错误结构、错误码与重试原则。
- [N2 深度分析](https://docs.acturehub.com/bp-agent/n2-analysis.md): 为已有项目创建并查询投资人产品 N2 深度分析。
- [投资人对练](https://docs.acturehub.com/bp-agent/investor-rehearsal.md): 读取项目对练上下文并以幂等方式回写对练报告。
- [收入数据](https://docs.acturehub.com/bp-agent/finance.md): 通过 API Token 查询租户收入看板和收入流水。
- [查询诊断任务列表](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-runs/查询诊断任务列表.md)
- [创建诊断任务](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-runs/创建诊断任务.md)
- [查询诊断任务详情](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-runs/查询诊断任务详情.md)
- [取消诊断任务](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-runs/取消诊断任务.md)
- [重新执行诊断任务](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-runs/重新执行诊断任务.md)
- [删除诊断任务记录](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-runs/删除诊断任务记录.md)
- [下载输出文件](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-files/下载输出文件.md)
- [下载任务输入文件](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-files/下载任务输入文件.md)
- [打包下载任务文件](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-files/打包下载任务文件.md)
- [查询收入看板](https://docs.acturehub.com/api-reference/bp-agent/对外收入-open-finance/查询收入看板.md)
- [查询收入流水](https://docs.acturehub.com/api-reference/bp-agent/对外收入-open-finance/查询收入流水.md)
- [创建 N2 深度分析](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-investor-products/创建-n2-深度分析.md)
- [查询 N2 深度分析状态](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-investor-products/查询-n2-深度分析状态.md)
- [获取 N2 深度分析结果](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-investor-products/获取-n2-深度分析结果.md)
- [获取投资人对练上下文](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-investor-rehearsal/获取投资人对练上下文.md)
- [回写投资人对练报告](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-investor-rehearsal/回写投资人对练报告.md): Persist one immutable report snapshot with tenant-scoped idempotency.
- [获取最新投资人对练报告](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-investor-rehearsal/获取最新投资人对练报告.md): Return the newest report snapshot for mini-program and integration reads.
- [查询任务阶段日志](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-pipeline-logs/查询任务阶段日志.md)
- [初始化 PDF 上传](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-uploads/初始化-pdf-上传.md)
- [上传 relay 文件内容](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-uploads/上传-relay-文件内容.md)
- [完成 PDF 上传](https://docs.acturehub.com/api-reference/bp-agent/开放接口-open-uploads/完成-pdf-上传.md)
- [变更记录](https://docs.acturehub.com/changelog.md): 文档中心与对外 API 契约的版本记录。

## OpenAPI Specs

- [bp-agent.openapi](/specs/bp-agent.openapi.json)