Azure AI-tartalomértés (előzetes verzió)

Azure AI Content Understanding AI-alapú elemzéssel kinyeri a tartalmakat és mezőket a multimodális bemenetekből, beleértve a dokumentumokat, képeket, hangokat és videókat.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Osztály	Regions
Copilot Studio	Standard	Az összes Power Automate régió kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket: - Azure Government régiók - Azure Kína régiói - Amerikai Védelmi Minisztérium (DoD)
Power Apps	Standard	Az összes Power Apps régió kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Automate	Standard	Az összes Power Automate régió kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)

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

Összekötő metaadatai
Publisher	Microsoft
Webhely	https://aka.ms/content-understanding
Adatvédelmi irányelvek	https://privacy.microsoft.com
Categories	AI

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


API-kulcs	Adja meg a Tartalomértő erőforrás nevét és API-kulcsát.	Minden régió	Megosztható
Felügyelt Logic Apps-identitás	Kapcsolat létrehozása LogicApps Managed Identity használatával	Csak LOGICAPPS	Megosztható
Integrált Microsoft Entra-azonosító	Hozzáférés a Microsoft Entra-azonosítóval	Minden régió	Nem osztható meg
Alapértelmezett [ELAVULT]	Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.	Minden régió	Nem osztható meg

API-kulcs

Hitelesítési azonosító: keyBasedAuth

Alkalmazható: Minden régió

Adja meg a Tartalomértő erőforrás nevét és API-kulcsát.

Ez megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a kapcsolat is meg van osztva. További információ: Összekötők áttekintése vászonalapú alkalmazásokhoz – Power Apps | Microsoft Docs

Name	Típus	Leírás	Szükséges
API-kulcs	securestring	Tartalomértés API-kulcs	True
Végpont URL	karakterlánc	Tartalomértés végpont URL-címe (példa: `https://your-resource.cognitiveservices.azure.com/`)	True

Felügyelt Logic Apps-identitás

Hitelesítési azonosító: managedIdentityAuth

Alkalmazható: csak LOGICAPPS

Kapcsolat létrehozása LogicApps Managed Identity használatával

Name	Típus	Leírás	Szükséges
LogicApps felügyelt identitás	managedIdentity	Bejelentkezés felügyelt Logic Apps-identitással	True
Végpont URL	karakterlánc	Tartalomértés végpont URL-címe (példa: `https://your-resource.cognitiveservices.azure.com/`)	True

Microsoft Entra ID integrált

Hitelesítési azonosító: oauth

Alkalmazható: Minden régió

Hozzáférés a Microsoft Entra-azonosítóval

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Name	Típus	Leírás	Szükséges
Végpont URL	karakterlánc	Tartalomértés végpont URL-címe (példa: `https://your-resource.cognitiveservices.azure.com/`)	True

Alapértelmezett [ELAVULT]

Alkalmazható: Minden régió

Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Name	Típus	Leírás	Szükséges
API-kulcs	securestring	Tartalomértés API-kulcs	True
Végpont URL	karakterlánc	Tartalomértés végpont URL-címe (példa: `https://your-resource.cognitiveservices.azure.com/`)	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	1200	60 másodperc

Műveletek

Tartalom elemzése

Tartalom és mezők kinyerése többmodális bemenetből (dokumentumok, képek, hang, videó) egy elemző használatával. A művelet aszinkron módon fut, és befejezett állapotban adja vissza az eredményt.

Tartalom elemzése

Műveletazonosító:: AnalyzeContent

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Elemző azonosítója	analyzerId	True	string	Az elemzéshez használni kívánt elemző egyedi azonosítója.
Fájl tartalma	inputFileContent		byte	Elemezendő fájltartalom (dokumentum, kép, hang vagy videó). Base64 kódolású. Nem kombinálható a következővel `Input File URL` : vagy `inputs`.
Bemeneti fájl URL-címe	inputFileUrl		string	Az elemezni kívánt fájl URL-címe. Nem kombinálható a következővel `File Content` : vagy `inputs`.
Tartomány	range		string	Elemezendő oldaltartomány (pl. 1-3,5,9-). Csak a használat vagy `File ContentInput File URL`a . Ha nincs beállítva, a rendszer minden lapot feldolgoz.
Fájl MIME-típusa	inputFileMimeType		string	A fájltartalom MIME-típusa (például alkalmazás/pdf, kép/jpeg). Nem kötelező a használata `File Content`.
url	url		string	Az elemezni kívánt bemenet URL-címe. Csak egy URL-t vagy adatot kell megadni.
adat	data		byte	A bemenet Base64-et kódolt bináris tartalma az elemzéshez. Csak egy URL-t vagy adatot kell megadni.
name	name		string	A bemenet neve.
MIME-típus	mimeType		string	A bemeneti tartalom MIME-típusa. Például alkalmazás/pdf, kép/jpeg stb.
tartomány	range		string	Az elemezni kívánt bemenet tartománya (pl. 1-3,5,9-). A dokumentumtartalmak 1-alapú oldalszámokat használnak.
Feldolgozási hely	processingLocation		string	Az a hely, ahol az adatokat feldolgozhatják. Alapértelmezett globálisra vált.
Karakterlánc kódolás	stringEncoding		string	A tartalom stringkódolási formátuma átterjed a válaszban. Lehetséges értékek a 'codePoint', 'utf16' és `utf8`.

Válaszok

Az elemzési művelet állapota és eredménye.

Törzs: AnalyzeOperationResult

Definíciók

OperationState

A művelet állapota.

: string

AnalysisContent

Kinyert tartalom az elemzésből.

Name	Elérési út	Típus	Description
kind	kind	string	Elégedett típus.
markdown	markdown	string	A tartalom ártalmatlan ábrázolása.
Mezők	fields	object	A tartalomból kihúzott mezők.
kategória	category	string	Osztályozott tartalom kategóriá.
analyzerId	analyzerId	string	Az elemző, amely ezt a tartalmat generálta.
mimeType	mimeType	string	A tartalom MIME-típusa.
elérési út	path	string	A tartalom útvonala a bemenetben.

AnalysisResult

A művelet eredményének elemzése.

Name	Elérési út	Típus	Description
analyzerId	analyzerId	string	Az analizátor egyedi azonosítója.
apiVersion	apiVersion	string	Az API verziója, amelyet a dokumentum elemzéséhez használnak.
createdAt	createdAt	date-time	Az eredmény létrehozásának dátuma és időpontja.
Figyelmeztetések	warnings	array of object	Figyelmeztetések, amelyekkel a dokumentum elemzése közben találkoztak.
kód	warnings.code	string
üzenet	warnings.message	string
Markdown-tartalom	_markdown	string	Az első tartalomelem Markdown-ábrázolása a gyors hozzáférés érdekében.
contents	contents	array of AnalysisContent	A kinyert tartalom.

AnalyzeOperationResult

Az elemzési művelet állapota és eredménye.

Name	Elérési út	Típus	Description
id	id	string	A művelet egyedi azonosítója.
állapot	status	OperationState	A művelet állapota.
kód	error.code	string	Hibakód.
üzenet	error.message	string	Hibaüzenet.
result	result	AnalysisResult	A művelet eredményének elemzése.