Azure AI 内容理解（预览版）

Azure AI 内容理解使用 AI 驱动的分析从多模式输入中提取内容和字段，包括文档、图像、音频和视频。

此连接器在以下产品和区域中可用：

Service	Class	Regions
Copilot Studio	标准	除以下各项外的所有 Power Automate 区域：      - 美国政府 （GCC）      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有 逻辑应用区域 ：      - Azure 政府区域      - Azure中国区域      - 美国国防部（DoD）
Power Apps	标准	除以下各项外的所有 Power Apps 区域：      - 美国政府 （GCC）      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）
Power Automate	标准	除以下各项外的所有 Power Automate 区域：      - 美国政府 （GCC）      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）

联系人
Name	Microsoft
URL	https://aka.ms/content-understanding
Email	contentunderstanding@microsoft.com

连接器元数据
Publisher	Microsoft
网站	https://aka.ms/content-understanding
隐私策略	https://privacy.microsoft.com
Categories	AI

正在创建连接

连接器支持以下身份验证类型：

API 密钥	提供内容理解资源名称和 API 密钥。	所有区域	可共享
托管标识	使用托管标识创建连接	仅限 LOGICAPPS	可共享
Microsoft Entra ID 集成	使用Microsoft Entra ID访问	所有区域	不可共享
默认值 [已弃用]	此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。	所有区域	不可共享

API 密钥

身份验证 ID：keyBasedAuth

适用：所有区域

提供内容理解资源名称和 API 密钥。

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	Required
API 密钥	安全字符串	内容理解 API 密钥	True
端点 URL	字符串	内容理解终结点 URL （示例： https://your-resource.cognitiveservices.azure.com/	True

托管的标识

身份验证 ID：managedIdentityAuth

适用：仅限 LOGICAPPS

使用托管标识创建连接

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	Required
托管的标识	managedIdentity	使用托管标识登录	True
端点 URL	字符串	内容理解终结点 URL （示例： https://your-resource.cognitiveservices.azure.com/	True

Microsoft Entra ID已集成

身份验证 ID：oauth

适用：所有区域

使用Microsoft Entra ID访问

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	Required
端点 URL	字符串	内容理解终结点 URL （示例： https://your-resource.cognitiveservices.azure.com/	True

默认值 [已弃用]

适用：所有区域

此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	Required
API 密钥	安全字符串	内容理解 API 密钥	True
端点 URL	字符串	内容理解终结点 URL （示例： https://your-resource.cognitiveservices.azure.com/	True

限制

名称	调用	续订期
每个连接的 API 调用数	1200	60 秒

操作

分析内容	使用分析器从多模式输入（文档、图像、音频、视频）中提取内容和字段。 该操作以异步方式运行，并在完成后返回结果。

分析内容

操作 ID:

AnalyzeContent

使用分析器从多模式输入（文档、图像、音频、视频）中提取内容和字段。 该操作以异步方式运行，并在完成后返回结果。

参数

名称	密钥	必需	类型	说明
分析器标识	analyzerId	True	string	要用于分析的分析器的唯一标识符。
文件内容	inputFileContent		byte	要分析的文件内容（文档、图像、音频或视频）。 Base64 编码。 不能与 Input File URL 或 inputs.
输入文件 URL	inputFileUrl		string	要分析的文件的 URL。 不能与 File Content 或 inputs.
范围	range		string	要分析的页面范围（例如 1-3,5,9-）。 仅适用于使用 File Content 或 Input File URL. 如果未设置，将处理所有页面。
文件 MIME 类型	inputFileMimeType		string	文件内容的 MIME 类型（例如 application/pdf、image/jpeg）。 使用 File Content时可选。
url	url		string	要分析的输入的 URL。 只需指定URL或数据之一。
数据	data		byte	输入的 Base64 编码二进制内容进行分析。 只需指定URL或数据之一。
名字	name		string	输入名称。
MIME 类型	mimeType		string	输入内容的 MIME 类型。例如 application/pdf、image/jpeg 等。
范围	range		string	要分析的输入的范围（例如 1-3,5,9-）。 文档内容使用基于 1 的页码。
处理位置	processingLocation		string	数据可能被处理的地点。 默认是全局。
字符串编码	stringEncoding		string	内容的字符串编码格式在响应中。 可能的值有“codePoint”、“utf16”和 utf8。

返回

分析作的状态和结果。

Body

AnalyzeOperationResult

定义

OperationState

操作状态

操作状态

string

AnalysisContent

从分析中提取的内容。

名称	路径	类型	说明
kind	kind	string	内容类。
markdown	markdown	string	内容的Markdown表示。
字段	fields	object	从内容中提取字段。
分类	category	string	分类内容类别。
analyzerId	analyzerId	string	生成这些内容的分析器。
MIME类型	mimeType	string	内容的 MIME 类型。
路径	path	string	内容在输入中的路径。

AnalysisResult

分析作结果。

名称	路径	类型	说明
analyzerId	analyzerId	string	分析仪的唯一标识符。
apiVersion	apiVersion	string	用于分析文档的API版本。
createdAt	createdAt	date-time	结果创建的日期和时间。
警告	warnings	array of object	分析文件时遇到的警告。
代码	warnings.code	string
消息	warnings.message	string
Markdown 内容	_markdown	string	用于快速访问的第一个内容项的 Markdown 表示形式。
内容	contents	array of AnalysisContent	提取的内容。

AnalyzeOperationResult

分析作的状态和结果。

名称	路径	类型	说明
id	id	string	作的唯一 ID。
状态	status	OperationState	操作状态
代码	error.code	string	错误代码。
消息	error.message	string	错误消息。
result	result	AnalysisResult	分析作结果。