Azure compreensão de conteúdo de IA (versão prévia)

Azure a Compreensão de Conteúdo de IA extrai conteúdo e campos de entrada multimodal, incluindo documentos, imagens, áudio e vídeo usando a análise da IA.

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

Service	Classe	Regions
Copilot Studio	Standard	Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - 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 (GCC) – 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 (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

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

Metadados do conector
Publicador	Microsoft
Site	https://aka.ms/content-understanding
Política de privacidade	https://privacy.microsoft.com
Categories	IA

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:


Chave de API	Forneça o nome do recurso de Compreensão de Conteúdo e a Chave de API.	Todas as regiões	Compartilhável
Identidades gerenciadas de Aplicativos Lógicos	Criar uma conexão usando uma Identidade Gerenciada do LogicApps	Somente LOGICAPPS	Compartilhável
Microsoft Entra ID Integrado	Usar a ID do Microsoft Entra para acessar	Todas as regiões	Não compartilhável
Padrão [PRETERIDO]	Essa 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

Forneça o nome do recurso de Compreensão de Conteúdo e a Chave de API.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Name	Tipo	Description	Obrigatório
Chave de API	secureString	Chave de API de Compreensão de Conteúdo	Verdade
URL do Ponto de Extremidade	cadeia	Url do ponto de extremidade de compreensão de conteúdo (exemplo: `https://your-resource.cognitiveservices.azure.com/`)	Verdade

Identidade Gerenciada de Aplicativos Lógicos

ID de autenticação: managedIdentityAuth

Aplicável: somente 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	Verdade
URL do Ponto de Extremidade	cadeia	Url do ponto de extremidade de compreensão de conteúdo (exemplo: `https://your-resource.cognitiveservices.azure.com/`)	Verdade

Integração com Microsoft Entra ID

ID de autenticação: oauth

Aplicável: todas as regiões

Usar a ID do Microsoft Entra para acessar

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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	Url do ponto de extremidade de compreensão de conteúdo (exemplo: `https://your-resource.cognitiveservices.azure.com/`)	Verdade

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 de API de Compreensão de Conteúdo	Verdade
URL do Ponto de Extremidade	cadeia	Url do ponto de extremidade de compreensão de conteúdo (exemplo: `https://your-resource.cognitiveservices.azure.com/`)	Verdade

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	1200	60 segundos

Ações

Analisar Conteúdo

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

Analisar Conteúdo

ID da operação:: AnalyzeContent

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

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do analisador	analyzerId	True	string	O identificador exclusivo do analisador a ser usado para análise.
Conteúdo do arquivo	inputFileContent		byte	Conteúdo do arquivo a ser analisado (documento, imagem, áudio ou vídeo). Codificado em Base64. Não é possível combinar com `Input File URL` ou `inputs`.
URL do Arquivo de Entrada	inputFileUrl		string	URL do arquivo a ser analisado. Não é possível combinar com `File Content` ou `inputs`.
Intervalo	range		string	Intervalo de páginas a ser analisado (por exemplo, 1-3,5,9-). Aplica-se somente ao usar `File Content` ou `Input File URL`. Se não estiver definido, todas as páginas serão processadas.
Tipo mime de arquivo	inputFileMimeType		string	Tipo MIME do conteúdo do arquivo (por exemplo, aplicativo/pdf, image/jpeg). Opcional ao usar `File Content`.
url	url		string	URL da entrada a ser analisada. Apenas uma URL ou um dado deve ser especificado.
dados	data		byte	Conteúdo binário codificado em base 64 da entrada a ser analisada. Apenas uma URL ou um dado deve ser especificado.
name	name		string	Nome da entrada.
Tipo MIME	mimeType		string	O tipo MIME do conteúdo de entrada. Ex. application/pdf, image/jpeg etc.
alcance	range		string	Intervalo da entrada a ser analisada (ex. 1-3,5,9-). O conteúdo do documento usa números de página baseados em 1.
Local de processamento	processingLocation		string	O local onde os dados podem ser processados. O padrão é global.
Codificação de cadeia de caracteres	stringEncoding		string	O formato de codificação de string para conteúdo abrange a resposta. Os valores possíveis são 'codePoint', 'utf16' e `utf8`.

Retornos

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

Corpo: AnalyzeOperationResult

Definições

OperationState

Status da operação.

: string

AnalysisContent

Conteúdo extraído da análise.

Nome	Caminho	Tipo	Description
variante	kind	string	Conteúdo do tipo
markdown	markdown	string	Representação com markdown do conteúdo.
fields	fields	object	Extraímos campos do conteúdo.
categoria	category	string	Categoria de conteúdo classificado.
analyzerId	analyzerId	string	O analisador que gerou esse conteúdo.
Tipo MIME	mimeType	string	O tipo MIME do conteúdo.
caminho	path	string	O caminho do conteúdo na entrada.

AnalysisResult

Analisar o resultado da operação.

Nome	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.
Avisos	warnings	array of object	Avisos encontrados durante a análise do documento.
codificar	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.
Conteúdo	contents	array of AnalysisContent	O conteúdo extraído.

AnalyzeOperationResult

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

Nome	Caminho	Tipo	Description
id	id	string	A ID exclusiva da operação.
status	status	OperationState	Status da operação.
codificar	error.code	string	Código de erro.
mensagem	error.message	string	Mensagem de erro.
resultado	result	AnalysisResult	Analisar o resultado da operação.