هدف SDK: REST API 2024-02-29-preview
هام
- توفر إصدارات المعاينة العامة ل Document Intelligence وصولا مبكرا إلى الميزات قيد التطوير النشط.
- قد تتغير الميزات والنهج والعمليات، قبل التوفر العام (GA)، استنادا إلى ملاحظات المستخدم.
- إصدار المعاينة العامة لمكتبات عميل Document Intelligence افتراضيا إلى إصدار REST API 2024-02-29-preview.
- يتوفر إصدار المعاينة العامة 2024-02-29-preview حاليا فقط في مناطق Azure التالية:
- شرق الولايات المتحدة
- غرب الولايات المتحدة 2
- غرب أوروبا
REST API الإصدار 2024-02-29-preview
Azure الذكاء الاصطناعي Document Intelligence هي خدمة سحابية تستخدم التعلم الآلي لتحليل النص والبيانات المنظمة من المستندات. تعد مجموعة أدوات تطوير برامج المعلومات المستندية (SDK) مجموعة من المكتبات والأدوات التي تمكنك من دمج نماذج وإمكانيات معلومات المستند بسهولة في تطبيقاتك. تتوفر Document Intelligence SDK عبر الأنظمة الأساسية بلغات البرمجة C#/.NET وJava وJavaScript وPython.
لغات البرمجة المدعومة
يدعم Document Intelligence SDK اللغات والأنظمة الأساسية التالية:
إصدار Language → Document Intelligence SDK | الحزمة | إصدار واجهة برمجة التطبيقات المدعوم | دعم النظام الأساسي |
---|---|---|---|
.NET/C# → 1.0.0-beta.2 (معاينة) | NuGet | 2024-02-29 (معاينة) | Windows, macOS, Linux, Docker |
Java → 1.0.0-beta.2 (معاينة) | مستودع Maven | 2024-02-29 (معاينة) | Windows وmacOS وLinux |
JavaScript → 1.0.0-beta.2 (معاينة) | npm | 2024-02-29 (معاينة) | Browser, Windows, macOS, Linux |
Python → 1.0.0b2 (معاينة) | PyPI | 2024-02-29 (معاينة) | Windows وmacOS وLinux |
لمزيد من المعلومات حول إصدارات SDK الأخرى، راجع:
تطبيقات العميل المعتمدة
تقدم الجداول التالية الارتباط بين كل إصدار من إصدارات SDK لإصدارات واجهة برمجة التطبيقات المدعومة لخدمة Document Intelligence.
اللغة | الاسم المستعار ل SDK | إصدار واجهة برمجة التطبيقات (افتراضي) | العملاء المعتمدون |
---|---|---|---|
.NET/C# 1.0.0-beta.2 (معاينة) | الإصدار 4.0 (معاينة) | معاينة 2024-02-29 | DocumentIntelligenceClient DocumentIntelligenceAdministrationClient |
.NET/C# 4.1.0 | الإصدار 3.1 الأحدث (GA) | 2023-07-31 | DocumentAnalysisClient DocumentModelAdministrationClient |
.NET/C# 4.0.0 | الإصدار 3.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 |
استخدام Document Intelligence SDK في تطبيقاتك
تمكن Document Intelligence SDK من استخدام وإدارة خدمة Document Intelligence في التطبيق الخاص بك. تعتمد SDK على واجهة برمجة تطبيقات REST الأساسية لذكاء المستند مما يسمح لك باستخدام واجهات برمجة التطبيقات هذه بسهولة ضمن نموذج لغة البرمجة. إليك كيفية استخدام Document Intelligence SDK للغة المفضلة لديك:
1. تثبيت مكتبة عميل عدة تطوير البرامج
dotnet add package Azure.AI.DocumentIntelligence --version 1.0.0-beta.2
Install-Package Azure.AI.FormRecognizer -Version 1.0.0-beta.2
2. استيراد مكتبة عميل عدة تطوير البرامج إلى التطبيق
using Azure;
using Azure.AI.DocumentIntelligence;
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 `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));
استخدام بيانات اعتماد الرمز المميز ل 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
على التوالي.أنشئ المثيل
DocumentIntelligenceClient
بما في ذلكDefaultAzureCredential
:string endpoint = "<your-endpoint>"; var client = new DocumentIntelligenceClient(new Uri(endpoint), new DefaultAzureCredential());
لمزيد من المعلومات، راجع مصادقة العميل.
4. إنشاء التطبيق
أنشئ كائن عميل للتفاعل مع Document Intelligence SDK، ثم قم باستدعاء أساليب على كائن العميل هذا للتفاعل مع الخدمة. توفر عدد تطوير البرامج الأسلوب المتزامن وغير المتزامن. لمزيد من التفاصيل، جرب التشغيل السريع بلغة برمجة من اختيارك.
خيارات المساعدة
Microsoft Q&A
تتوفر منتديات و Stack Overflow لمجتمع المطورين لطرح الأسئلة والإجابة عليها حول Azure الذكاء الاصطناعي Document Intelligence والخدمات الأخرى. تراقب Microsoft المنتديات وتجيب على الأسئلة التي لم يُجِب المجتمع عليها. للتأكد من ذلك، استخدم العلامات التالية حتى نرى سؤالك.
Microsoft Q&A
: .Azure AI Document Intelligence
تجاوز مكدس الذاكرة المؤقتة:
azure-ai-document-intelligence
.
الخطوات التالية
استكشاف عمليات Rest API 2023-10-31-rest.
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ