Azure AI Content Understanding (Pré-visualização)

O Azure AI Content Understanding extrai conteúdos e campos de input multimodais, incluindo documentos, imagens, áudio e vídeo, utilizando análises potenciadas por IA.

Este conector está disponível nos seguintes produtos e regiões:

Service	Classe	Regiões
Estúdio Copiloto	Standard	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD)
Power Apps	Standard	Todas as regiões Power Apps exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Power Automate	Standard	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

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

Metadados do conector
Editor	Microsoft
Sítio Web	https://aka.ms/content-understanding
Política de privacidade	https://privacy.microsoft.com
Categorias	IA

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:


Chave da API	Fornecer Compreensão de Conteúdo, nome do recurso e Chave da API.	Todas as regiões	Compartilhável
Identidade gerida do Logic Apps	Criar uma conexão usando uma identidade gerenciada do LogicApps	Apenas LOGICAPPS	Compartilhável
Microsoft Entra ID Integrado	Use o Microsoft Entra ID para acessar	Todas as regiões	Não compartilhável
Padrão [DEPRECATED]	Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

Chave de API

ID de autenticação: keyBasedAuth

Aplicável: Todas as regiões

Fornecer Compreensão de Conteúdo, nome do recurso e Chave da API.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Name	Tipo	Description	Obrigatório
Chave de API	securestring	Chave API de Compreensão de Conteúdo	True
URL do ponto de extremidade	cadeia (de caracteres)	Compreensão de Conteúdo Endpoint URL (Exemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Identidade gerenciada de aplicativos lógicos

ID de autenticação: managedIdentityAuth

Aplicável: apenas LOGICAPPS

Criar uma conexão usando uma identidade gerenciada do LogicApps

Name	Tipo	Description	Obrigatório
Identidade gerenciada do LogicApps	managedIdentity	Entrar com uma identidade gerenciada de aplicativos lógicos	True
URL do ponto de extremidade	cadeia (de caracteres)	Compreensão de Conteúdo Endpoint URL (Exemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Microsoft Entra ID Integrado

ID de autenticação: oauth

Aplicável: Todas as regiões

Use o Microsoft Entra ID para acessar

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Name	Tipo	Description	Obrigatório
URL do ponto de extremidade	cadeia (de caracteres)	Compreensão de Conteúdo Endpoint URL (Exemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Name	Tipo	Description	Obrigatório
Chave de API	securestring	Chave API de Compreensão de Conteúdo	True
URL do ponto de extremidade	cadeia (de caracteres)	Compreensão de Conteúdo Endpoint URL (Exemplo: `https://your-resource.cognitiveservices.azure.com/`)	True

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	1200	60 segundos

Ações

Analisar o Conteúdo

Extrair conteúdo e campos de entrada multimodal (documentos, imagens, áudio, vídeo) usando um analisador. A operação corre de forma assíncrona e devolve o resultado quando concluída.

Analisar o Conteúdo

ID da Operação:: AnalyzeContent

Extrair conteúdo e campos de entrada multimodal (documentos, imagens, áudio, vídeo) usando um analisador. A operação corre de forma assíncrona e devolve o resultado quando concluída.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do Analisador	analyzerId	True	string	O identificador único do analisador a usar para análise.
Conteúdo do Ficheiro	inputFileContent		byte	Conteúdo do arquivo para analisar (documento, imagem, áudio ou vídeo). Base64-codificado. Não pode ser combinado com `Input File URL` ou `inputs`.
URL do ficheiro de entrada	inputFileUrl		string	URL do ficheiro a analisar. Não pode ser combinado com `File Content` ou `inputs`.
Alcance	range		string	Intervalo de páginas a analisar (por exemplo, 1-3,5,9-). Só se aplica quando se usa `File Content` ou `Input File URL`. Se não estiver definido, todas as páginas são processadas.
Tipo MIME de Ficheiro	inputFileMimeType		string	Tipo MIME do conteúdo do ficheiro (por exemplo, aplicação/pdf, imagem/jpeg). Opcional ao usar `File Content`.
url	url		string	URL da entrada a analisar. Só deve ser especificado um URL ou um dos dados.
dados	data		byte	Conteúdo binário codificado em base 64 da entrada a analisar. Só deve ser especificado um URL ou um dos dados.
name	name		string	Nome da entrada.
Tipo de MIME	mimeType		string	O tipo MIME do conteúdo de entrada. Ex. aplicação/pdf, imagem/jpeg, etc.
intervalo	range		string	Alcance da entrada a analisar (ex. 1-3,5,9-). O conteúdo do documento utiliza números de página baseados em 1.
Local de Processamento	processingLocation		string	O local onde os dados podem ser processados. Por defeito é global.
Codificação de cadeia de caracteres	stringEncoding		string	O formato de codificação de strings para conteúdo abrange a resposta. Os valores possíveis são 'codePoint', 'utf16' e `utf8`.

Devoluções

Status e resultado da operação de análise.

Corpo: AnalyzeOperationResult

Definições

OperationState

Estado da operação.

: string

Análise Conteúdo

Conteúdo extraído da análise.

Name	Caminho	Tipo	Description
kind	kind	string	Tipo de conteúdo.
markdown	markdown	string	Representação com markdown do conteúdo.
campos	fields	object	Extrai campos do conteúdo.
categoria	category	string	Categoria de conteúdo classificado.
analyzerId	analyzerId	string	O analisador que gerou este conteúdo.
mimeType	mimeType	string	O tipo MIME do conteúdo.
caminho	path	string	O caminho do conteúdo na entrada.

AnáliseResultado

Analise o resultado da operação.

Name	Caminho	Tipo	Description
analyzerId	analyzerId	string	O identificador único do analisador.
apiVersion	apiVersion	string	A versão da API usada para analisar o documento.
createdAt	createdAt	date-time	A data e hora em que o resultado foi criado.
Advertências	warnings	array of object	Avisos encontrados durante a análise do documento.
código	warnings.code	string
mensagem	warnings.message	string
Conteúdo de Markdown	_markdown	string	Representação Markdown do primeiro item de conteúdo, para acesso rápido.
contents	contents	array of AnalysisContent	O conteúdo extraído.

AnalyzeOperationResult

Status e resultado da operação de análise.

Name	Caminho	Tipo	Description
id	id	string	O ID exclusivo da operação.
estado	status	OperationState	Estado da operação.
código	error.code	string	Código de erro.
mensagem	error.message	string	Mensagem de erro.
result	result	AnalysisResult	Analise o resultado da operação.