Share via

SDK hedefi: REST API 2023-07-31 (GA)

  • Makale

Belge Yönetim Bilgileri onay işaretiREST API sürüm 2023-07-31 (GA)

Azure AI Document Intelligence, belgelerden metin ve yapılandırılmış verileri analiz etmek için makine öğrenmesini kullanan bir bulut hizmetidir. Belge Zekası yazılım geliştirme seti (SDK), Belge Zekası modellerini ve özelliklerini uygulamalarınızla kolayca tümleştirmenizi sağlayan bir kitaplık ve araç kümesidir. Belge Zekası SDK'sı C#/.NET, Java, JavaScript ve Python programlama dillerindeki platformlarda kullanılabilir.

Desteklenen programlama dilleri

Belge Zekası SDK'sı aşağıdaki dilleri ve platformları destekler:

Dil → Belge Yönetim Bilgileri SDK sürümü Paket Desteklenen API sürümü Platform desteği
.NET/C# → en son (GA) NuGet 2023-07-31 (GA)
Java → en son (GA) Maven deposu 2023-07-31 (GA) Windows, macOS, Linux
JavaScript → en son (GA) npm 2023-07-31 (GA) Tarayıcı, Windows, macOS, Linux
Python → en son (GA) PyPI 2023-07-31 (GA) Windows, macOS, Linux

Diğer SDK sürümleri hakkında daha fazla bilgi için bkz:

Desteklenen İstemciler

Aşağıdaki tablolarda her SDK sürümü arasındaki bağıntı, Belge Zekası hizmetinin desteklenen API sürümleriyle gösterilir.

Dil SDK sürümü API sürümü (varsayılan) Desteklenen istemciler
.NET/C# 4.1.0 v3.1 en son (GA) 2023-07-31 DocumentAnalysisClient
DocumentModel Yönetici istrationClient
.NET/C# 4.0.0 v3.0 (GA) 2022-08-31 DocumentAnalysisClient
DocumentModel Yönetici istrationClient
.NET/C# 3.1.x v2.1 v2.1 FormRecognizerClient
FormTrainingClient
.NET/C# 3.0.x v2.0 v2.0 FormRecognizerClient
FormTrainingClient

Uygulamalarınızda Belge Zekası SDK'sı kullanma

Belge Yönetim Bilgileri SDK'sı, uygulamanızda Belge Yönetim Bilgileri hizmetinin kullanılmasını ve yönetilmesini sağlar. SDK, temel alınan Belge Zekası REST API'sini temel alır ve bu API'leri programlama dili paradigması içinde kolayca kullanmanıza olanak sağlar. Tercih ettiğiniz dil için Belge Zekası SDK'sını şu şekilde kullanabilirsiniz:

1. SDK istemci kitaplığını yükleme

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

Install-Package Azure.AI.FormRecognizer -Version 4.1.0

2. SDK istemci kitaplığını uygulamanıza aktarma

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

3. Kimlik doğrulamayı ayarlama

Kimlik doğrulaması için desteklenen iki yöntem vardır:

API anahtarınızı kullanma

Azure portalında Belge Zekası API anahtarınızı burada bulabilirsiniz:

Azure portalında anahtarların ve uç nokta konumunun ekran görüntüsü. 


//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);

Microsoft Entra belirteci kimlik bilgilerini kullanma

Not

Bölgesel uç noktalar Microsoft Entra kimlik doğrulamayı desteklemez. Bu kimlik doğrulama türünü kullanmak için kaynağınız için özel bir alt etki alanı oluşturun.

Yetkilendirme, kullanarak en kolayıdır DefaultAzureCredential. Azure kimlik doğrulama senaryolarının çoğunu işleyebilen, çalışan ortamı temel alan varsayılan bir belirteç kimlik bilgisi sağlar.

.NET uygulamaları için DefaultAzureCredential'ı şu şekilde edinip kullanabilirsiniz:

  1. .NET için Azure Kimlik kitaplığını yükleyin:

        dotnet add package Azure.Identity

        Install-Package Azure.Identity

  2. Bir Microsoft Entra uygulaması kaydedin ve yeni bir hizmet sorumlusu oluşturun.

  3. Rolü hizmet sorumlunuza atayarak Cognitive Services User Belge Yönetim Bilgilerine erişim verin.

  4. Microsoft Entra uygulamasında istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini sırasıyla , AZURE_TENANT_IDve AZURE_CLIENT_SECRETortam değişkenleri AZURE_CLIENT_IDolarak ayarlayın.

  5. örneğinizi oluşturun ve örneğinizi DocumentAnalysisClientDefaultAzureCredentialoluşturun:

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

Daha fazla bilgi için bkz. İstemcinin kimliğini doğrulama.

4. Uygulamanızı derleme

Belge Yönetim Bilgileri SDK'sı ile etkileşim kurmak için bir istemci nesnesi oluşturun ve ardından hizmetle etkileşim kurmak için bu istemci nesnesinde yöntemleri çağırın. SDK'lar hem zaman uyumlu hem de zaman uyumsuz yöntemler sağlar. Daha fazla içgörü için, seçtiğiniz dilde bir hızlı başlangıç deneyin.

Yardım seçenekleri

Microsoft Soru-Cevap ve Stack Overflow forumları, geliştirici topluluğunun Azure AI Belge Zekası ve diğer hizmetler hakkında sorular sorması ve yanıtlaması için kullanılabilir. Microsoft forumları izler ve topluluğun henüz yanıtlamadığı soruları yanıtlar. Sorunuzu gördüğümüzden emin olmak için ile azure-form-recognizeretiketleyin.

Sonraki adımlar

Belge Zekası REST API 2023-07-31 işlemlerini keşfedin.