Cíl sady SDK: REST API 2022–08–31 (GA)

! [Značka zaškrtnutí funkce Document Intelligence].. /media/yes-icon.png) REST API verze 2022–08–31 (GA)

Azure AI Document Intelligence je cloudová služba, která používá strojové učení k analýze textu a strukturovaných dat z dokumentů. Sada SDK (Document Intelligence Software Development Kit) je sada knihoven a nástrojů, které umožňují snadno integrovat modely a funkce Document Intelligence do vašich aplikací. Sada Document Intelligence SDK je k dispozici na různých platformách v programovacích jazycích C#/.NET, Java, JavaScript a Python.

Podporované programovací jazyky

Sada Document Intelligence SDK podporuje následující jazyky a platformy:

Verze sady Language → Document Intelligence SDK	Balíček	Podporovaná verze rozhraní API	Podpora platformy
.NET/C# → 4.0.0 (GA)	NuGet	v3.0	Windows, macOS, Linux, Docker
Java → 4.0.6 (GA)	Úložiště Maven	v3.0	Windows, macOS, Linux
JavaScript → 4.0.0 (GA)	npm	v3.0	Prohlížeč, Windows, macOS, Linux
Python → 3.2.0 (GA)	PyPI	v3.0	Windows, macOS, Linux

Další informace o dalších verzích sady SDK najdete tady:

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

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

• v2.1 (GA)

Podporovaní klienti

Jazyk	Verze sady SDK	Verze rozhraní API	Podporovaní klienti
JavaScript pro .NET/C#	4.0.0 (GA)	v3.0:2022-08-31 (výchozí)	DocumentAnalysisClient DocumentModelAdministrationClient
JavaScript pro .NET/C#	3.1.x	v2.1 (výchozí) v2.0	FormRecognizerClient FormTrainingClient
JavaScript pro .NET/C#	3.0.x	v2.0	FormRecognizerClient FormTrainingClient
Python	3.2.x (GA)	v3.0:2022-08-31 (výchozí)	DocumentAnalysisClient DocumentModelAdministrationClient
Python	3.1.x	v2.1 (výchozí) v2.0	FormRecognizerClient FormTrainingClient
Python	3.0.0	v2.0	FormRecognizerClient FormTrainingClient

Použití sady Document Intelligence SDK v aplikacích

Sada Document Intelligence SDK umožňuje ve vaší aplikaci používat a spravovat službu Document Intelligence. Sada SDK vychází ze základního rozhraní REST API pro analýzu dokumentů, které vám umožní snadno používat tato rozhraní API v rámci paradigmatu programovacího jazyka. Tady je postup, jak používat sadu Document Intelligence SDK pro preferovaný jazyk:

1. Instalace klientské knihovny SDK

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. Import klientské knihovny SDK do aplikace

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. Nastavení ověřování

Pro ověřování existují dvě podporované metody:

• Použijte klíč rozhraní Document Intelligence API s AzureKeyCredential z azure.core.credentials.

• K ověření pomocí ID Microsoft Entra použijte přihlašovací údaje tokenu z azure-identity.

Použití klíče rozhraní API

Tady najdete klíč rozhraní DOCUMENT Intelligence API na webu Azure Portal:

Důležité

Doporučujeme ověřování Microsoft Entra ID se spravovanými identitami pro prostředky Azure, abyste se vyhnuli ukládání přihlašovacích údajů s aplikacemi, které běží v cloudu.

Pokud používáte klíč rozhraní API, uložte ho bezpečně někam jinam, například ve službě Azure Key Vault. Nezahrnujte klíč rozhraní API přímo do kódu a nikdy ho nevštěvujte veřejně.

Další informace o zabezpečení služeb AI najdete v tématu Ověřování požadavků na služby Azure AI.

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>"))

Použití přihlašovacích údajů tokenu Microsoft Entra

Poznámka:

Regionální koncové body nepodporují ověřování Microsoft Entra. Vytvořte pro prostředek vlastní subdoménu, abyste mohli tento typ ověřování použít.

Autorizace se nejsnadněji používá .DefaultAzureCredential Poskytuje výchozí přihlašovací údaje tokenu založené na spuštěném prostředí, které dokáže zpracovat většinu scénářů ověřování Azure.

C#/.NET

Tady je postup, jak získat a použít DefaultAzureCredential pro aplikace .NET:

1. Nainstalujte knihovnu identit Azure pro .NET:

       dotnet add package Azure.Identity
   

       Install-Package Azure.Identity
   

2. Zaregistrujte aplikaci Microsoft Entra a vytvořte nový instanční objekt.

3. Udělení přístupu k funkci Document Intelligence přiřazením Cognitive Services User role k instančnímu objektu.

4. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta v aplikaci Microsoft Entra jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRETv uvedeném pořadí.

5. Vytvořte instanciDocumentAnalysisClient, včetně:DefaultAzureCredential

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

Další informace najdete v tématu Ověření klienta.

Java

Tady je postup, jak získat a použít DefaultAzureCredential pro aplikace v Javě:

1. Nainstalujte knihovnu Identit Azure pro Javu:

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

2. Zaregistrujte aplikaci Microsoft Entra a vytvořte nový instanční objekt.

3. Udělení přístupu k funkci Document Intelligence přiřazením Cognitive Services User role k instančnímu objektu.

4. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRETv uvedeném pořadí.

5. Vytvořte instanci DocumentAnalysisClient a TokenCredential proměnnou:

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

Další informace najdete v tématu Ověření klienta.

JavaScript

Tady je postup, jak získat a použít DefaultAzureCredential pro javascriptové aplikace:

1. Nainstalujte knihovnu Identit Azure pro JavaScript:

   npm install @azure/identity
   

2. Zaregistrujte aplikaci Microsoft Entra a vytvořte nový instanční objekt.

3. Udělení přístupu k funkci Document Intelligence přiřazením Cognitive Services User role k instančnímu objektu.

4. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRETv uvedeném pořadí.

5. Vytvořte instanciDocumentAnalysisClient, včetně:DefaultAzureCredential

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

Další informace najdete v tématu Vytvoření a ověření klienta.

Python

Tady je postup, jak získat a použít DefaultAzureCredential pro aplikace Pythonu.

1. Nainstalujte knihovnu Identit Azure pro Python:

   pip install azure-identity
   

2. Zaregistrujte aplikaci Microsoft Entra a vytvořte nový instanční objekt.

3. Udělení přístupu k funkci Document Intelligence přiřazením Cognitive Services User role k instančnímu objektu.

4. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRETv uvedeném pořadí.

5. Vytvořte instanciDocumentAnalysisClient, včetně:DefaultAzureCredential

   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
   )
   

Další informace najdete v tématu Ověření klienta.

4. Sestavení aplikace

Vytvořte objekt klienta pro interakci se sadou Document Intelligence SDK a potom volejte metody na daném objektu klienta pro interakci se službou. Sady SDK poskytují synchronní i asynchronní metody. Další přehled najdete v rychlém startu v jazyce podle vašeho výběru.

Možnosti nápovědy

Fóra Microsoft Q &A a Stack Overflow jsou k dispozici pro komunitu vývojářů, kde se můžete ptát a odpovídat na otázky týkající se funkce Document Intelligence a dalších služeb Azure AI. Microsoft monitoruje fóra a odpovídá na otázky, na které má komunita odpověď. Abychom měli jistotu, že vidíte vaši otázku, označte ji značkou azure-form-recognizer.

Další kroky

Prozkoumání rozhraní REST API funkce Document Intelligence v3.0

Rychlý start k funkci Document Intelligence