SDK-cél: REST API 2023-07-31 (GA) legújabb

Document Intelligence checkmarkREST API 2023-07-31-es verzió (GA)

Az Azure AI Document Intelligence egy felhőalapú szolgáltatás, amely gépi tanulással elemzi a dokumentumokból származó szöveges és strukturált adatokat. A Dokumentumintelligencia szoftverfejlesztői készlet (SDK) kódtárak és eszközök készlete, amelyekkel egyszerűen integrálhatja a Dokumentumintelligencia-modelleket és -képességeket az alkalmazásokba. A Document Intelligence SDK a C#/.NET, a Java, a JavaScript és a Python programozási nyelvek platformjai között érhető el.

Támogatott programozási nyelvek

A Document Intelligence SDK a következő nyelveket és platformokat támogatja:

Language → Document Intelligence SDK-verzió Csomag Támogatott API-verzió Platformtámogatás
.NET/C# → legújabb (GA) NuGet • 2023-07-31 (GA)
• 2022-08-31 (GA)
• v2.1
• v2.0
Windows, macOS, Linux, Docker
Java → legújabb (GA) MVN-adattár • 2023-07-31 (GA)
• 2022-08-31 (GA)
• v2.1
• v2.0
Windows, macOS, Linux
JavaScript → legújabb (GA) npm • 2023-07-31 (GA) • 2022-08-31 (GA)
• v2.1

• v2.0
Böngésző, Windows, macOS, Linux
Python → legújabb (GA) PyPI • 2023-07-31 (GA) • 2022-08-31 (GA)
• v2.1

• v2.0
Windows, macOS, Linux

Támogatott ügyfelek

Az alábbi táblázatok az egyes SDK-verziók és a Document Intelligence szolgáltatás támogatott API-verziói közötti korrelációt mutatják be.

Nyelv SDK version API-verzió (alapértelmezett) Támogatott ügyfelek
.NET/C# 4.1.0 v3.1 legújabb (GA) 2023-07-31 DocumentAnalysisClient
DocumentModel Rendszergazda istrationClient
.NET/C# 4.0.0 3.0-s verzió (GA) 2022-08-31 DocumentAnalysisClient
DocumentModel Rendszergazda istrationClient
.NET/C# 3.1.x 2.1-s verzió 2.1-s verzió FormRecognizerClient
FormTrainingClient
.NET/C# 3.0.x 2.0-s verzió 2.0-s verzió FormRecognizerClient
FormTrainingClient

A Document Intelligence SDK használata az alkalmazásokban

A Dokumentumintelligencia SDK lehetővé teszi a Dokumentumintelligencia szolgáltatás használatát és kezelését az alkalmazásban. Az SDK a mögöttes Document Intelligence REST API-ra épül, amely lehetővé teszi ezen API-k egyszerű használatát a programozási nyelvi paradigmán belül. A Dokumentumintelligencia SDK használata az előnyben részesített nyelvhez:

1. Az SDK-ügyfélkódtár telepítése

dotnet add package Azure.AI.FormRecognizer --version 4.1.0
Install-Package Azure.AI.FormRecognizer -Version 4.1.0

2. Az SDK-ügyfélkódtár importálása az alkalmazásba

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

3. Hitelesítés beállítása

A hitelesítésnek két támogatott módja van

Az API-kulcs használata

Itt találja meg a Document Intelligence API-kulcsot az Azure Portalon:

Screenshot of the keys and endpoint location in the Azure portal.


//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-jogkivonat hitelesítő adatainak használata

Megjegyzés:

A regionális végpontok nem támogatják a Microsoft Entra-hitelesítést. Hozzon létre egy egyéni altartományt az erőforráshoz az ilyen típusú hitelesítés használatához.

Az engedélyezés a legegyszerűbb a DefaultAzureCredential. A futó környezeten alapuló alapértelmezett jogkivonat-hitelesítő adatokat biztosít, amely képes kezelni a legtöbb Azure-hitelesítési forgatókönyvet.

A DefaultAzureCredential beszerzése és használata .NET-alkalmazásokhoz:

  1. Telepítse a .NET-hez készült Azure Identity-kódtárat:

        dotnet add package Azure.Identity
    
        Install-Package Azure.Identity
    
  2. Regisztráljon egy Microsoft Entra-alkalmazást, és hozzon létre egy új szolgáltatásnevet.

  3. Adjon hozzáférést a Dokumentumintelligencia szolgáltatásnévhez rendelhető Cognitive Services User szerepkörhöz.

  4. Állítsa be a Microsoft Entra alkalmazás ügyfélazonosítójának, bérlőazonosítójának és ügyféltitkának értékeit környezeti változóként: AZURE_CLIENT_ID, AZURE_TENANT_IDés AZURE_CLIENT_SECRET, illetve.

  5. Hozza létre a példányt DocumentAnalysisClient , beleértve a következőt DefaultAzureCredential:

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

További információ: Az ügyfél hitelesítése

4. Az alkalmazás létrehozása

Hozzon létre egy ügyfélobjektumot a Dokumentumintelligencia SDK használatához, majd hívja meg az adott ügyfélobjektum metódusát a szolgáltatással való interakcióhoz. Az SDK-k szinkron és aszinkron metódusokat is biztosítanak. További információkért próbálkozzon egy gyorsútmutatóval egy tetszőleges nyelven.

Súgóbeállítások

A Microsoft Q&A és a Stack Overflow fórumai a fejlesztői közösség számára érhetők el, hogy kérdéseket tegyenek fel és válaszoljanak meg az Azure AI-dokumentumintelligencia-szolgáltatással és más szolgáltatásokkal kapcsolatban. A Microsoft figyeli azokat a fórumokat és válaszokat, amelyekre a közösség még nem válaszolt. Annak érdekében, hogy biztosan láthassuk a kérdését, címkézze meg a következővel azure-form-recognizer: .

További lépések

Ismerkedjen meg a Document Intelligence REST API 2023-07-31 műveletekkel.