Target SDK: REST API 2022–08–31 (GA)
! [Tanda centang Kecerdasan Dokumen].. /media/yes-icon.png) REST API versi 2022–08–31 (GA)
Azure AI Document Intelligence adalah layanan cloud yang menggunakan pembelajaran mesin untuk menganalisis teks dan data terstruktur dari dokumen. Kit pengembangan perangkat lunak (SDK) Kecerdasan Dokumen adalah sekumpulan pustaka dan alat yang memungkinkan Anda untuk dengan mudah mengintegrasikan model dan kemampuan Kecerdasan Dokumen ke dalam aplikasi Anda. SDK Kecerdasan Dokumen tersedia di seluruh platform dalam bahasa pemrograman C#/.NET, Java, JavaScript, dan Python.
Bahasa pemrograman yang didukung
SDK Kecerdasan Dokumen mendukung bahasa dan platform berikut:
| Versi SDK Kecerdasan Dokumen → Bahasa | Paket | Versi API yang didukung | Dukungan platform |
|---|---|---|---|
| .NET/C# → 4.0.0 (GA) | NuGet | v3.0 | Windows, macOS, Linux, Docker |
| Java → 4.0.6 (GA) | Repositori Maven | v3.0 | Windows, macOS, Linux |
| JavaScript → 4.0.0 (GA) | npm | v3.0 | Browser, Windows, macOS, Linux |
| Python → 3.2.0 (GA) | PyPI | v3.0 | Windows, macOS, Linux |
Untuk informasi selengkapnya tentang versi SDK lainnya, lihat:
Klien yang didukung
| Bahasa | Versi SDK | versi API | Klien yang Didukung |
|---|---|---|---|
| .NET/C# JavaScript |
4.0.0 (GA) | v3.0:2022-08-31 (default) | DocumentAnalysisClient DocumentModelAdministrationClient |
| .NET/C# JavaScript |
3.1.x | v2.1 (default) v2.0 |
FormRecognizerClient FormTrainingClient |
| .NET/C# JavaScript |
3.0.x | v2.0 | FormRecognizerClient FormTrainingClient |
| Python | 3.2.x (GA) | v3.0:2022-08-31 (default) | DocumentAnalysisClient DocumentModelAdministrationClient |
| Python | 3.1.x | v2.1 (default) v2.0 |
FormRecognizerClient FormTrainingClient |
| Python | 3.0.0 | v2.0 | FormRecognizerClient FormTrainingClient |
Menggunakan SDK Kecerdasan Dokumen di aplikasi Anda
SDK Kecerdasan Dokumen memungkinkan penggunaan dan pengelolaan layanan Kecerdasan Dokumen di aplikasi Anda. SDK dibangun pada REST API Kecerdasan Dokumen yang mendasar yang memungkinkan Anda menggunakan API tersebut dengan mudah dalam paradigma bahasa pemrograman Anda. Berikut cara Anda menggunakan SDK Kecerdasan Dokumen untuk bahasa pilihan Anda:
1. Instal pustaka klien SDK
dotnet add package Azure.AI.FormRecognizer --version 4.0.0
Install-Package Azure.AI.FormRecognizer -Version 4.0.0
2. Impor pustaka klien SDK ke dalam aplikasi Anda
using Azure;
using Azure.AI.FormRecognizer.DocumentAnalysis;
3. Siapkan autentikasi
Ada dua metode yang didukung untuk autentikasi:
Gunakan kunci API Kecerdasan Dokumen dengan AzureKeyCredential dari azure.core.credentials.
Gunakan kredensial token dari azure-identity untuk mengautentikasi dengan ID Microsoft Entra.
Mendapatkan kunci API Anda
Berikut adalah tempat untuk menemukan kunci API Kecerdasan Dokumen Anda di portal Azure:
Penting
Kami merekomendasikan autentikasi ID Microsoft Entra dengan identitas terkelola untuk sumber daya Azure untuk menghindari penyimpanan kredensial dengan aplikasi Anda yang berjalan di cloud.
Jika Anda menggunakan kunci API, simpan dengan aman di tempat lain, seperti di Azure Key Vault. Jangan sertakan kunci API langsung dalam kode Anda, dan jangan pernah mempostingnya secara publik.
Untuk informasi selengkapnya tentang keamanan layanan AI, lihat Mengautentikasi permintaan ke layanan Azure AI.
//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);
Menggunakan kredensial token Microsoft Entra
Catatan
Titik akhir regional tidak mendukung autentikasi Microsoft Entra. Buat subdomain kustom untuk sumber daya Anda supaya dapat menggunakan jenis autentikasi ini.
Otorisasi paling mudah menggunakan DefaultAzureCredential. Otorisasi ini menyediakan kredensial token default, berdasarkan lingkungan yang berjalan, yang mampu menangani sebagian besar skenario autentikasi Azure.
Berikut cara memperoleh dan menggunakan DefaultAzureCredential untuk aplikasi .NET:
Instal pustaka Azure Identity untuk .NET:
dotnet add package Azure.IdentityInstall-Package Azure.IdentityDaftarkan aplikasi Microsoft Entra dan buat perwakilan layanan baru.
Berikan akses ke Kecerdasan Dokumen dengan menetapkan peran ke
Cognitive Services Userperwakilan layanan Anda.Tetapkan nilai ID klien, ID penyewa, dan rahasia klien di aplikasi Microsoft Entra sebagai variabel lingkungan:
AZURE_CLIENT_ID, ,AZURE_TENANT_IDdanAZURE_CLIENT_SECRET, masing-masing.Buat instans
DocumentAnalysisClientAnda, termasukDefaultAzureCredential:string endpoint = "<your-endpoint>"; var client = new DocumentAnalysisClient(new Uri(endpoint), new DefaultAzureCredential());
Untuk informasi selengkapnya, lihat Mengautentikasi klien.
4. Buat aplikasi Anda
Buat objek klien untuk berinteraksi dengan SDK Kecerdasan Dokumen, lalu panggil metode pada objek klien tersebut untuk berinteraksi dengan layanan. SDK menyediakan metode sinkron dan asinkron. Untuk wawasan selengkapnya, coba mulai cepat dalam bahasa pilihan Anda.
Opsi bantuan
Forum Microsoft Q & A dan Stack Overflow tersedia bagi komunitas pengembang untuk mengajukan dan menjawab pertanyaan tentang Kecerdasan Dokumen Azure AI dan layanan lainnya. Microsoft memantau forum dan membalas pertanyaan yang belum dijawab oleh komunitas. Untuk memastikan bahwa kami melihat pertanyaan Anda, tandai dengan azure-form-recognizer.