Condividi tramite


Destinazione SDK: API REST v4.0 (GA)

Segno di spunta di Informazioni sui documentiAPI REST versione 2024-11-30 GA

Informazioni sui documenti di Azure AI è un servizio cloud che usa l'apprendimento automatico per analizzare testo e dati strutturati dai documenti. Document Intelligence Software Development Kit (SDK) è un set di librerie e strumenti che consentono di integrare facilmente modelli e funzionalità di Document Intelligence nelle applicazioni. L'SDK di Informazioni sui documenti è disponibile in diverse piattaforme nei linguaggi di programmazione C#/.NET, Java, JavaScript, e Python.

Linguaggi di programmazione supportati

L'SDK di Informazioni sui documenti supporta i linguaggi e le piattaforme seguenti:

Linguaggio → Versione SDK Informazioni sui documenti Pacchetto Versione API supportata Piattaforme supportate
.NET/C# → 1.0.0 (GA) NuGet 2024-11-30 (GA) Windows, macOS, Linux, Docker
Java → 1.0.0 (GA) Repository Maveny 2024-11-30 (GA) Windows, macOS, Linux
JavaScript → 1.0.0 (GA) npm 2024-11-30 (GA) Browser, Windows, macOS, Linux
Python → 1.0.0b4 (anteprima) PyPI 2024-11-30 (GA) Windows, macOS, Linux

Per altre informazioni sulle altre versioni SDK, vedere:

Client supportati

Le tabelle seguenti presentano la correlazione tra ogni versione SDK e le versioni API supportate del servizio Informazioni sui documenti.

Lingua Alias SDK Versione API (predefinita) Client supportati
.NET/C# 1.0.0-beta.2 (anteprima) v4.0 (GA) Disponibilità generale 2024-11-30 DocumentIntelligenceClient
DocumentIntelligenceAdministrationClient
.NET/C# 4.1.0 v3.1 più recente (disponibilità generale) 31-07-2023 DocumentAnalysisClient
DocumentModelAdministrationClient
.NET/C# 4.0.0 v3.0 (disponibilità generale) 31-08-2022 DocumentAnalysisClient
DocumentModelAdministrationClient
.NET/C# 3.1.x v2.1 v2.1 FormRecognizerClient
FormTrainingClient
.NET/C# 3.0.x v2.0 v2.0 FormRecognizerClient
FormTrainingClient

Usare l'SDK di Informazioni sui documenti nelle proprie applicazioni

L'SDK di Informazioni sui documento consente l'uso e la gestione del servizio di Informazioni sui documenti nella propria applicazione. L'SDK si basa sull'API REST di Informazioni sui documenti sottostante, che consente di usare facilmente tali API all'interno del paradigma del linguaggio di programmazione. Ecco come usare l'SDK di Informazioni sui documenti per il linguaggio preferito:

1. Installare la libreria client SDK

dotnet add package Azure.AI.DocumentIntelligence --prerelease
Install-Package Azure.AI.FormRecognizer -Version 1.0.0-beta.3

2. Importare la libreria client SDK nell'applicazione

using Azure;
using Azure.AI.DocumentIntelligence;

3. Configurare l'autenticazione

Per l'autenticazione sono supportati due metodi:

Usare la chiave API

Ecco dove trovare la chiave API di Informazioni sui documenti nel portale di Azure:

Screenshot della posizione di chiavi ed endpoint nel portale di Azure.

Importante

Si consiglia l'autenticazione di Microsoft Entra ID insieme alle identità gestite per le risorse di Azure al fine di evitare di archiviare le credenziali con le applicazioni eseguite nel cloud.

Se si usa una chiave API, archiviarla in modo sicuro in un'altra posizione, ad esempio in Azure Key Vault. Non includere la chiave API direttamente nel codice e non esporla mai pubblicamente.

Per altre informazioni sulla sicurezza dei servizi di intelligenza artificiale, vedere Autenticare le richieste in Servizi di Azure AI.


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

Usare credenziali token di Microsoft Entra

Nota

Gli endpoint regionali non supportano l'autenticazione tramite Microsoft Entra. Creare un sottodominio personalizzato per la risorsa per usare questo tipo di autenticazione.

L'autorizzazione risulta più semplice se si usa DefaultAzureCredential. Fornisce una credenziale del token predefinita, basata sull'ambiente in esecuzione, in grado di gestire la maggior parte degli scenari di autenticazione di Azure.

Ecco come acquisire e usare DefaultAzureCredential per le applicazioni .NET:

  1. Installare la libreria di identità di Azure per .NET:

        dotnet add package Azure.Identity
    
        Install-Package Azure.Identity
    
  2. Registrare un'applicazione Microsoft Entra e creare una nuova entità servizio.

  3. Concedere l'accesso a Informazioni sui documenti assegnando il ruolo Cognitive Services User all'entità servizio.

  4. Impostare i valori dell'ID client, dell'ID tenant e del segreto client nell'applicazione Microsoft Entra come variabili di ambiente, rispettivamente AZURE_CLIENT_ID, AZURE_TENANT_ID e AZURE_CLIENT_SECRET.

  5. Creare l'istanza di DocumentIntelligenceClient includendo DefaultAzureCredential:

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

Per altre informazioni, vedere Autenticare il client.

4. Compilare l'applicazione

Creare un oggetto client per interagire con l'SDK di Informazioni sui documenti e quindi chiamare i metodi su tale oggetto client per interagire con il servizio. Gli SDK forniscono metodi sincroni e asincroni. Per altre informazioni, provare a eseguire una guida di avvio rapido relativa al linguaggio preferito.

Opzioni di assistenza

I forum Microsoft Q&A e Stack Overflow sono a disposizione della community di sviluppatori per porre domande e rispondere a domande su Informazioni sui documenti di Azure AI e altri servizi. Microsoft monitora i forum e risponde alle domande a cui la community deve ancora rispondere. Per avere la certezza che la domanda posta verrà visualizzata, usare i tag seguenti.

  • Microsoft Q&A: Azure AI Document Intelligence.

  • Stack Overflow: azure-ai-document-intelligence.

Passaggi successivi