月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
内容理解快速开始
本教程用 REST API 调用预置分析器
prebuilt-invoice 处理一份文件，并轮询获取字段结果。整个流程不需要创建自定义分析器。前置条件
项目 | 要求 | 备注 |
Azure 订阅 | 已有订阅 | 页面所述 |
Foundry 资源 | 在受支持区域创建 Microsoft Foundry 资源 | 创建需要 Contributor 或更高角色（页面所述）；区域列表待核实 |
默认模型部署 | 通过 Content Understanding Studio 开启自动部署，或调用 REST PATCH /contentunderstanding/defaults | 页面所述 |
工具 | cURL（REST）；SDK 示例需 Python 3.9+、.NET、JDK 8+ 与 Maven，或 JavaScript 工具链 | 页面所述；SDK 版本待核实 |
步骤
- 在 Azure 门户创建 Microsoft Foundry 资源。
- 在资源的“密钥和终结点”页面复制终结点与密钥。
- 配置资源的默认模型部署。
- 提交文件：向
{endpoint}/contentunderstanding/analyzers/prebuilt-invoice:analyze发送 POST 请求。服务返回202 Accepted，并在Operation-Location响应头中给出结果地址。
- 对
Operation-Location发起 GET 请求，每 1 到 2 秒轮询一次，直到status为Succeeded，字段结果位于result中。
预期结果
阶段 | 预期 |
提交文件 | 返回 202 Accepted 与 Operation-Location |
轮询中 | 状态未结束，需继续轮询 |
完成 | status 为 Succeeded，result 中包含发票字段与置信度 |
API 版本
- 默认使用 GA 版本
2025-11-01。
- 仅在需要预览功能时使用
2026-06-01-preview。该版本为公开预览，页面建议用于评估而非生产，具体条款待核实。
常见问题
现象 | 处理 |
轮询后无结果 | 确认使用的是 Operation-Location 地址，并按页面示例每 1 到 2 秒轮询 |
分析请求失败，提示缺少模型 | 检查默认模型部署是否已配置（Studio 自动部署或 defaults 接口） |
资源区域不支持 | 参照区域支持页面（本页未核对，待核实） |
需要 SDK 示例 | 页面提供 Python、.NET、Java 与 JavaScript 示例，本页仅核对 REST 流程 |
清理资源
删除不再使用的 Foundry 资源或资源组。具体步骤本页未核对，待核实。
来源与核对
- 来源：Quickstart: REST API and SDKs for Content Understanding（Microsoft Learn，https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/quickstart/use-rest-api）
- 核对范围：正文已读，但仅覆盖页面前约 10 万字符，即前置条件、REST 步骤与版本说明。JavaScript 段未核对，相关内容待核实。
- 获取日期：2026-11-05。
上一篇
内容安全概览
下一篇
内容理解概览
Loading...