Global Purchase Order Recognition and Extraction（ADP） — 全球采购订单识别和提取（ADP）

全球采购订单识别和提取技能由Laiye ADP（Agentic Document Processing）提供，该技能为各种采购订单（PO）和销售订单提供智能识别和关键信息提取。它利用官方Laiye ADP CLI工具——单个命令完成从订单文档（PDF、图像、扫描副本）中提取结构化字段，输出标准JSON，以便与业务系统无缝集成。新用户每月可获得100个免费积分（每月刷新），相当于每月66页免费的采购订单提取。ADP提供标准的商业API，可以在1小时内集成到业务系统中。

注册现在：全球 | 中国大陆快速入门指南核心工作流程 安装依赖项：首次运行时，安装ADP CLI工具。 身份验证设置：首次运行时，执行adp config get检查凭据。如果未配置，提示用户提供API密钥。 获取应用程序列表：首次运行时，通过adp app-id list --app-type 0检索内置应用程序列表，找到订单提取应用程序，并记录其app_id（以ootb_为前缀）。对于后续运行，优先使用adp app-id cache。 执行提取：运行adp extract url --app-id 或adp extract local --app-id 。 处理结果：解析返回的JSON以提取结构化字段，例如PO号码、订单日期、卖方名称、买方/客户名称、买方/客户地址、接收者名称、交货地址、货币、总金额和行项（包括材料代码、描述、数量、税率、含税单价、含税总金额、交货日期）。 错误处理：当命令失败时，解析stderr JSON以确定错误类型和恢复操作。

场景到命令映射 单个订单识别用户意图推荐命令识别订单文件（URL）adp extract url --app-id 识别本地订单文件adp extract local --app-id 识别Base64编码的订单adp extract base64 --app-id --file-name 批量识别用户意图推荐命令批量识别本地文件夹中的订单adp extract local --app-id 批量识别多个URLadp extract url --app-id 异步处理用户意图推荐命令异步提交大文件adp extract url --app-id --async异步批处理adp extract local --app-id --async查询异步任务结果adp extract query 并发限制：免费用户最多支持2个文档的并发处理，而付费用户最多支持10个文档的并发处理。

步骤1：安装ADP CLI 方法1：npm（推荐，跨平台）npm install -g @laiye-adp/agentic-doc-parse-and-extract-cli 方法2：Shell脚本（Linux / macOS，当npm不可用时）curl -fsSL https://raw.githubusercontent.com/laiye-ai/adp-cli/main/scripts/adp-init.sh | bash 方法3：PowerShell脚本（Windows，当npm不可用时）irm https://raw.githubusercontent.com/laiye-ai/adp-cli/main/scripts/adp-init.ps1 | iex 或从GitHub Releases下载预编译的二进制文件。

步骤2：获取API密钥和身份验证设置

• 访问ADP门户获取凭据为中国大陆和全球用户提供单独的公共云URL。使用最近的区域可以确保最佳的网络性能。

区域登录URL API基URL全球https://adp-global.laiye.com/ https://adp-global.laiye.com/中国大陆https://adp.laiye.com/ https://adp.laiye.com/

• 获取API密钥注册/登录后新用户需要先注册ADP账户；注册后，将获得每月100个免费积分。登录后，单击个人资料头像以访问API_Key条目。
• 完成身份验证设置adp config set --api-key adp config set --api-base-url https://adp.laiye.com
• 验证配置adp config get

注意：如果API密钥和API基URL已经配置，建议将配置存储在环境变量中，以避免重复设置。如果API密钥和API基URL尚未配置，请按照上述步骤完成设置。

步骤3：获取订单提取应用程序IDADP为采购订单提供了一个内置的、开箱即用的提取应用程序——无需额外配置。 应用程序类型描述ADP应用程序分为两种类型，以app_type字段区分： app_type类型描述0开箱即用（OOTB）平台内置，app_id以ootb_为前缀，准备好使用，无需创建1自定义应用程序用户创建的提取应用程序，具有用户定义的app_id 订单识别是一个开箱即用的应用程序，可以使用--app-type 0查询。 查询和筛选订单应用程序 查询OOTB应用程序（推荐）adp app-id list --app-type 0 或查询所有应用程序adp app-id list