Azure ai Content Understanding (versión preliminar)

Azure AI Content Understanding extrae el contenido y los campos de la entrada bidireccional, incluidos documentos, imágenes, audio y vídeo mediante el análisis con inteligencia artificial.

Este conector está disponible en los siguientes productos y regiones:

Servicio	Class	Regions
Copilot Studio	Estándar	Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Estándar	Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Estándar	Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

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

Metadatos del conector
Publicador	Microsoft
Sitio web	https://aka.ms/content-understanding
Directiva de privacidad	https://privacy.microsoft.com
Categories	AI

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Clave de API	Proporcione el nombre del recurso y la clave de API de Content Understanding.	Todas las regiones	Compartible
Identidad administrada de Logic Apps	Creación de una conexión mediante una identidad administrada de LogicApps	Solo LOGICAPPS	Compartible
Microsoft Entra ID Integrado	Uso de Microsoft Entra ID para acceder	Todas las regiones	No se puede compartir
Valor predeterminado [EN DESUSO]	Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.	Todas las regiones	No se puede compartir

Clave de API

Identificador de autenticación: keyBasedAuth

Aplicable: Todas las regiones

Proporcione el nombre del recurso y la clave de API de Content Understanding.

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Name	Tipo	Descripción	Obligatorio
Clave de API	securestring	Clave de API de Content Understanding	True
Dirección URL del extremo	string	Dirección URL del punto de conexión de Content Understanding (ejemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Identidad administrada de Logic Apps

Identificador de autenticación: managedIdentityAuth

Aplicable: SOLO LOGICAPPS

Creación de una conexión mediante una identidad administrada de LogicApps

Name	Tipo	Descripción	Obligatorio
Identidad administrada de LogicApps	managedIdentity	Inicio de sesión con una identidad administrada de Logic Apps	True
Dirección URL del extremo	string	Dirección URL del punto de conexión de Content Understanding (ejemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Microsoft Entra ID integrado

Identificador de autenticación: oauth

Aplicable: Todas las regiones

Uso de Microsoft Entra ID para acceder

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Name	Tipo	Descripción	Obligatorio
Dirección URL del extremo	string	Dirección URL del punto de conexión de Content Understanding (ejemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Name	Tipo	Descripción	Obligatorio
Clave de API	securestring	Clave de API de Content Understanding	True
Dirección URL del extremo	string	Dirección URL del punto de conexión de Content Understanding (ejemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	1200	60 segundos

Acciones

Analizar contenido

Extraiga contenido y campos de la entrada descriptora (documentos, imágenes, audio, vídeo) mediante un analizador. La operación se ejecuta de forma asincrónica y devuelve el resultado cuando se completa.

Analizar contenido

Id. de la operación:: AnalyzeContent

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador del analizador	analyzerId	True	string	Identificador único del analizador que se va a usar para el análisis.
Contenido del archivo	inputFileContent		byte	Contenido del archivo que se va a analizar (documento, imagen, audio o vídeo). Codificado en Base64. No se puede combinar con `Input File URL` o `inputs`.
Dirección URL del archivo de entrada	inputFileUrl		string	Dirección URL del archivo que se va a analizar. No se puede combinar con `File Content` o `inputs`.
Alcance	range		string	Intervalo de páginas que se va a analizar (por ejemplo, 1-3,5,9-). Solo se aplica cuando se usa `File Content` o `Input File URL`. Si no se establece, se procesan todas las páginas.
Tipo MIME de archivo	inputFileMimeType		string	Tipo MIME del contenido del archivo (por ejemplo, application/pdf, image/jpeg). Opcional al usar `File Content`.
url	url		string	Dirección URL de la entrada que se va a analizar. Solo se debe especificar una URL o un dato.
datos	data		byte	Contenido binario codificado en base 64 de la entrada a analizar. Solo se debe especificar una URL o un dato.
name	name		string	Nombre de la entrada.
Tipo MIME	mimeType		string	Tipo MIME del contenido de entrada. Por ejemplo, application/pdf, image/jpeg, etc.
rango	range		string	Intervalo de la entrada que se va a analizar (por ejemplo, 1-3,5,9-). El contenido del documento usa números de página basados en 1.
Ubicación de procesamiento	processingLocation		string	El lugar donde se pueden procesar los datos. Por defecto es global.
Codificación de cadenas	stringEncoding		string	El formato de codificación de cadenas para contenido abarca la respuesta. Los valores posibles son 'codePoint', 'utf16' y `utf8`.

Devoluciones

Estado y resultado de la operación de análisis.

Body: AnalyzeOperationResult

Definiciones

OperationState

Estado de la operación.

: string

AnalysisContent

Contenido extraído del análisis.

Nombre	Ruta de acceso	Tipo	Description
kind	kind	string	Tipo de contenido.
markdown	markdown	string	Representación con descuento del contenido.
fields	fields	object	Extraje campos del contenido.
category	category	string	Categoría de contenido clasificado.
analyzerId	analyzerId	string	El analizador que generó este contenido.
tipo MIME	mimeType	string	Tipo MIME del contenido.
ruta	path	string	El camino del contenido en la entrada.

AnalysisResult

Analizar el resultado de la operación.

Nombre	Ruta de acceso	Tipo	Description
analyzerId	analyzerId	string	El identificador único del analizador.
apiVersion	apiVersion	string	La versión de la API utilizada para analizar el documento.
createdAt	createdAt	date-time	La fecha y hora en que se creó el resultado.
Advertencias	warnings	array of object	Advertencias encontradas al analizar el documento.
código	warnings.code	string
Mensaje	warnings.message	string
Contenido de Markdown	_markdown	string	Representación de Markdown del primer elemento de contenido para el acceso rápido.
contents	contents	array of AnalysisContent	El contenido extraído.

AnalyzeOperationResult

Estado y resultado de la operación de análisis.

Nombre	Ruta de acceso	Tipo	Description
id	id	string	El identificador único de la operación.
estado	status	OperationState	Estado de la operación.
código	error.code	string	Código de error.
Mensaje	error.message	string	Mensaje de error.
resultado	result	AnalysisResult	Analizar el resultado de la operación.