> ## 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.

# 快速接入

> 使用 relay 上传 PDF、创建完整诊断任务并读取任务状态。

本示例以测试环境为准，使用 `relay` 上传。

<Steps>
  <Step title="设置环境变量">
    ```bash theme={null}
    export BP_AGENT_BASE_URL="https://bptest.mapleai.cc"
    export BP_AGENT_API_TOKEN="<由租户管理员提供>"
    export BP_FILE="/absolute/path/to/business-plan.pdf"
    ```
  </Step>

  <Step title="计算文件信息">
    ```bash theme={null}
    export BP_FILE_SIZE="$(stat -f%z "${BP_FILE}")"
    export BP_FILE_MD5="$(md5 -q "${BP_FILE}")"
    ```

    Linux 可分别使用 `stat -c%s` 和 `md5sum`。
  </Step>

  <Step title="初始化 relay 上传">
    ```bash theme={null}
    curl -sS -X POST \
      -H "Authorization: Bearer ${BP_AGENT_API_TOKEN}" \
      -H "Content-Type: application/json" \
      -d "{\"file_name\":\"$(basename "${BP_FILE}")\",\"file_size\":${BP_FILE_SIZE},\"file_md5\":\"${BP_FILE_MD5}\",\"strategy\":\"relay\"}" \
      "${BP_AGENT_BASE_URL}/api/open/uploads/init"
    ```

    保存响应中的 `data.upload_id`。
  </Step>

  <Step title="上传文件并完成上传">
    ```bash theme={null}
    curl -sS -X PUT \
      -H "Authorization: Bearer ${BP_AGENT_API_TOKEN}" \
      -H "Content-Type: application/octet-stream" \
      --data-binary "@${BP_FILE}" \
      "${BP_AGENT_BASE_URL}/api/open/uploads/${UPLOAD_ID}/content"

    curl -sS -X POST \
      -H "Authorization: Bearer ${BP_AGENT_API_TOKEN}" \
      -H "Content-Type: application/json" \
      -d "{\"upload_id\":\"${UPLOAD_ID}\"}" \
      "${BP_AGENT_BASE_URL}/api/open/uploads/complete"
    ```

    保存完成响应中的 `data.file_id`。该值是临时、租户绑定的文件凭证。
  </Step>

  <Step title="创建完整诊断任务">
    ```bash theme={null}
    curl -sS -X POST \
      -H "Authorization: Bearer ${BP_AGENT_API_TOKEN}" \
      -H "Content-Type: application/json" \
      -d "{\"file_id\":\"${FILE_ID}\",\"pipeline\":\"bp_diagnosis\",\"target\":\"export_optimization\"}" \
      "${BP_AGENT_BASE_URL}/api/open/runs"
    ```

    保存响应中的 `data.pipeline_run_id`。
  </Step>

  <Step title="查询任务结果">
    ```bash theme={null}
    curl -sS \
      -H "Authorization: Bearer ${BP_AGENT_API_TOKEN}" \
      "${BP_AGENT_BASE_URL}/api/open/runs/${PIPELINE_RUN_ID}"
    ```

    当 `data.status` 为 `SUCCEEDED` 时，从 `data.output_files` 选择需要的产物并下载。
  </Step>
</Steps>