SDK の対象: REST API v4.0 (GA)
[アーティクル] 12/17/2024
1 人の共同作成者
フィードバック
この記事の内容
REST API バージョン 2024-11-30 GA
Azure AI Document Intelligence は、機械学習を使用してドキュメントからのテキストと構造化データを分析するクラウド サービスです。 Document Intelligence ソフトウェア開発キット (SDK) は、Document Intelligence のモデルと機能をアプリケーションに簡単に統合できる一連のライブラリとツールです。 Document Intelligence SDK は、C#/.NET、Java、JavaScript、Python プログラミング言語で、さまざまなプラットフォームで使用できます。
サポートされるプログラミング言語
Document Intelligence SDK では、次の言語とプラットフォームがサポートされています。
その他の SDK バージョンの詳細については、以下を参照してください。
サポートされているクライアント
次の表は、ドキュメント インテリジェンス サービスでサポートされている API バージョンの各 SDK バージョン間の相関関係を示しています。
Language
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
DocumentAnalysisClient DocumentModelAdministrationClient
.NET/C# 4.0.0
v3.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
Language
SDK エイリアス
API バージョン (既定)
サポートされるクライアント
Java 1.0.0-beta.2 (プレビュー)
v4.0 (GA)
2024-07-31-preview
DocumentIntelligenceClient DocumentIntelligenceAdministrationClient
Java 4.1.0
v3.1 最新 (GA)
2023-07-31
DocumentAnalysisClient DocumentModelAdministrationClient
Java 4.0.0
v3.0 (GA)
2022-08-31
DocumentAnalysisClient DocumentModelAdministrationClient
Java 3.1.x
v2.1
v2.1
FormRecognizerClient FormTrainingClient
Java 3.0.x
v2.0
v2.0
FormRecognizerClient FormTrainingClient
Language
SDK エイリアス
API バージョン (既定)
サポートされるクライアント
JavaScript 1.0.0-beta.2
v4.0 (GA)
2024-07-31-preview
DocumentIntelligenceClient DocumentIntelligenceAdministrationClient
JavaScript 5.0.0
v3.1 最新 (GA)
2023-07-31
DocumentAnalysisClient DocumentModelAdministrationClient
JavaScript 4.0.0
v3.0 (GA)
2022-08-31
DocumentAnalysisClient DocumentModelAdministrationClient
JavaScript 3.1.x
v2.1
v2.1
FormRecognizerClient FormTrainingClient
JavaScript 3.0.x
v2.0
v2.0
FormRecognizerClient FormTrainingClient
Language
SDK エイリアス
API バージョン (既定)
サポートされるクライアント
Python 1.0.0b2
v4.0 (プレビュー)
2024-07-31-preview
DocumentIntelligenceClient DocumentIntelligenceAdministrationClient
Python 3.3.0
v3.1 最新 (GA)
2023-07-31
DocumentAnalysisClient DocumentModelAdministrationClient
Python 3.2.x
v3.0 (GA)
2022-08-31
DocumentAnalysisClient DocumentModelAdministrationClient
Python 3.1.x
v2.1
v2.1
FormRecognizerClient FormTrainingClient
Python 3.0.0
v2.0
v2.0
FormRecognizerClient FormTrainingClient
アプリケーションで Document Intelligence SDK を使用する
Document Intelligence SDK を使用すると、アプリケーションで Document Intelligence サービスを使用および管理できます。 SDK は、基になる Document Intelligence REST API に基づいて構築されていて、プログラミング言語パラダイム内でこれらの API を簡単に使用できます。 Document Intelligence SDK を任意の言語で使用する方法を次に示します。
1. SDK クライアント ライブラリをインストールする
dotnet add package Azure.AI.DocumentIntelligence --prerelease
Install-Package Azure.AI.FormRecognizer -Version 1.0.0-beta.3
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-documentintelligence</artifactId>
<version>1.0.0-beta.2</version>
</dependency>
implementation("com.azure:azure-ai-documentintelligence:1.0.0-beta.4")
npm i @azure-rest/ai-document-intelligence version 1.0.0-beta.3
pip install azure-ai-documentintelligence==1.0.0b4
2. SDK クライアント ライブラリをアプリケーションにインポートする
using Azure;
using Azure.AI.DocumentIntelligence;
import com.azure.ai.documentintelligence.*;
import com.azure.ai.documentintelligence.models.*;
import com.azure.core.credential.AzureKeyCredential;
const { AzureKeyCredential, DocumentIntelligence } = require("@azure-rest/ai-document-intelligence@1.0.0-beta.3");
from azure.ai.documentintelligence import DocumentIntelligenceClient
from azure.core.credentials import AzureKeyCredential
3. 認証を設定する
認証には、次の 2 つの方法がサポートされています。
API キーを使用する
Azure portal で Document Intelligence API キーを見つける場所を次に示します。
//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));
// create your `DocumentIntelligenceClient` instance and `AzureKeyCredential` variable
DocumentIntelligenceClient documentIntelligenceClient = new DocumentIntelligenceClientBuilder()
.credential(new AzureKeyCredential("<your-key>"))
.endpoint("<your-endpoint>")
.buildClient();
// create your `DocumentIntelligenceClient` instance and `AzureKeyCredential` variable
async function main() {
const client = DocumentIntelligence(process.env["your-endpoint>"], {
key: process.env["<your-key>"],
});
# create your `DocumentIntelligenceClient` instance and `AzureKeyCredential` variable
endpoint = "<your-endpoint>"
credential = AzureKeyCredential("<your-key>")
document_analysis_client = DocumentIntelligenceClient(endpoint, credential)
Microsoft Entra トークン資格情報を使用する
Note
リージョン エンドポイントでは、Microsoft Entra 認証がサポートされていません。 この種類の認証を使用するために、リソースのカスタム サブドメイン を作成します。
承認は、DefaultAzureCredential
を使用するのが最も簡単です。 実行中の環境に基づいて、ほとんどの Azure 認証シナリオを処理できる既定のトークン資格情報が提供されます。
.NET アプリケーションの DefaultAzureCredential を取得して使用する方法を次に示します。
.NET 用の Azure ID ライブラリ をインストールします。
dotnet add package Azure.Identity
Install-Package Azure.Identity
Microsoft Entra アプリケーションを登録し、新しいサービス プリンシパルを作成します 。
サービス プリンシパルに Cognitive Services User
ロールを割り当てて Document Intelligence へのアクセス権を付与します。
Microsoft Entra アプリケーションのクライアント ID、テナント ID、クライアント シークレットの値をそれぞれ環境変数 AZURE_CLIENT_ID
、AZURE_TENANT_ID
、AZURE_CLIENT_SECRET
として設定します。
DefaultAzureCredential
を含む DocumentIntelligenceClient
インスタンスを作成します。
string endpoint = "<your-endpoint>";
var client = new DocumentIntelligenceClient(new Uri(endpoint), new DefaultAzureCredential());
詳細については、「クライアントを認証する 」を参照してください。
Java アプリケーションの DefaultAzureCredential を取得して使用する方法を次に示します。
Java 用の Azure ID ライブラリ をインストールします。
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.5.3</version>
</dependency>
Microsoft Entra アプリケーションを登録し、新しいサービス プリンシパルを作成します 。
サービス プリンシパルに Cognitive Services User
ロールを割り当てて Document Intelligence へのアクセス権を付与します。
Microsoft Entra アプリケーションのクライアント ID、テナント ID、クライアント シークレットの値をそれぞれ環境変数 AZURE_CLIENT_ID
、AZURE_TENANT_ID
、AZURE_CLIENT_SECRET
として設定します。
DocumentIntelligenceClient
インスタンスと TokenCredential
変数を作成します。
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
DocumentIntelligenceClient documentIntelligenceClient = new DocumentIntelligenceClientBuilder()
.endpoint("{your-endpoint}")
.credential(credential)
.buildClient();
詳細については、「認証 」を参照してください。
JavaScript アプリケーションの DefaultAzureCredential を取得して使用する方法を次に示します。
JavaScript 用の Azure ID ライブラリ をインストールします。
npm install @azure/identity
Microsoft Entra アプリケーションを登録し、新しいサービス プリンシパルを作成します 。
サービス プリンシパルに Cognitive Services User
ロールを割り当てて Document Intelligence へのアクセス権を付与します。
Microsoft Entra アプリケーションのクライアント ID、テナント ID、クライアント シークレットの値をそれぞれ環境変数 AZURE_CLIENT_ID
、AZURE_TENANT_ID
、AZURE_CLIENT_SECRET
として設定します。
DefaultAzureCredential
を含む DocumentIntelligenceClient
インスタンスを作成します。
const { DocumentIntelligenceClient } = require("@azure-rest/ai-document-intelligence@1.0.0-beta.2");
const { DefaultAzureCredential } = require("@azure/identity");
const client = new DocumentIntelligenceClient("<your-endpoint>", new DefaultAzureCredential());
詳細については、「クライアントの作成と認証 」を参照してください。
Python アプリケーションの DefaultAzureCredential を取得して使用する方法を次に示します。
Python 用の Azure ID ライブラリ をインストールします。
pip install azure-identity
Microsoft Entra アプリケーションを登録し、新しいサービス プリンシパルを作成します 。
サービス プリンシパルに Cognitive Services User
ロールを割り当てて Document Intelligence へのアクセス権を付与します。
Microsoft Entra アプリケーションのクライアント ID、テナント ID、クライアント シークレットの値をそれぞれ環境変数 AZURE_CLIENT_ID
、AZURE_TENANT_ID
、AZURE_CLIENT_SECRET
として設定します。
DefaultAzureCredential
を含む DocumentIntelligenceClient
インスタンスを作成します。
from azure.identity import DefaultAzureCredential
from azure.ai.documentintelligence import DocumentIntelligenceClient
credential = DefaultAzureCredential()
client = DocumentIntelligenceClient(
endpoint="<your-endpoint>",
credential=credential
)
詳細については、「クライアントを認証する 」を参照してください。
4. アプリをビルドする
Document Intelligence SDK と対話するクライアント オブジェクトを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 SDK には同期メソッドと非同期メソッドの両方が用意されています。 詳細については、選択した言語のクイック スタート を試してください。
ヘルプ オプション
Microsoft Q&A
と Stack Overflow のフォーラムは、開発者コミュニティでの Azure AI Document Intelligence やその他のサービスに関する質問と回答を行うために利用できます。 Microsoft ではフォーラムを監視しており、コミュニティでまだ回答されていない質問に回答します。 確実にするために、次のタグを使って質問が見つかるようにしてください。
次のステップ