Azure AI Content Understanding （預覽）

Azure AI 內容理解利用 AI 分析，從多模態輸入中萃取內容與欄位，包括文件、圖片、音訊與影片。

此連接器適用於以下產品和區域：

服務	Class	Regions
Copilot Studio	標準	除以下部分外，所有Power Automate區域：      - 美國政府 （GCC）      - 美國政府（海灣合作委員會高中）      - 由 21Vianet 營運的中國雲      - 美國國防部 （DoD）
邏輯應用程式	標準	所有 Logic Apps 區域， 但下列區域除外：      - Azure Government regions      - Azure 中國區域      - 美國國防部 （DoD）
Power Apps	標準	除以下部分外，所有Power Apps區域      - 美國政府 （GCC）      - 美國政府（海灣合作委員會高中）      - 由 21Vianet 營運的中國雲      - 美國國防部 （DoD）
Power Automate（自動化服務）	標準	除以下部分外，所有Power Automate區域：      - 美國政府 （GCC）      - 美國政府（海灣合作委員會高中）      - 由 21Vianet 營運的中國雲      - 美國國防部 （DoD）

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

連接器中繼資料
Publisher	Microsoft
網站	https://aka.ms/content-understanding
隱私策略	https://privacy.microsoft.com
類別	AI

正在建立連線

連接器支援下列驗證類型：

API 金鑰	提供內容理解資源名稱與 API 金鑰。	所有地區	可共用
Logic Apps 受控識別	使用 LogicApps 受控識別建立連線	僅限 LOGICAPPS	可共用
Microsoft Entra ID 整合	使用 Microsoft Entra ID 來存取	所有地區	不可共享
預設值 [已棄用]	此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。	所有地區	不可共享

API 金鑰

驗證 ID：keyBasedAuth

適用：所有地區

提供內容理解資源名稱與 API 金鑰。

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

Name	類型	Description	Required
API 金鑰	安全字串	內容理解 API 金鑰	沒錯
端點 URL	字串	內容理解端點網址（範例： https://your-resource.cognitiveservices.azure.com/）	沒錯

Logic Apps 受控識別

驗證 ID：managedIdentityAuth

適用：僅限 LOGICAPPS

使用 LogicApps 受控識別建立連線

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

Name	類型	Description	Required
LogicApps 受控識別	managedIdentity	使用 Logic Apps 受控識別登入	沒錯
端點 URL	字串	內容理解端點網址（範例： https://your-resource.cognitiveservices.azure.com/）	沒錯

Microsoft Entra ID 已整合

驗證 ID：oauth

適用：所有地區

使用 Microsoft Entra ID 來存取

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

Name	類型	Description	Required
端點 URL	字串	內容理解端點網址（範例： https://your-resource.cognitiveservices.azure.com/）	沒錯

預設值 [已棄用]

適用：所有地區

此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

Name	類型	Description	Required
API 金鑰	安全字串	內容理解 API 金鑰	沒錯
端點 URL	字串	內容理解端點網址（範例： https://your-resource.cognitiveservices.azure.com/）	沒錯

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	1200	60 秒鐘

動作

分析內容	使用分析器從多模態輸入（文件、圖片、音訊、影片）中擷取內容與欄位。 操作以非同步方式執行，完成後回傳結果。

分析內容

作業識別碼：

AnalyzeContent

使用分析器從多模態輸入（文件、圖片、音訊、影片）中擷取內容與欄位。 操作以非同步方式執行，完成後回傳結果。

參數

名稱	機碼	必要	類型	Description
分析器識別碼	analyzerId	True	string	分析器用於分析的唯一識別碼。
檔案內容	inputFileContent		byte	檔案內容（文件、影像、音訊或影片）。 Base64編碼。 無法與 Input File URL 或 inputs結合。
輸入檔案網址	inputFileUrl		string	要分析的檔案網址。 無法與 File Content 或 inputs結合。
分布範圍	range		string	要分析的頁面範圍（例如 1-3、5、9-）。 僅適用於使用 File Content or Input File URL時。 若未設定，所有頁面都會被處理。
檔案 MIME 類型	inputFileMimeType		string	檔案內容的 MIME 類型（例如 application/pdf、image/jpeg）。 使用 File Content時為可選。
url	url		string	輸入的網址。 網址或資料中只應指定其中一種。
資料	data		byte	輸入的 base64 編碼二進位內容進行分析。 網址或資料中只應指定其中一種。
name	name		string	輸入名稱。
MIME 類型	mimeType		string	輸入內容的 MIME 類型。例如應用程式/PDF、圖片/jpeg 等。
範圍	range		string	輸入分析範圍（例如 1-3、5、9-）。 文件內容使用以1為基礎的頁碼。
處理地點	processingLocation		string	資料可能被處理的地點。 預設是全域。
字串編碼	stringEncoding		string	內容的字串編碼格式在回應中跨度。 可能的值包括「codePoint」、「utf16」及 utf8。

傳回

分析作業的狀態和結果。

身體

AnalyzeOperationResult

定義

OperationState

作業的狀態。

作業的狀態。

string

分析內容

從分析中提取內容。

名稱	路徑	類型	Description
kind	kind	string	滿足型。
markdown	markdown	string	內容的 Markdown 表示。
fields	fields	object	從內容中擷取欄位。
分類	category	string	機密內容類別。
analyzerID	analyzerId	string	產生這些內容的分析器。
mimeType	mimeType	string	內容的 MIME 類型。
路徑	path	string	內容在輸入中的路徑。

分析結果

分析操作結果。

名稱	路徑	類型	Description
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	提取的內容。

分析操作結果

分析作業的狀態和結果。

名稱	路徑	類型	Description
id	id	string	作業的唯一識別碼。
狀態	status	OperationState	作業的狀態。
字碼	error.code	string	錯誤碼。
訊息	error.message	string	錯誤訊息。
result	result	AnalysisResult	分析操作結果。