启用llamaparse可提升dify对合同、财报等复杂pdf的结构化解析能力，需注册账号获取api key并开启pdf/a-3验证与表格结构保留；在dify中配置custom api解析器，填入base url与密钥后测试连接；针对扫描件启用ocr、跨页表格启用视觉重校准、法律合同配置字段锚点规则；最后通过页数核对、table节点检查及置信度验证调试效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
启用LlamaParse作为Dify文档解析后端
当你的业务需要从合同、财报或带复杂表格的PDF中稳定提取字段级结构化内容时，Dify原生Extractor在扫描件识别、跨页表格还原、公式保留等场景下容易出现错位或截断，必须切换为更专业的解析引擎。
第一步：访问 https://cloud.llamaparse.com 注册账号并创建API Key，注意勾选「Enable PDF/A-3 validation」和「Preserve table structure」两个开关——【未开启后者将导致所有表格被扁平化为纯文本，无法用于后续RAG检索】。
第二步：在Dify管理后台进入「Settings → Advanced → Document Processing」，将「Default Parser」下拉菜单切换为「Custom API」，填入LlamaParse的Base URL：https://api.llamaparse.com/parse，并在「API Key」栏粘贴上一步获取的密钥。
第三步：点击「Test Connection」按钮，若返回状态码200且响应体含{"status":"ready"}，说明集成成功；若提示401或超时，请检查密钥是否复制完整、网络是否能直连llamaparse.com（企业内网需配置白名单）。
配置LlamaParse专属解析策略
不同文档类型需要匹配差异化的解析参数，硬编码统一设置会导致发票识别精度下降40%以上。
方法一：针对扫描PDF启用OCR增强
在Dify知识库上传文件时，点击「Advanced Options」→ 勾选「Use OCR for image-based PDFs」→ 在「OCR Language」中选择「zh」（中文）或「zh+en」（中英混合），该选项会自动向LlamaParse请求中注入{"ocr":true,"language":["zh"]}参数。
方法二：对含跨页表格的财报强制启用视觉边界重校准
进入Dify工作流节点，在「Document Parse」组件的「Custom Parameters」字段中手动输入JSON：{"enable_visual_layout":true,"table_extraction_strategy":"hybrid"}。此配置会绕过LlamaParse默认的语义分块逻辑，直接调用其底层DCR模块进行段落轮廓重绘——【不启用该参数时，跨页表格第二页的表头会被误判为正文，字段对齐完全失效】。
方法三：为法律合同启用字段锚点定位
在Dify Knowledge Pipeline画布中，拖入「Parse」节点后双击打开配置面板，在「Field Mapping Rules」区域添加规则：例如键名填effective_date，正则表达式填生效日期[:：]\s*(\d{4}年\d{1,2}月\d{1,2}日)。该规则会在LlamaParse完成基础解析后，对其输出的text_blocks做二次锚点匹配，确保日期字段始终被精准捕获而非混入上下文段落。
验证解析结果并调试异常
上传一份含签名区、页眉页脚和三列表格的测试PDF，执行「Preview Parsing Result」操作。
① 查看返回JSON中的pages数组长度是否与PDF实际页数一致，若少于实际页数，说明LlamaParse在某页遭遇字体嵌入缺失而跳过解析，需在上传前用Adobe Acrobat执行「另存为PDF/A」操作。
② 展开任意page.blocks，检查type字段是否包含"table"类型节点；若全为"text"，说明table_extraction_strategy未生效或PDF本身是截图而非可选中文本。
③ 对比原始PDF第3页右下角的“甲方（盖章）”文字，在JSON中对应block的confidence_score值是否≥0.85；低于该阈值需在LlamaParse控制台开启「Enhance low-confidence text with LLM fallback」开关并重新触发解析。
