使用 Azure Content Understanding 预构建布局分析器从文档中提取结构、文本、表格和图表，支持 PDF、图片、Office...
Azure 内容理解 — 布局分析器
功能概述
Azure 内容理解 — 布局分析器是一项面向实际任务的技能，主要用于使用 Azure 预建的放电分析器从文档中提取结构化的内容；Outputs Markdown 和结构化的 JSON 中包含文本、表格、 数字。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
使用与执行
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
Azure Content Understanding — Layout Analyzer
使用 Azure 预置的 layout analyzer 从文档中提取结构化内容。输出格式包括 Markdown 和结构化的 JSON，涵盖文本、表格、图表及文档层级结构。
配置
设置环境变量：
export AZURE_CU_ENDPOINT="https://YOUR_RESOURCE.services.ai.azure.com/" export AZURE_CU_API_KEY="YOUR_KEY_HERE"
可选：设置 API 版本（默认为 2025-05-01-preview）：
export AZURE_CU_API_VERSION="2025-11-01"
快速使用
分析一个 URL 并输出 Markdown
node scripts/analyze.mjs --url "https://example.com/document.pdf"
分析本地文件（通过 stdin 管道输入）
cat invoice.pdf | node scripts/analyze.mjs --stdin --markdown output.md --output result.json
同时保存 Markdown 和完整 JSON 输出
node scripts/analyze.mjs --url "https://example.com/report.pdf" --markdown report.md --output report.json
直接调用 API
当脚本不可用时，可使用 curl 调用：
# 提交分析任务（预览版 API）
curl -s -X POST "$AZURE_CU_ENDPOINT/contentunderstanding/analyzers/prebuilt-layout:analyze?api-version=2025-05-01-preview"
-H "Ocp-Apim-Subscription-Key: $AZURE_CU_API_KEY"
-H "Content-Type: application/json"
-d '{"url":"https://example.com/doc.pdf"}'
# 响应中包含 Operation-Location 头部 —— 需轮询该 URL 获取结果
对于正式发布版 API（2025-11-01），请求体格式有所变更：
{"inputs": [{"url": "https://example.com/doc.pdf"}]}
输出
Markdown
分析器生成 GitHub Flavored Markdown，保留以下结构：
- 标题（h1–h6）
- 表格（以 HTML
块形式呈现）
- 勾选标记（☒ 表示已勾选，☐ 表示未勾选）
- 图表（含引用标识）
- 段落（按阅读顺序排列）
结构化 JSON
完整输出包含每个元素的详细数据：
pages—— 每页尺寸、词数与行数统计paragraphs—— 文本块，含边界区域（bounding region）与语义角色（semantic role）tables—— 表格单元格，支持行列跨距（row/column spans）figures—— 检测到的图像/图表及其边界区域sections—— 文档的层级结构
支持的格式
PDF、JPEG、PNG、BMP、TIFF、HEIF、DOCX、XLSX、PPTX、HTML
最佳实践
- 异步操作 —— API 返回状态码 202；需轮询
Operation-Location头部指定的 URL 获取最终结果 - 轮询间隔 —— 推荐 3 秒；结果通常在 5–60 秒内返回
- 大文档处理 —— 最多支持 2,000 页；处理时间随页数线性增长
- 文件上传 —— 使用
Content-Type: application/octet-stream及二进制请求体 - 表格渲染 —— 在 Markdown 中以 HTML 形式呈现复杂布局（如合并单元格等）
API 参考文档
详见
references/api.md获取完整的请求与响应细节。更多相关专题
Postman身份认证怎么配置本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。
2026.11.06
0
12
Postman请求头Headers怎么设置围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。
2026.11.06
0
13
Postman接口请求发送教程详细介绍Postman接口请求的创建与发送方法，涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看，帮助用户掌握Postman接口请求的完整操作流程。
2026.11.06
0
10
DBeaver怎么导入数据DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
2026.11.05
0
12
DBeaver安全防护教程大全DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。
2026.11.05
0
12
DBeaver连接创建与配置教程本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。
2026.11.04
0
16
XORM框架结构体映射与表结构同步本专题围绕XORM框架的结构体映射展开，说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充，并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
2026.11.04
0
15
XORM框架安装配置与数据库连接本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
2026.11.04
0
15
XORM框架安装配置与数据库连接本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
2026.11.04
0
16
更多热门下载
更多相关下载
更多精品课程
热门推荐/最新课程
phpStudy极速入门视频教程共6课时 | 54.7万人学习
独孤九贱(4)_PHP视频教程共89课时 | 134.3万人学习
PHP实战天龙八部之仿爱奇艺电影网站共49课时 | 82.7万人学习
更多最新文章
