هدف SDK: REST API v2.1 (GA)
إصدار واجهة برمجة تطبيقات REST الإصدار 2.1 (GA) 21-06-08
Azure الذكاء الاصطناعي Document Intelligence هي خدمة سحابية تستخدم التعلم الآلي لتحليل النص والبيانات المنظمة من المستندات. تعد مجموعة أدوات تطوير برامج المعلومات المستندية (SDK) مجموعة من المكتبات والأدوات التي تمكنك من دمج نماذج وإمكانيات معلومات المستند بسهولة في تطبيقاتك. تتوفر Document Intelligence SDK عبر الأنظمة الأساسية بلغات البرمجة C#/.NET وJava وJavaScript وPython.
لغات البرمجة المدعومة
يدعم Document Intelligence SDK اللغات والأنظمة الأساسية التالية:
إصدار Language → Document Intelligence SDK | الحزمة | إصدار واجهة برمجة التطبيقات المدعوم | دعم النظام الأساسي |
---|---|---|---|
.NET/C# → 3.1.x (GA) | NuGet | الإصدار 2.1 | Windows, macOS, Linux, Docker |
Java → 3.1.x (GA) | مستودع Maven | الإصدار 2.1 | Windows وmacOS وLinux |
JavaScript → 3.1.0 (GA) | npm | الإصدار 2.1 | Browser, Windows, macOS, Linux |
Python → 3.1.0 (GA) | PyPI | الإصدار 2.1 | |
Windows وmacOS وLinux |
لمزيد من المعلومات حول إصدارات SDK الأخرى، راجع:
تطبيقات العميل المعتمدة
اللغة | إصدار SDK | إصدار API | العملاء المعتمدون |
---|---|---|---|
.NET/C# Java JavaScript |
3.1.x | v2.1 (افتراضي) v2.0 |
FormRecognizerClient FormTrainingClient |
.NET/C# Java JavaScript |
3.0.x | v2.0 | FormRecognizerClient FormTrainingClient |
Python | 3.1.x | v2.1 (افتراضي) v2.0 |
FormRecognizerClient FormTrainingClient |
Python | 3.0.0 | v2.0 | FormRecognizerClient FormTrainingClient |
استخدام Document Intelligence SDK في تطبيقاتك
تمكن Document Intelligence SDK من استخدام وإدارة خدمة Document Intelligence في التطبيق الخاص بك. تعتمد SDK على واجهة برمجة تطبيقات REST الأساسية لذكاء المستند مما يسمح لك باستخدام واجهات برمجة التطبيقات هذه بسهولة ضمن نموذج لغة البرمجة. إليك كيفية استخدام Document Intelligence SDK للغة المفضلة لديك:
1. تثبيت مكتبة عميل عدة تطوير البرامج
dotnet add package Azure.AI.FormRecognizer --version 3.1.0
Install-Package Azure.AI.FormRecognizer -Version 3.1.0
2. استيراد مكتبة عميل عدة تطوير البرامج إلى التطبيق
using Azure;
using Azure.AI.FormRecognizer.Models;
3. إعداد المصادقة
هناك طريقتان مدعومتان للمصادقة.
استخدم مفتاح Document Intelligence API مع AzureKeyCredential من azure.core.credentials.
استخدم بيانات اعتماد رمز مميز من azure-identity للمصادقة باستخدام معرف Microsoft Entra.
استخدام مفتاح API
فيما يلي مكان العثور على مفتاح واجهة برمجة تطبيقات تحليل معلومات المستند في مدخل Microsoft Azure:
//set `<your-endpoint>` and `<your-key>` variables with the values from the Azure portal to create your `AzureKeyCredential` and `FormRecognizerClient` instance
string key = "<your-key>";
string endpoint = "<your-endpoint>";
FormRecognizerClient client = new FormRecognizerClient(new Uri(endpoint), new AzureKeyCredential(key));
استخدام بيانات اعتماد الرمز المميز ل Microsoft Entra
إشعار
لا تدعم نقاط النهاية الإقليمية مصادقة Microsoft Entra. أنشئ مجالًا فرعيًا مخصصًا لموردك لاستخدام هذا النوع من المصادقة.
التخويل أسهل باستخدام DefaultAzureCredential
. يوفر بيانات اعتماد رمز مميز افتراضية استنادًا إلى بيئة التشغيل، يمكنها التعامل مع معظم سيناريوهات مصادقة Azure.
فيما يلي كيفية الحصول على DefaultAzureCredential واستخدامه لتطبيقات Microsoft.NET:
ثبّت مكتبة Azure Identity لـ Microsoft.NET:
dotnet add package Azure.Identity
Install-Package Azure.Identity
تسجيل تطبيق Microsoft Entra وإنشاء كيان خدمة جديد.
امنح حق الوصول إلى Document Intelligence عن طريق تعيين
Cognitive Services User
الدور إلى كيان الخدمة.تعيين قيم معرف العميل ومعرف المستأجر وسر العميل في تطبيق Microsoft Entra كمتغيرات بيئة:
AZURE_CLIENT_ID
وAZURE_TENANT_ID
AZURE_CLIENT_SECRET
على التوالي.أنشئ المثيل
FormRecognizerClient
بما في ذلكDefaultAzureCredential
:string endpoint = "<your-endpoint>"; var client = new FormRecognizerClient(new Uri(endpoint), new DefaultAzureCredential());
لمزيد من المعلومات، راجع مصادقة العميل.
4. إنشاء التطبيق
أنشئ كائن عميل للتفاعل مع Document Intelligence SDK، ثم قم باستدعاء أساليب على كائن العميل هذا للتفاعل مع الخدمة. توفر عدد تطوير البرامج الأسلوب المتزامن وغير المتزامن. لمزيد من التفاصيل، جرب التشغيل السريع بلغة برمجة من اختيارك.
خيارات المساعدة
تتوفر منتديات Microsoft Q و Stack Overflow لمجتمع المطورين لطرح الأسئلة حول Azure الذكاء الاصطناعي Document Intelligence والخدمات الأخرى والإجابة عليها. تراقب Microsoft المنتديات وتجيب على الأسئلة التي لم يُجِب المجتمع عليها. ضمان استقبالنا للسؤال، ضع علامة azure-form-recognizer
عليه.
الخطوات التالية
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ