Share via

هدف 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
DocumentIntelligence مسؤول istrationClient
.NET/C# 4.1.0 الإصدار 3.1 الأحدث (GA) 2023-07-31 DocumentAnalysisClient
DocumentModel مسؤول istrationClient
.NET/C# 4.0.0 الإصدار 3.0 (GA) 2022-08-31 DocumentAnalysisClient
DocumentModel مسؤول istrationClient
.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. إعداد المصادقة

هناك طريقتان مدعومتان للمصادقة:

استخدام مفتاح API

فيما يلي مكان العثور على مفتاح واجهة برمجة تطبيقات تحليل معلومات المستند في مدخل Microsoft Azure:

لقطة شاشة لموقع المفاتيح ونقطة النهاية في مدخل 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:

  1. ثبّت مكتبة Azure Identity لـ Microsoft.NET:

        dotnet add package Azure.Identity

        Install-Package Azure.Identity

  2. تسجيل تطبيق Microsoft Entra وإنشاء كيان خدمة جديد.

  3. امنح حق الوصول إلى Document Intelligence عن طريق تعيين Cognitive Services User الدور إلى كيان الخدمة.

  4. تعيين قيم معرف العميل ومعرف المستأجر وسر العميل في تطبيق Microsoft Entra كمتغيرات بيئة: AZURE_CLIENT_IDو AZURE_TENANT_IDAZURE_CLIENT_SECRETعلى التوالي.

  5. أنشئ المثيل 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.