Condividi tramite

Destinazione SDK: API REST 2024-02-29-preview

  • Articolo

Importante

  • Le versioni di anteprima pubblica di Document Intelligence consentono l'accesso anticipato alle funzionalità in fase di sviluppo attivo.
  • Le funzionalità, gli approcci e i processi possono cambiare prima della disponibilità generale, a seconda del feedback degli utenti.
  • La versione di anteprima pubblica delle librerie client di Document Intelligence per impostazione predefinita è l'API REST versione 2024-02-29-preview.
  • L'anteprima pubblica versione 2024-02-29-preview è attualmente disponibile solo nelle aree di Azure seguenti:
  • Stati Uniti orientali
  • Stati Uniti occidentali2
  • Europa occidentale

Segno di spunta di Intelligence sui documentiAPI REST versione 2024-02-29-preview

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# → 1.0.0-beta.2 (anteprima) NuGet 2024-02-29 (anteprima) Windows, macOS, Linux, Docker
Java → 1.0.0-beta.2 (anteprima) Repository Maven 2024-02-29 (anteprima) Windows, macOS, Linux
JavaScript → 1.0.0-beta.2 (anteprima) npm 2024-02-29 (anteprima) Browser, Windows, macOS, Linux
Python → 1.0.0b2 (anteprima) PyPI 2024-02-29 (anteprima) 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 Alias SDK Versione API (impostazione predefinita) Client supportati
.NET/C# 1.0.0-beta.2 (anteprima) v4.0 (anteprima) Anteprima 2024-02-29 DocumentIntelligenceClient
DocumentIntelligence Amministrazione istrationClient
.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.DocumentIntelligence --version 1.0.0-beta.2

Install-Package Azure.AI.FormRecognizer -Version 1.0.0-beta.2

2. Importare la libreria client SDK nell'applicazione

using Azure;
using Azure.AI.DocumentIntelligence;

3. Configurare l'autenticazione

Esistono due metodi supportati per l'autenticazione:

Usare la chiave API

Ecco dove trovare la chiave API di Intelligence per i documenti nella portale di Azure:

Screenshot delle chiavi e della posizione dell'endpoint nella portale di Azure. 


//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 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:

  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 Document Intelligence assegnando il ruolo all'entità Cognitive Services User servizio.

  4. 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_IDe 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, 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 Microsoft Q&A forum 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, usare i tag seguenti per visualizzare la domanda.

  • Microsoft Q&A: Azure AI Document Intelligence.

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

Passaggi successivi

Esplorare le operazioni REST di Document Intelligence 2023-10-31-rest.