Azure AI Content Understanding (プレビュー)

Azure AI Content Understanding は、AI を利用した分析を使用して、ドキュメント、画像、オーディオ、ビデオなどのマルチモーダル入力からコンテンツとフィールドを抽出します。

このコネクタは、次の製品とリージョンで使用できます。

Service	クラス	Regions
コピロットスタジオ	Standard	次を除くすべてのPower Automateリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD)
ロジックアプリ	Standard	次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD)
Power Apps	Standard	次を除くすべてのPower Appsリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD)
Power Automate（パワーオートメート）	Standard	次を除くすべてのPower Automateリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD)

お問い合わせ
Name	Microsoft
URL	https://aka.ms/content-understanding
Email	contentunderstanding@microsoft.com

コネクタメタデータ
発行者	Microsoft
Web サイト	https://aka.ms/content-understanding
プライバシーポリシー	https://privacy.microsoft.com
カテゴリ	AI

接続を作成する

コネクタでは、次の認証の種類がサポートされています。


API キー	Content Understanding リソース名と API キーを指定します。	すべてのリージョン	共有可能
ロジックアプリのマネージド ID	LogicApps マネージド ID を使用して接続を作成する	LOGICAPPS のみ	共有可能
Microsoft Entra ID 統合	Microsoft Entra ID を使用してアクセスする	すべてのリージョン	共有不可
既定 [非推奨]	このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。	すべてのリージョン	共有不可

API キー

認証 ID: keyBasedAuth

適用対象: すべてのリージョン

Content Understanding リソース名と API キーを指定します。

これは共有可能な接続です。電源アプリが別のユーザーと共有されている場合は、接続も共有されます。詳細については、キャンバスアプリのコネクタの概要 - Power Apps |Microsoft Docs

Name	タイプ	Description	必須
API キー	securestring	Content Understanding API キー	正しい
エンドポイント URL	文字列	Content Understanding エンドポイント URL (例: `https://your-resource.cognitiveservices.azure.com/`)	正しい

Logic Apps マネージド ID

認証 ID: managedIdentityAuth

適用: LOGICAPPS のみ

LogicApps マネージド ID を使用して接続を作成する

Name	タイプ	Description	必須
LogicApps マネージド ID	managedIdentity	Logic Apps マネージド ID を使用してサインインする	正しい
エンドポイント URL	文字列	Content Understanding エンドポイント URL (例: `https://your-resource.cognitiveservices.azure.com/`)	正しい

Microsoft Entra ID 統合

認証 ID: oauth

適用対象: すべてのリージョン

Microsoft Entra ID を使用してアクセスする

これは共有可能な接続ではありません。電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

Name	タイプ	Description	必須
エンドポイント URL	文字列	Content Understanding エンドポイント URL (例: `https://your-resource.cognitiveservices.azure.com/`)	正しい

既定 [非推奨]

適用対象: すべてのリージョン

このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。

Name	タイプ	Description	必須
API キー	securestring	Content Understanding API キー	正しい
エンドポイント URL	文字列	Content Understanding エンドポイント URL (例: `https://your-resource.cognitiveservices.azure.com/`)	正しい

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	1200	60 秒

アクション

コンテンツの分析

アナライザーを使用して、マルチモーダル入力 (ドキュメント、画像、オーディオ、ビデオ) からコンテンツとフィールドを抽出します。操作は非同期的に実行され、完了すると結果が返されます。

コンテンツの分析

操作 ID:: AnalyzeContent

パラメーター

名前	キー	必須	型	説明
解析器 ID	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	name		string	入力の名前。
MIME の種類	mimeType		string	入力コンテンツの MIME の種類。例: application/pdf、image/jpeg など。
範囲	range		string	分析する入力の範囲 (例: 1-3,5,9-)。ドキュメントコンテンツでは、1 から始まるページ番号が使用されます。
処理場所	processingLocation		string	データが処理される場所。デフォルトはグローバルに設定されます。
文字列エンコーディング	stringEncoding		string	レスポンス内のコンテンツの文字列エンコーディング形式が使われます。可能な値は「codePoint」、「utf16」、「 `utf8`」です。

返品

分析操作の状態と結果。

体: AnalyzeOperationResult

定義

OperationState

操作の状態。

: string

AnalysisContent

分析から抽出されたコンテンツ。

名前	パス	型	説明
種類	kind	string	満足したタイプ。
markdown	markdown	string	コンテンツのマークダウン表現。
fields	fields	object	内容からフィールドを抽出しました。
カテゴリ	category	string	機密コンテンツカテゴリ。
analyzerId	analyzerId	string	このコンテンツを生成したアナライザーです。
mimeType（マイムタイプ）	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	すばやくアクセスできるように、最初のコンテンツ項目のマークダウン表現。
contents	contents	array of AnalysisContent	抽出されたコンテンツ。

AnalyzeOperationResult

分析操作の状態と結果。

名前	パス	型	説明
id	id	string	操作の一意の ID。
状態	status	OperationState	操作の状態。
コード	error.code	string	エラーコード。
メッセージ	error.message	string	エラーメッセージ。
結果	result	AnalysisResult	操作結果を分析します。