SDK-doel: REST API 2022-08-31 (GA)

REST API-versie 2022-08-31 (GA)

Azure AI Document Intelligence is een cloudservice die machine learning gebruikt om tekst en gestructureerde gegevens uit documenten te analyseren. De Document Intelligence Software Development Kit (SDK) is een set bibliotheken en hulpprogramma's waarmee u eenvoudig Document Intelligence-modellen en -mogelijkheden in uw toepassingen kunt integreren. De Document Intelligence SDK is beschikbaar op verschillende platforms in programmeertalen C#/.NET, Java, JavaScript en Python.

Ondersteunde programmeertalen

Document Intelligence SDK ondersteunt de volgende talen en platforms:

Language → Document Intelligence SDK-versie	Pakket	Ondersteunde API-versie	Platformondersteuning
.NET/C# → 4.0.0 (GA)	NuGet	v3.0	Windows, macOS, Linux, Docker
Java → 4.0.6 (GA)	Maven-opslagplaats	v3.0	Windows, macOS, Linux
JavaScript → 4.0.0 (GA)	npm	v3.0	Browser, Windows, macOS, Linux
Python → 3.2.0 (GA)	PyPI	v3.0	Windows, macOS, Linux

Zie voor meer informatie over andere SDK-versies:

• 2024-02-29 v4.0 (preview)

• 2023-07-31 v3.1 (GA)

• v2.1 (GA)

Ondersteunde clients

Taal	SDK-versie	API-versie	Ondersteunde clients
.NET/C# JavaScript	4.0.0 (GA)	v3.0:2022-08-31 (standaard)	DocumentAnalysisClient DocumentModel Beheer istrationClient
.NET/C# JavaScript	3.1.x	v2.1 (standaard) v2.0	FormRecognizerClient FormTrainingClient
.NET/C# JavaScript	3.0.x	v2.0	FormRecognizerClient FormTrainingClient
Python	3.2.x (GA)	v3.0:2022-08-31 (standaard)	DocumentAnalysisClient DocumentModel Beheer istrationClient
Python	3.1.x	v2.1 (standaard) v2.0	FormRecognizerClient FormTrainingClient
Python	3.0.0	v2.0	FormRecognizerClient FormTrainingClient

Document Intelligence SDK gebruiken in uw toepassingen

De Document Intelligence SDK maakt het gebruik en beheer van de Document Intelligence-service in uw toepassing mogelijk. De SDK bouwt voort op de onderliggende Document Intelligence REST API, zodat u deze API's eenvoudig kunt gebruiken binnen uw programmeertaalparadigma. U gebruikt de Document Intelligence SDK als volgt voor uw voorkeurstaal:

1. Installeer de SDK-clientbibliotheek

C#/.NET

dotnet add package Azure.AI.FormRecognizer --version 4.0.0

Install-Package Azure.AI.FormRecognizer -Version 4.0.0

Java

<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-formrecognizer</artifactId>
<version>4.0.6</version>
</dependency>

implementation("com.azure:azure-ai-formrecognizer:4.0.6")

JavaScript

npm i @azure/ai-form-recognizer@4.0.0

Python

pip install azure-ai-formrecognizer==3.2.0

2. Importeer de SDK-clientbibliotheek in uw toepassing

C#/.NET

using Azure;
using Azure.AI.FormRecognizer.DocumentAnalysis;

Java

import com.azure.ai.formrecognizer.*;
import com.azure.ai.formrecognizer.models.*;
import com.azure.ai.formrecognizer.DocumentAnalysisClient.*;

import com.azure.core.credential.AzureKeyCredential;

JavaScript

const { AzureKeyCredential, DocumentAnalysisClient } = require("@azure/ai-form-recognizer");

Python

from azure.ai.formrecognizer import DocumentAnalysisClient
from azure.core.credentials import AzureKeyCredential

3. Verificatie instellen

Er zijn twee ondersteunde methoden voor verificatie:

• Gebruik een Document Intelligence API-sleutel met AzureKeyCredential van azure.core.credentials.

• Gebruik een tokenreferentie van azure-identity om te verifiëren met Microsoft Entra-id.

Uw API-sleutel gebruiken

Hier vindt u uw Document Intelligence-API-sleutel in Azure Portal:

C#/.NET

//set `<your-endpoint>` and `<your-key>` variables with the values from the Azure portal to create your `AzureKeyCredential` and `DocumentAnalysisClient` instance
string key = "<your-key>";
string endpoint = "<your-endpoint>";
AzureKeyCredential credential = new AzureKeyCredential(key);
DocumentAnalysisClient client = new DocumentAnalysisClient(new Uri(endpoint), credential);

Java

// create your `DocumentAnalysisClient` instance and `AzureKeyCredential` variable
DocumentAnalysisClient client = new DocumentAnalysisClientBuilder()
            .credential(new AzureKeyCredential("<your-key>"))
            .endpoint("<your-endpoint>")
            .buildClient();

JavaScript

// create your `DocumentAnalysisClient` instance and `AzureKeyCredential` variable
async function main() {
    const client = new DocumentAnalysisClient("<your-endpoint>", new AzureKeyCredential("<your-key>"));

Python

# create your `DocumentAnalysisClient` instance and `AzureKeyCredential` variable
    document_analysis_client = DocumentAnalysisClient(endpoint="<your-endpoint>", credential=AzureKeyCredential("<your-key>"))

Een Microsoft Entra-tokenreferentie gebruiken

Notitie

Regionale eindpunten bieden geen ondersteuning voor Microsoft Entra-verificatie. Maak een aangepast subdomein voor uw resource om dit type verificatie te gebruiken.

Autorisatie is het eenvoudigst met behulp van de DefaultAzureCredential. Het biedt een standaardtokenreferentie, op basis van de actieve omgeving, die de meeste Azure-verificatiescenario's kan verwerken.

C#/.NET

U kunt als volgt de DefaultAzureCredential voor .NET-toepassingen verkrijgen en gebruiken:

1. Installeer de Azure Identity-bibliotheek voor .NET:

       dotnet add package Azure.Identity
   

       Install-Package Azure.Identity
   

2. Registreer een Microsoft Entra-toepassing en maak een nieuwe service-principal.

3. Verwijs toegang tot Document Intelligence door de Cognitive Services User rol toe te wijzen aan uw service-principal.

4. Stel de waarden van de client-id, tenant-id en clientgeheim in de Microsoft Entra-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_IDen AZURE_CLIENT_SECRETrespectievelijk.

5. Maak uw DocumentAnalysisClient exemplaar, inclusief het DefaultAzureCredentialvolgende:

   string endpoint = "<your-endpoint>";
   var client = new DocumentAnalysisClient(new Uri(endpoint), new DefaultAzureCredential());
   

ZieDe client verifiëren voor meer informatie.

Java

U kunt als volgt de DefaultAzureCredential voor Java-toepassingen verkrijgen en gebruiken:

1. Installeer de Azure Identity-bibliotheek voor Java:

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.5.3</version>
   </dependency>
   

2. Registreer een Microsoft Entra-toepassing en maak een nieuwe service-principal.

3. Verwijs toegang tot Document Intelligence door de Cognitive Services User rol toe te wijzen aan uw service-principal.

4. Stel de waarden van de client-id, tenant-id en clientgeheim van de Microsoft Entra-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_IDen AZURE_CLIENT_SECRETrespectievelijk.

5. Maak uw DocumentAnalysisClient exemplaar en TokenCredential variabele:

   TokenCredential credential = new DefaultAzureCredentialBuilder().build();
   DocumentAnalysisClient documentAnalysisClient = new DocumentAnalysisClientBuilder()
       .endpoint("{your-endpoint}")
       .credential(credential)
       .buildClient();
   

ZieDe client verifiëren voor meer informatie.

JavaScript

U kunt als volgt de DefaultAzureCredential verkrijgen en gebruiken voor JavaScript-toepassingen:

1. Installeer de Azure Identity-bibliotheek voor JavaScript:

   npm install @azure/identity
   

2. Registreer een Microsoft Entra-toepassing en maak een nieuwe service-principal.

3. Verwijs toegang tot Document Intelligence door de Cognitive Services User rol toe te wijzen aan uw service-principal.

4. Stel de waarden van de client-id, tenant-id en clientgeheim van de Microsoft Entra-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_IDen AZURE_CLIENT_SECRETrespectievelijk.

5. Maak uw DocumentAnalysisClient exemplaar, inclusief het DefaultAzureCredentialvolgende:

   const { DocumentAnalysisClient } = require("@azure/ai-form-recognizer");
   const { DefaultAzureCredential } = require("@azure/identity");
   
   const client = new DocumentAnalysisClient("<your-endpoint>", new DefaultAzureCredential());
   

ZieEen client maken en verifiëren voor meer informatie.

Python

U kunt als volgt de DefaultAzureCredential voor Python-toepassingen verkrijgen en gebruiken.

1. Installeer de Azure Identity-bibliotheek voor Python:

   pip install azure-identity
   

2. Registreer een Microsoft Entra-toepassing en maak een nieuwe service-principal.

3. Verwijs toegang tot Document Intelligence door de Cognitive Services User rol toe te wijzen aan uw service-principal.

4. Stel de waarden van de client-id, tenant-id en clientgeheim van de Microsoft Entra-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_IDen AZURE_CLIENT_SECRETrespectievelijk.

5. Maak uw DocumentAnalysisClient exemplaar, inclusief het DefaultAzureCredentialvolgende:

   from azure.identity import DefaultAzureCredential
   from azure.ai.formrecognizer import DocumentAnalysisClient
   
   credential = DefaultAzureCredential()
   document_analysis_client = DocumentAnalysisClient(
       endpoint="https://<my-custom-subdomain>.cognitiveservices.azure.com/",
       credential=credential
   )
   

ZieDe client verifiëren voor meer informatie.

4. Uw toepassing bouwen

Maak een clientobject om te communiceren met de Document Intelligence SDK en roep vervolgens methoden aan voor dat clientobject om te communiceren met de service. De SDK's bieden zowel synchrone als asynchrone methoden. Probeer een quickstart in een taal van uw keuze voor meer inzicht.

Help-opties

De Microsoft Q & A - en Stack Overflow-forums zijn beschikbaar voor de ontwikkelaarscommunity om vragen te stellen en te beantwoorden over Azure AI Document Intelligence en andere services. Microsoft bewaakt de forums en beantwoordt vragen die de community nog moet beantwoorden. Om er zeker van te zijn dat we uw vraag zien, tagt u deze met azure-form-recognizer.

Volgende stappen

Document Intelligence REST API v3.0 verkennen

Een quickstart voor Document Intelligence uitproberen