다음을 통해 공유


SDK 대상: REST API v4.0

문서 인텔리전스 체크 표시REST API 버전 2024-11-30 GA

Azure AI 문서 인텔리전스는 기계 학습을 사용하여 문서의 텍스트와 구조화된 데이터를 분석하는 클라우드 서비스입니다. 문서 인텔리전스 소프트웨어 개발 키트(SDK)는 문서 인텔리전스 모델 및 기능을 애플리케이션에 쉽게 통합할 수 있는 라이브러리 및 도구 세트입니다. 문서 인텔리전스 SDK는 C#/.NET, Java, JavaScript 및 Python 프로그래밍 언어의 플랫폼 전반에 걸쳐 사용할 수 있습니다.

지원되는 프로그래밍 언어

문서 인텔리전스 SDK는 다음 언어와 플랫폼을 지원합니다.

언어 → 문서 인텔리전스 SDK 버전 Package(패키지) 지원되는 API 버전 플랫폼 지원
.NET/C# → 1.0.0-beta.3(미리 보기) NuGet 2024-11-30(GA) Windows, macOS, Linux, Docker
Java → 1.0.0-beta.4(미리 보기) Maven 리포지토리 2024-11-30(GA) Windows, macOS, Linux
JavaScript → 1.0.0-beta.3(미리 보기) npm 2024-11-30(GA) Browser, Windows, macOS, Linux
Python → 1.0.0b4 (미리보기) PyPI 2024-11-30(GA) Windows, macOS, Linux

다른 SDK 버전에 대한 자세한 내용은 다음을 참조하세요.

지원되는 클라이언트

다음 표에는 문서 인텔리전스 서비스의 각 SDK 버전과 지원되는 API 버전 간의 상관 관계가 나와 있습니다.

언어 SDK 별칭 API 버전(기본값) 지원되는 클라이언트
.NET/C# 1.0.0-beta.2(미리 보기) v4.0(GA) 2024-11-30 GA DocumentIntelligenceClient
DocumentIntelligenceAdministrationClient
.NET/C# 4.1.0 v3.1 최신(GA) 2023-07-31 DocumentAnalyticClient
DocumentModelAdministrationClient
.NET/C# 4.0.0 v3.0(GA) 2022-08-31 DocumentAnalyticClient
DocumentModelAdministrationClient
.NET/C# 3.1.x v2.1 v2.1 FormRecognizerClient
FormTrainingClient
.NET/C# 3.0.x v2.0 v2.0 FormRecognizerClient
FormTrainingClient

애플리케이션에서 문서 인텔리전스 SDK 사용

문서 인텔리전스 SDK를 사용하면 애플리케이션에서 문서 인텔리전스 서비스를 사용하고 관리할 수 있습니다. SDK는 기본 문서 인텔리전스 REST API를 기반으로 구축되어 프로그래밍 언어 패러다임 내에서 해당 API를 쉽게 사용할 수 있습니다. 원하는 언어로 문서 인텔리전스 SDK를 사용하는 방법은 다음과 같습니다.

1. SDK 클라이언트 라이브러리 설치

dotnet add package Azure.AI.DocumentIntelligence --prerelease
Install-Package Azure.AI.FormRecognizer -Version 1.0.0-beta.3

2. SDK 클라이언트 라이브러리를 애플리케이션으로 가져오기

using Azure;
using Azure.AI.DocumentIntelligence;

3. 인증 설정

인증에는 다음 두 가지 방법을 지원합니다.

API key 사용

Azure portal에서 문서 인텔리전스 API 키를 찾을 수 있는 위치는 다음과 같습니다.

Azure Portal에서 키 및 엔드포인트 위치의 스크린샷

Important

클라우드에서 실행되는 애플리케이션에 자격 증명을 저장하지 않으려면 Microsoft Entra ID 인증과 함께 Azure 리소스에 대한 관리 ID를 사용하는 것이 좋습니다.

API 키를 사용하는 경우 Azure Key Vault와 같이 다른 곳에 안전하게 저장합니다. API 키를 코드에 직접 포함하지 말고, 공개적으로 게시하지 마세요.

AI 서비스 보안에 대한 자세한 내용은 Azure AI 서비스에 대한 요청 인증을 참조하세요.


//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 인증 시나리오를 처리할 수 있습니다.

.NET 애플리케이션용 DefaultAzureCredential을 획득하고 사용하는 방법은 다음과 같습니다.

  1. .NET용 Azure ID 라이브러리를 설치합니다.

        dotnet add package Azure.Identity
    
        Install-Package Azure.Identity
    
  2. Microsoft Entra 애플리케이션을 등록하고 새 서비스 주체를 만듭니다.

  3. 서비스 주체에 Cognitive Services User 역할을 할당하여 문서 인텔리전스에 대한 액세스 권한을 부여하세요.

  4. Microsoft Entra 애플리케이션의 클라이언트 ID, 테넌트 ID 및 클라이언트 암호 값을 각각 환경 변수AZURE_CLIENT_ID, AZURE_TENANT_IDAZURE_CLIENT_SECRET으로 설정합니다.

  5. DefaultAzureCredential을 포함하여 DocumentIntelligenceClient 인스턴스를 만듭니다.

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

자세한 내용은 클라이언트 인증참조하세요.

4. 애플리케이션 빌드

문서 인텔리전스 SDK와 상호 작용할 클라이언트 개체를 만든 다음 해당 클라이언트 개체에 대한 메서드를 호출하여 서비스와 상호 작용합니다. SDK는 동기 메서드와 비동기 메서드를 모두 제공합니다. 더 많은 인사이트를 얻으려면 원하는 언어의 빠른 시작을 시도해 보세요.

도움말 옵션

Developer Community에서는 Microsoft Q&AStack Overflow 포럼에서 Azure AI 문서 인텔리전스 및 기타 서비스에 대해 질문하고 답변할 수 있습니다. Microsoft는 포럼을 모니터링하고 커뮤니티에서 아직 답변하지 않은 질문에 답변합니다. 질문을 볼 수 있도록 다음 태그를 사용하세요.

  • Microsoft Q&A: Azure AI Document Intelligence.

  • Stack Overflow: azure-ai-document-intelligence.

다음 단계