Destinazione SDK: API REST 2023-07-31 (GA)
API REST versione 2023-07-31 (GA)
Intelligence sui documenti di Intelligenza artificiale di Azure è un servizio cloud che usa Machine Learning per analizzare il testo e i 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. Document Intelligence SDK è disponibile su più piattaforme nei linguaggi di programmazione C#/.NET, Java, JavaScript e Python.
Linguaggi di programmazione supportati
Document Intelligence SDK supporta i linguaggi e le piattaforme seguenti:
| Linguaggio → versione di Document Intelligence SDK | Pacchetto | Versione dell'API supportata | Piattaforme supportate |
|---|---|---|---|
| .NET/C# → versione più recente (GA) | NuGet | 2023-07-31 (GA) | |
| Java → versione più recente (GA) | Repository Maven | 2023-07-31 (GA) | Windows, macOS, Linux |
| JavaScript → versione più recente (GA) | npm | 2023-07-31 (GA) | Browser, Windows, macOS, Linux |
| Python → versione più recente (GA) | PyPI | 2023-07-31 (GA) | Windows, macOS, Linux |
Per altre informazioni su altre versioni dell'SDK, vedere:
Client supportati
Le tabelle seguenti presentano la correlazione tra ogni versione dell'SDK le versioni API supportate del servizio Document Intelligence.
| Lingua | Versione dell'SDK | Versione API (impostazione predefinita) | Client supportati |
|---|---|---|---|
| .NET/C# 4.1.0 | v3.1 latest (GA) | 2023-07-31 | DocumentAnalysisClient DocumentModelAdministrationClient |
| .NET/C# 4.0.0 | v3.0 (GA) | 2022-08-31 | 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 Document Intelligence SDK nelle applicazioni
Document Intelligence SDK consente l'uso e la gestione del servizio Document Intelligence nell'applicazione. L'SDK si basa sull'API REST di Document Intelligence sottostante che consente di usare facilmente tali API all'interno del paradigma del linguaggio di programmazione. Ecco come usare Document Intelligence SDK per il linguaggio preferito:
1. Installare la libreria client SDK
dotnet add package Azure.AI.FormRecognizer --version 4.1.0
Install-Package Azure.AI.FormRecognizer -Version 4.1.0
2. Importare la libreria client SDK nell'applicazione
using Azure;
using Azure.AI.FormRecognizer.DocumentAnalysis;
3. Configurare l'autenticazione
Esistono due metodi supportati per l'autenticazione:
Usare una chiave API di Document Intelligence con AzureKeyCredential da azure.core.credentials.
Usare le credenziali del token da azure-identity per eseguire l'autenticazione con Microsoft Entra ID.
Usare la chiave API
Ecco dove trovare la chiave API di Intelligence per i documenti nella portale di Azure:
//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);
Usare una credenziale del token Microsoft Entra
Nota
Gli endpoint a livello di area non supportano l'autenticazione di 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:
Installare la libreria di identità di Azure per .NET:
dotnet add package Azure.IdentityInstall-Package Azure.IdentityRegistrare un'applicazione Microsoft Entra e creare una nuova entità servizio.
Concedere l'accesso a Document Intelligence assegnando il ruolo all'entità
Cognitive Services Userservizio.Impostare i valori dell'ID client, dell'ID tenant e del segreto client nell'applicazione Microsoft Entra rispettivamente come variabili di ambiente:
AZURE_CLIENT_ID,AZURE_TENANT_IDeAZURE_CLIENT_SECRET.Creare l'istanza di
DocumentAnalysisClientincludendoDefaultAzureCredential:string endpoint = "<your-endpoint>"; var client = new DocumentAnalysisClient(new Uri(endpoint), new DefaultAzureCredential());
Per altre informazioni, vedereAutenticare il client.
4. Compilare l'applicazione
Creare un oggetto client per interagire con Document Intelligence SDK 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 di Microsoft Q & A e Stack Overflow sono disponibili per la community di sviluppatori per porre e rispondere a domande su Intelligence sui documenti di Intelligenza artificiale di Azure e su altri servizi. Microsoft monitora i forum e risponde alle domande a cui la community deve ancora rispondere. Per assicurarsi che venga visualizzata la domanda, contrassegnarla con azure-form-recognizer.