Azure intelligenza artificiale Content Understanding (anteprima)

Azure intelligenza artificiale Content Understanding estrae contenuto e campi dall'input bidirezionale, inclusi documenti, immagini, audio e video usando l'analisi basata su intelligenza artificiale.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Assistenza	Classe	Regions
Copilot Studio	Standard	Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Standard	Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Standard	Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatti
Name	Microsoft
URL	https://aka.ms/content-understanding
Posta elettronica	contentunderstanding@microsoft.com

Metadati del connettore
Editore	Microsoft
Sito web	https://aka.ms/content-understanding
Informativa sulla privacy	https://privacy.microsoft.com
Categorie	AI

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:


Chiave API	Specificare il nome della risorsa e la chiave API di Content Understanding.	Tutte le aree geografiche	Condivisibile
Identità gestita di App per la logica	Creare una connessione usando un'identità gestita di LogicApps	Solo LOGICAPPS	Condivisibile
Microsoft Entra ID integrato	Usare Microsoft Entra ID per accedere	Tutte le aree geografiche	Non condivisibile
Impostazione predefinita [DEPRECATO]	Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.	Tutte le aree geografiche	Non condivisibile

Chiave API

ID autenticazione: keyBasedAuth

Applicabile: tutte le aree

Specificare il nome della risorsa e la chiave API di Content Understanding.

Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs

Name	Tipo	Descrizione	Obbligatorio
Chiave API	securestring	Content Understanding API Key	True
URL del punto finale	Stringa	URL dell'endpoint di Comprensione del contenuto (esempio: `https://your-resource.cognitiveservices.azure.com/`)	True

Identità gestita di App per la logica

ID autenticazione: managedIdentityAuth

Applicabile: solo LOGICAPPS

Creare una connessione usando un'identità gestita di LogicApps

Name	Tipo	Descrizione	Obbligatorio
Identità gestita di LogicApps	managedIdentity	Accedere con un'identità gestita di App per la logica	True
URL del punto finale	Stringa	URL dell'endpoint di Comprensione del contenuto (esempio: `https://your-resource.cognitiveservices.azure.com/`)	True

Integrazione di Microsoft Entra ID

ID autenticazione: oauth

Applicabile: tutte le aree

Usare Microsoft Entra ID per accedere

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Name	Tipo	Descrizione	Obbligatorio
URL del punto finale	Stringa	URL dell'endpoint di Comprensione del contenuto (esempio: `https://your-resource.cognitiveservices.azure.com/`)	True

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Name	Tipo	Descrizione	Obbligatorio
Chiave API	securestring	Content Understanding API Key	True
URL del punto finale	Stringa	URL dell'endpoint di Comprensione del contenuto (esempio: `https://your-resource.cognitiveservices.azure.com/`)	True

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	1200	60 secondi

Azioni

Analizzare il contenuto

Estrarre contenuto e campi dall'input multifunzionale (documenti, immagini, audio, video) usando un analizzatore. L'operazione viene eseguita in modo asincrono e restituisce il risultato al termine.

Analizzare il contenuto

ID operazione:: AnalyzeContent

Estrarre contenuto e campi dall'input multifunzionale (documenti, immagini, audio, video) usando un analizzatore. L'operazione viene eseguita in modo asincrono e restituisce il risultato al termine.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID analizzatore	analyzerId	True	string	Identificatore univoco dell'analizzatore da usare per l'analisi.
Contenuto del file	inputFileContent		byte	Contenuto del file da analizzare (documento, immagine, audio o video). Codifica Base64. Non può essere combinato con `Input File URL` o `inputs`.
Input File URL	inputFileUrl		string	URL del file da analizzare. Non può essere combinato con `File Content` o `inputs`.
Intervallo	range		string	Intervallo di pagine da analizzare (ad esempio 1-3,5,9-). Si applica solo quando si usa `File Content` o `Input File URL`. Se non è impostata, vengono elaborate tutte le pagine.
Tipo MIME di file	inputFileMimeType		string	Tipo MIME del contenuto del file ,ad esempio application/pdf, image/jpeg. Facoltativo quando si usa `File Content`.
url	url		string	URL dell'input da analizzare. Dovrebbe essere specificato solo un URL o un dato.
Dati	data		byte	Contenuto binario codificato in Base64 dell'input da analizzare. Dovrebbe essere specificato solo un URL o un dato.
name	name		string	Nome dell'input.
Tipo MIME	mimeType		string	Tipo MIME del contenuto di input. Ad esempio applicazione/pdf, immagine/jpeg e così via.
intervallo	range		string	Intervallo dell'input da analizzare (ad esempio 1-3,5,9-). Il contenuto del documento usa numeri di pagina basati su 1.
Percorso di elaborazione	processingLocation		string	Il luogo in cui i dati possono essere elaborati. Imposta di default su globale.
Codifica delle stringhe	stringEncoding		string	Il formato di codifica stringa per i contenuti si estende nella risposta. I valori possibili sono 'codePoint', 'utf16' e `utf8`.

Valori restituiti

Stato e risultato dell'operazione di analisi.

Corpo: AnalyzeOperationResult

Definizioni

OperationState

Stato dell'operazione.

: string

AnalysisContent

Contenuto estratto dall'analisi.

Nome	Percorso	Tipo	Descrizione
kind	kind	string	Tipo di contenuto.
Markdown	markdown	string	Rappresentazione a scomparso del contenuto.
fields	fields	object	Estrazione dei campi dal contenuto.
categoria	category	string	Categoria di contenuti classificati.
analyzerId	analyzerId	string	L'analizzatore che ha generato questo contenuto.
tipo MIME	mimeType	string	Tipo MIME del contenuto.
path	path	string	Il percorso del contenuto nell'input.

AnalysisResult

Analizzare il risultato dell'operazione.

Nome	Percorso	Tipo	Descrizione
analyzerId	analyzerId	string	L'identificatore univoco dell'analizzatore.
apiVersion	apiVersion	string	La versione dell'API utilizzata per analizzare il documento.
createdAt	createdAt	date-time	La data e l'ora in cui è stato creato il risultato.
Avvertenze	warnings	array of object	Avvertimenti incontrati durante l'analisi del documento.
codice	warnings.code	string
message	warnings.message	string
Contenuto markdown	_markdown	string	Rappresentazione markdown del primo elemento di contenuto per l'accesso rapido.
Contenuto	contents	array of AnalysisContent	Il contenuto estratto.

AnalyzeOperationResult

Stato e risultato dell'operazione di analisi.

Nome	Percorso	Tipo	Descrizione
id	id	string	ID univoco dell'operazione.
stato	status	OperationState	Stato dell'operazione.
codice	error.code	string	Codice di errore.
message	error.message	string	Messaggio di errore.
result	result	AnalysisResult	Analizzare il risultato dell'operazione.