Azure распознавание содержимого ИИ (предварительная версия)

Azure ИИ Content Understanding извлекает содержимое и поля из многомодальных входных данных, включая документы, изображения, аудио и видео с помощью анализа с поддержкой ИИ.

Этот соединитель доступен в следующих продуктах и регионах:

Service	Class	Regions
Copilot Studio	Стандарт	Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: - Azure для государственных организаций регионы - Azure регионы Китая - Министерство обороны США (DoD)
Power Apps	Стандарт	Все регионы Power Apps кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Стандарт	Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Microsoft
URL	https://aka.ms/content-understanding
Электронная почта	contentunderstanding@microsoft.com

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://aka.ms/content-understanding
Политика конфиденциальности	https://privacy.microsoft.com
Categories	AI

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


Ключ API	Укажите имя ресурса Content Understanding и ключ API.	Все регионы	Доступный для общего пользования
Управляемое удостоверение Logic Apps	Создание подключения с помощью управляемого удостоверения LogicApps	Только LOGICAPPS	Доступный для общего пользования
Интегрированный идентификатор Microsoft Entra	Доступ к идентификатору Microsoft Entra	Все регионы	Недоступен для совместного использования
По умолчанию [не рекомендуется]	Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.	Все регионы	Недоступен для совместного использования

Ключ API

Идентификатор проверки подлинности: keyBasedAuth

Применимо: все регионы

Укажите имя ресурса Content Understanding и ключ API.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательный
Ключ API	securestring	Ключ API распознавания содержимого	True
URL конечной точки	string	URL-адрес конечной точки распознавания содержимого (пример: `https://your-resource.cognitiveservices.azure.com/`)	True

Управляемое удостоверение Logic Apps

Идентификатор проверки подлинности: managedIdentityAuth

Применимо: только LOGICAPPS

Создание подключения с помощью управляемого удостоверения LogicApps

Имя	Тип	Description	Обязательный
Управляемое удостоверение LogicApps	managedIdentity	Вход с помощью управляемого удостоверения Logic Apps	True
URL конечной точки	string	URL-адрес конечной точки распознавания содержимого (пример: `https://your-resource.cognitiveservices.azure.com/`)	True

интеграция Microsoft Entra ID

Идентификатор проверки подлинности: oauth

Применимо: все регионы

Доступ к идентификатору Microsoft Entra

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательный
URL конечной точки	string	URL-адрес конечной точки распознавания содержимого (пример: `https://your-resource.cognitiveservices.azure.com/`)	True

По умолчанию [не рекомендуется]

Применимо: все регионы

Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.

Имя	Тип	Description	Обязательный
Ключ API	securestring	Ключ API распознавания содержимого	True
URL конечной точки	string	URL-адрес конечной точки распознавания содержимого (пример: `https://your-resource.cognitiveservices.azure.com/`)	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	1200	60 секунд

Действия

Анализ содержимого

Извлеките содержимое и поля из многомодальных входных данных (документы, изображения, аудио, видео) с помощью анализатора. Операция выполняется асинхронно и возвращает результат после завершения.

Анализ содержимого

Идентификатор операции:: 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	name		string	Название ввода.
Тип MIME	mimeType		string	Тип MIME входного содержимого. Например, application/pdf, image/jpeg и т. д.
range	range		string	Диапазон входных данных для анализа (например, 1-3,5,9-). Содержимое документа использует 1-й номер страницы.
Расположение обработки	processingLocation		string	Место, где могут обрабатываться данные. По умолчанию — глобальный.
Кодировка строк	stringEncoding		string	Формат строкового кодирования содержимого охватывает ответ. Возможные значения — 'codePoint', 'utf16' и `utf8`.

Возвращаемое значение

Состояние и результат операции анализа.

Текст: AnalyzeOperationResult

Определения

OperationState

Статус операции.

: string

AnalysisContent

Извлеченное содержимое из анализа.

Имя	Путь	Тип	Описание
kind	kind	string	Контент.
markdown	markdown	string	Изображение контента с понижением.
Поля	fields	object	Извлекли поля из содержимого.
category	category	string	Категория классифицированного контента.
analyzerId	analyzerId	string	Анализатор, который создал этот контент.
тип MIME	mimeType	string	Тип MIME содержимого.
path	path	string	Путь содержания в входных данных.

AnalysisResult

Анализ результата операции.

Имя	Путь	Тип	Описание
analyzerId	analyzerId	string	Уникальный идентификатор анализатора.
apiVersion	apiVersion	string	Версия API, используемая для анализа документа.
createdAt	createdAt	date-time	Дата и время создания результата.
Предупреждения	warnings	array of object	Предупреждения, обнаруженные при анализе документа.
code	warnings.code	string
message	warnings.message	string
Содержимое Markdown	_markdown	string	Представление Markdown первого элемента содержимого для быстрого доступа.
contents	contents	array of AnalysisContent	Извлечённое содержимое.

AnalyzeOperationResult

Состояние и результат операции анализа.

Имя	Путь	Тип	Описание
id	id	string	Уникальный идентификатор операции.
статус	status	OperationState	Статус операции.
code	error.code	string	Код ошибки.
message	error.message	string	Сообщение об ошибке.
result	result	AnalysisResult	Анализ результата операции.