Azure AI-inhoudskennis (preview)

Azure AI-inhoudsbegrip extraheert inhoud en velden uit multimodale invoer, waaronder documenten, afbeeldingen, audio en video met behulp van ai-analyse.

Deze connector is beschikbaar in de volgende producten en regio's:

Service	Klasse	Regions
Copilot Studio	Standard	Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)
Logic-apps	Standard	Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD)
Power Apps	Standard	Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)
Power Automate	Standard	Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)

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

Connectormetagegevens
Publisher	Microsoft
Website	https://aka.ms/content-understanding
Privacybeleid	https://privacy.microsoft.com
Categorieën	AI

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:


API-sleutel	Geef de resourcenaam en API-sleutel van Content Understanding op.	Alle regio's	Deelbaar
Beheerde identiteit van Logic Apps	Een verbinding maken met behulp van een door LogicApps beheerde identiteit	Alleen LOGICAPPS	Deelbaar
Geïntegreerde Microsoft Entra ID	Microsoft Entra-id gebruiken voor toegang	Alle regio's	Niet deelbaar
Standaard [AFGESCHAFT]	Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.	Alle regio's	Niet deelbaar

API-sleutel

Verificatie-id: keyBasedAuth

Van toepassing: Alle regio's

Geef de resourcenaam en API-sleutel van Content Understanding op.

Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs

Name	Typ	Description	Required
API-sleutel	beveiligde string	Api-sleutel voor inhoudskennis	True
Eindpunt-URL	string	Eindpunt-URL voor inhoudskennis (voorbeeld: `https://your-resource.cognitiveservices.azure.com/`)	True

Beheerde identiteit van Logic Apps

Verificatie-id: managedIdentityAuth

Van toepassing: alleen LOGICAPPS

Een verbinding maken met behulp van een door LogicApps beheerde identiteit

Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs

Name	Typ	Description	Required
Beheerde identiteit van LogicApps	managedIdentity	Aanmelden met een beheerde identiteit van Logic Apps	True
Eindpunt-URL	string	Eindpunt-URL voor inhoudskennis (voorbeeld: `https://your-resource.cognitiveservices.azure.com/`)	True

Microsoft Entra ID geïntegreerd

Verificatie-id: oauth

Van toepassing: Alle regio's

Microsoft Entra-id gebruiken voor toegang

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Name	Typ	Description	Required
Eindpunt-URL	string	Eindpunt-URL voor inhoudskennis (voorbeeld: `https://your-resource.cognitiveservices.azure.com/`)	True

Standaard [AFGESCHAFT]

Van toepassing: Alle regio's

Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Name	Typ	Description	Required
API-sleutel	beveiligde string	Api-sleutel voor inhoudskennis	True
Eindpunt-URL	string	Eindpunt-URL voor inhoudskennis (voorbeeld: `https://your-resource.cognitiveservices.azure.com/`)	True

Beperkingslimieten

Name	Aanroepen	Verlengingsperiode
API-aanroepen per verbinding	1200	60 seconden

Acties

Inhoud analyseren

Extraheer inhoud en velden uit multimodale invoer (documenten, afbeeldingen, audio, video) met behulp van een analyse. De bewerking wordt asynchroon uitgevoerd en retourneert het resultaat wanneer deze is voltooid.

Inhoud analyseren

Bewerkings-id:: AnalyzeContent

Parameters

Name	Sleutel	Vereist	Type	Description
Analyse-ID	analyzerId	True	string	De unieke id van de analyse die moet worden gebruikt voor analyse.
Bestandsinhoud	inputFileContent		byte	Te analyseren bestandsinhoud (document, afbeelding, audio of video). Base64-gecodeerd. Kan niet worden gecombineerd met `Input File URL` of `inputs`.
URL van invoerbestand	inputFileUrl		string	URL van het bestand dat moet worden geanalyseerd. Kan niet worden gecombineerd met `File Content` of `inputs`.
Bereik	range		string	Paginabereik dat moet worden geanalyseerd (bijvoorbeeld 1-3,5,9-). Alleen van toepassing bij gebruik `File Content` of `Input File URL`. Als deze niet is ingesteld, worden alle pagina's verwerkt.
Mime-type bestand	inputFileMimeType		string	MIME-type van de bestandsinhoud (bijvoorbeeld application/pdf, image/jpeg). Optioneel bij gebruik `File Content`.
URL	url		string	URL van de invoer die moet worden geanalyseerd. Er mag slechts één url of data worden opgegeven.
Gegevens	data		byte	Base64-gecodeerde binaire inhoud van de invoer die geanalyseerd moet worden. Er mag slechts één url of data worden opgegeven.
naam	name		string	Naam van de input.
MIME-type	mimeType		string	Het MIME-type van de invoerinhoud. Bijvoorbeeld toepassing/pdf, afbeelding/jpeg, enzovoort.
range	range		string	Bereik van de invoer die moet worden geanalyseerd (bijvoorbeeld 1-3,5,9-). Documentinhoud maakt gebruik van paginanummers op basis van 1.
Verwerkingslocatie	processingLocation		string	De locatie waar de gegevens verwerkt kunnen worden. Standaard staat hij op globaal.
String codering	stringEncoding		string	Het string encoderingsformaat voor content loopt in het antwoord. Mogelijke waarden zijn 'codePoint', 'utf16' en `utf8`.

Retouren

Status en resultaat van de analysebewerking.

Lichaam: AnalyzeOperationResult

Definities

OperationState

Status van de operatie.

: string

AnalysisContent

Geëxtraheerde inhoud uit analyse.

Name	Pad	Type	Description
kind	kind	string	Content-achtig.
markdown	markdown	string	Markdown-weergave van de inhoud.
fields	fields	object	Geëxtraheerde velden uit de inhoud.
Categorie	category	string	Categorie geclassificeerde inhoud.
analyzerId	analyzerId	string	De analyzer die deze inhoud genereerde.
mimeType	mimeType	string	Het MIME-type van de inhoud.
path	path	string	Het pad van de inhoud in de invoer.

AnalysisResult

Bewerkingsresultaat analyseren.

Name	Pad	Type	Description
analyzerId	analyzerId	string	De unieke identificatie van de analyzer.
apiVersion	apiVersion	string	De versie van de API die wordt gebruikt om het document te analyseren.
createdAt	createdAt	date-time	De datum en tijd waarop het resultaat is gemaakt.
Waarschuwingen	warnings	array of object	Waarschuwingen tegengekomen tijdens het analyseren van het document.
code	warnings.code	string
message	warnings.message	string
Markdown-inhoud	_markdown	string	Markdown-weergave van het eerste inhoudsitem voor snelle toegang.
contents	contents	array of AnalysisContent	De geëxtraheerde inhoud.

AnalyzeOperationResult

Status en resultaat van de analysebewerking.

Name	Pad	Type	Description
id	id	string	De unieke ID van de bewerking.
status	status	OperationState	Status van de operatie.
code	error.code	string	Foutcode.
message	error.message	string	Foutmelding.
result	result	AnalysisResult	Bewerkingsresultaat analyseren.