SDK-cél: REST API v2.1 (GA)
REST API 2.1-es verzió (GA) 21-06-08
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# → 3.1.x (GA) | NuGet | 2.1-s verzió | Windows, macOS, Linux, Docker |
Java → 3.1.x (GA) | Maven-adattár | 2.1-s verzió | Windows, macOS, Linux |
JavaScript → 3.1.0 (GA) | npm | 2.1-s verzió | Böngésző, Windows, macOS, Linux |
Python → 3.1.0 (GA) | PyPI | 2.1-s verzió | |
Windows, macOS, Linux |
További információ az SDK más verzióiról:
Támogatott ügyfelek
Nyelv | SDK verziója | API-verzió | Támogatott ügyfelek |
---|---|---|---|
.NET/C# JavaScript |
3.1.x | v2.1 (alapértelmezett) v2.0 |
FormRecognizerClient FormTrainingClient |
.NET/C# JavaScript |
3.0.x | 2.0-s verzió | FormRecognizerClient FormTrainingClient |
Python | 3.1.x | v2.1 (alapértelmezett) v2.0 |
FormRecognizerClient FormTrainingClient |
Python | 3.0.0 | 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 3.1.0
Install-Package Azure.AI.FormRecognizer -Version 3.1.0
2. Az SDK-ügyfélkódtár importálása az alkalmazásba
using Azure;
using Azure.AI.FormRecognizer.Models;
3. Hitelesítés beállítása
A hitelesítéshez két támogatott módszer létezik.
A Document Intelligence API-kulcs és az AzureKeyCredential használata az azure.core.credentials-ből.
Az Azure-identitásból származó jogkivonat hitelesítő adataival hitelesíthet a Microsoft Entra-azonosítóval.
Az API-kulcs használata
Itt találja meg a Document Intelligence API-kulcsot az Azure Portalon:
//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-jogkivonat hitelesítő adatainak használata
Feljegyzé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:
Telepítse a .NET-hez készült Azure Identity-kódtárat:
dotnet add package Azure.Identity
Install-Package Azure.Identity
Regisztráljon egy Microsoft Entra-alkalmazást, és hozzon létre egy új szolgáltatásnevet.
Adjon hozzáférést a Dokumentumintelligencia szolgáltatásnévhez rendelhető
Cognitive Services User
szerepkörhöz.Á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
ésAZURE_CLIENT_SECRET
, illetve.Hozza létre a példányt
FormRecognizerClient
, beleértve a következőtDefaultAzureCredential
:string endpoint = "<your-endpoint>"; var client = new FormRecognizerClient(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 is elérhetők, 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
: .
Következő lépések
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: