Laiye 智能体文档处理 (ADP)

智能体文档处理 API — 使用 VLM 和 LLM 将 10 多种文件格式（.jpeg、.jpg、.png、.bmp、.tiff、.pdf、.doc、.docx、.xls、.xlsx）转换为带有每个字段置信度分数的结构化 JSON/Excel。

基础 URL: https://adp-global.laiye.com/?utm_source=github

快速开始

bash
curl -X POST https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/extract \
-H Content-Type: application/json \
-H X-Access-Key: $ADPACCESSKEY \
-H X-Timestamp: $(date +%s) \
-H X-Signature: $(uuidgen) \
-d {
appkey: $ADPAPP_KEY,
appsecret: $ADPAPP_SECRET,
file_url: https://example.com/invoice.pdf
}

响应:
json
{
status: success,
extraction_result: [
{
fieldkey: invoicenumber,
field_value: INV-2024-001,
field_type: text,
confidence: 0.95,
source_pages: [1]
},
{
fieldkey: totalamount,
field_value: 1000.00,
field_type: number,
confidence: 0.98,
source_pages: [1]
}
]
}

设置

1. 获取您的 API 凭证

bash

联系 ADP 服务提供商获取：

- app_key: 应用程序访问密钥

- app_secret: 应用程序密钥

- X-Access-Key: 租户级访问密钥

保存您的凭证:
bash
export ADPACCESSKEY=youraccesskey_here
export ADPAPPKEY=yourappkey_here
export ADPAPPSECRET=yourappsecret_here

2. 配置（可选）

推荐：使用环境变量（最安全）:
json5
{
skills: {
entries: {
adp-doc-extraction: {
enabled: true,
// 从环境变量加载的 API 凭证
},
},
},
}

安全说明：

• - 设置文件权限：chmod 600 ~/.openclaw/openclaw.json
• 切勿将此文件提交到版本控制
• 优先使用环境变量或密钥存储
• 定期轮换凭证

常见任务

从文件 URL 提取

bash
curl -X POST https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/extract \
-H Content-Type: application/json \
-H X-Access-Key: $ADPACCESSKEY \
-H X-Timestamp: $(date +%s) \
-H X-Signature: $(uuidgen) \
-d {
appkey: $ADPAPP_KEY,
appsecret: $ADPAPP_SECRET,
file_url: https://example.com/document.pdf
}

从 Base64 提取

bash

将文件转换为 base64

curl -X POST https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/extract \
-H Content-Type: application/json \
-H X-Access-Key: $ADPACCESSKEY \
-H X-Timestamp: $(date +%s) \
-H X-Signature: $(uuidgen) \
-d {
\appkey\: \$ADPAPP_KEY\,
\appsecret\: \$ADPAPP_SECRET\,
\filebase64\: \$filebase64\,
\file_name\: \document.pdf\
}

提取并包含 VLM 结果

bash
curl -X POST https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/extract \
-H Content-Type: application/json \
-H X-Access-Key: $ADPACCESSKEY \
-H X-Timestamp: $(date +%s) \
-H X-Signature: $(uuidgen) \
-d {
appkey: $ADPAPP_KEY,
appsecret: $ADPAPP_SECRET,
file_url: https://example.com/document.pdf,
withrecresult: true
}

访问 VLM 结果：response[docrecognizeresult]

异步提取（大型文档）

创建提取任务：
bash
curl -X POST https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/extract/create/task \
-H Content-Type: application/json \
-H X-Access-Key: $ADPACCESSKEY \
-H X-Timestamp: $(date +%s) \
-H X-Signature: $(uuidgen) \
-d {
appkey: $ADPAPP_KEY,
appsecret: $ADPAPP_SECRET,
file_url: https://example.com/large-document.pdf
}

返回：{taskid: taskid_value, metadata: {...}}

轮询获取结果：
bash
curl -X GET https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/extract/query/task/{task_id} \
-H X-Access-Key: $ADPACCESSKEY

高级功能

自定义缩放参数

通过更高分辨率增强 VLM 质量：
bash

model_params: { scale: 2.0 }

指定配置版本

使用特定的提取配置：
bash

modelparams: { versionid: configversionid }

仅文档识别

获取 VLM 结果而不进行提取：
bash
curl -X POST https://adp-global.laiye.com/open/agenticdocprocessor/laiye/v1/app/doc/recognize \
-H Content-Type: application/json \
-H X-Access-Key: $ADPACCESSKEY \
-H X-Timestamp: $(date +%s) \
-H X-Signature: $(uuidgen) \
-d {
appkey: $ADPAPP_KEY,
appsecret: $ADPAPP_SECRET,
file_url: https://example.com/document.pdf
}

何时使用

使用 ADP 的场景：

• - 发票处理
• 订单处理
• 收据处理
• 财务文档处理
• 物流文档处理
• 多表格文档数据提取

不适用的场景：

• - 视频转录
• 音频转录

最佳实践

文件输入：

• - fileurl：大文件优先（已托管）
• filebase64：用于直接上传（最大 20MB）

置信度分数：

• - 范围：每个字段 0-1
• 手动检查置信度 <0.8 的字段

响应结构：

• - extractionresult：提取的字段数组
• docrecognizeresult：VLM 结果（当 withrec_result=true 时）
• metadata：处理信息（页数、时间、模型）

响应模式

成功响应