Document Intelligence Studio は、アプリケーション内の Document Intelligence サービスの機能を視覚的に検査、理解、および統合するためのオンライン ツールです。 サンプルまたは独自のドキュメントを使用して、事前トレーニング済みのモデルを探索することで開始できます。 また、プロジェクトを作成してカスタム テンプレート モデルをビルドし、アプリケーション内のモデルを参照することもできます。
新しいユーザー向けの前提条件
Document Intelligence Studio を使用するには、Azure portal から次の資産を取得する必要があります。
Azure サブスクリプション - 無料アカウントを作成します。
Azure AI サービスまたは Document Intelligence リソース。 Azure サブスクリプションを用意できたら、Azure portal で単一サービスまたは Azure AI マルチサービスのリソースを作成し、キーとエンドポイントを取得します。
Free 価格レベル (
F0) を使用してサービスを試用し、後から運用環境用の有料レベルにアップグレードすることができます。
ヒント
1 つのエンドポイント/キーで複数の Azure AI サービスにアクセスする予定の場合は、Azure AI Foundry リソースを作成します。 Document Intelligence へのアクセスのみの場合は、Document Intelligence リソースを作成します。 Microsoft Entra 認証を使用する場合は、単一サービス リソースが必要です。
Document Intelligence で、Document Intelligence リソースとストレージ アカウントにアクセスする際に、ローカル (キーベース) の認証に加えて、Azure Active Directory (Azure AD) トークン認証がサポートされるようになりました。 特に、リソースに DisableLocalAuth ポリシーが適用されている場合は、正しいアクセス ロールを設定するために、次の手順に従うようにしてください。
Document Intelligence Studio でカスタム モデルを使用するには、追加の前提条件があります。 詳細なガイダンスについては、こちらのドキュメントを参照してください
承認ポリシー
組織は、Azure AI Document Intelligence リソースと Azure Blob Storage に対してローカル認証を無効にし、Microsoft Entra (旧称 Azure Active Directory) 認証を適用することを選択できます。
Microsoft Entra 認証では、キー ベースの承認が無効になっている必要があります。 キー アクセスを無効にすると、使用可能な承認方法は Microsoft Entra ID だけになります。
Microsoft Entra では、Azure リソースに対して最小限の特権を付与し、きめ細かく制御できます。
詳細については、次のガイダンスを "参照" してください。
注
Document Intelligence サービス リソースに対してローカル (キーベース) の認証が無効になっている場合は、Document Intelligence Studio での要求を認証するために、必ず Cognitive Services ユーザー ロールと Azure AD トークンをを取得してください。 共同作成者ロールでは、キーの一覧表示のみが許可されます。キー アクセスが無効になっている場合はリソースを使用するアクセス許可は付与されません。
- ロールの割り当ての指定。 Document Intelligence Studio の基本的なアクセスには、
Cognitive Services Userロールが必要です。 詳細については、Document Intelligence のロールの割り当てに関する記事を "参照" してください。
Von Bedeutung
- Microsoft Entra ID 認証を設定するときに、Cognitive Services 共同作成者ロールではなく、 Cognitive Services ユーザー ロールがあることを確認します。
- ✔️ Cognitive Services ユーザー: 分析ページに入るために、ドキュメント インテリジェンスまたは Azure AI Foundry リソースに対するこのロールが必要です。
- ✔️ 共同作成者: リソース グループ、ドキュメント インテリジェンス サービス、または Azure AI Foundry リソースを作成するには、このロールが必要です。
- Azure コンテキストでは、共同作成者ロールで実行できるのは、アクセス キーの一覧表示など、リソース自体を制御および管理するアクションのみです。
- 共同作成者ロールを持つユーザー アカウントは、アクセス キーを使用して呼び出した場合のみ、Document Intelligence にアクセスできます。 ただし、Microsoft Entra ID を使用してアクセスを設定する場合、キー アクセスは無効になり、アカウントでリソースを使用するには Cognitive Services ユーザー ロールが必要です。
Studio での認証
Document Intelligence Studio に移動します。 初めてログインする場合、サービス リソースの構成を求めるポップアップ ウィンドウが表示されます。 組織のポリシーに従って、次の 1 つまたは 2 つのオプションがあります。
Microsoft Entra 認証: リソースによるアクセス (推奨)。
既存のサブスクリプションを選択します。
サブスクリプション内の既存のリソース グループを選択するか、新しいものを作成します。
既存のドキュメント インテリジェンスまたは Azure AI Foundry リソースを選択します。
ローカル認証: API エンドポイントとキーによるアクセス。
Azure portal からエンドポイントとキーを取得します。
リソースの概要ページに移動し、左側のウィンドウから [キーとエンドポイント ] を選択します。
適切なフィールドに値を入力します。
![Azure portal の [キーとエンドポイント] ページのスクリーンショット。](../media/studio/keys-and-endpoint.png?view=doc-intel-3.0.0)
Document Intelligence Studio でシナリオを検証した後に、C#、Java、JavaScript、Python のクライアント ライブラリまたは REST API を使用して、独自のアプリケーションへの Document Intelligence モデルの組み込みを開始します。
![Azure portal の [キーとエンドポイント] ページのスクリーンショット。](../media/studio/keys-and-endpoint.png?view=doc-intel-3.0.0#lightbox)
Document Intelligence モデルを試す
使用可能なドキュメント インテリジェンス モデルの詳細については、モデルのサポート ページを参照してください。
リソースが構成されたら、Document Intelligence Studio によって提供されるさまざまなモデルを試すことができます。 フロント ページから、コードなしの方法での使用を試す Document Intelligence モデルを選択します。
ドキュメント分析モデルまたは事前構築済みモデルをテストするには、モデルを選択し、いずれかのサンプル ドキュメントを使用するか、分析対象の独自のドキュメントをアップロードします。 分析結果は、コンテンツ結果コード ウィンドウの右側に表示されます。
カスタム モデルは、お使いのドキュメントでトレーニングする必要があります。 カスタム モデルの概要については、カスタム モデルの概要に関するページを参照してください。
Document Intelligence Studio でシナリオを検証した後に、C#、Java、JavaScript、Python のクライアント ライブラリまたは REST API を使用して、独自のアプリケーションへの Document Intelligence モデルの組み込みを開始します。
リソースの詳細を表示する
名前や価格レベルなどのリソースの詳細を表示するには、Document Intelligence Studio ホーム ページの右上隅にある [設定] アイコンを選択し、[リソース] タブを選択します。他のリソースにアクセスできる場合は、リソースを切り替えることもできます。
Document Intelligence を使用すると、アプリケーションとワークフローでのデータ処理をすぐに自動化し、データ主導の戦略を簡単に強化し、ドキュメント検索機能を巧みに強化できます。
Studio にアクセスするためのサード パーティの設定を管理する
Edge:
- Microsoft Edge の [設定] に移動します
- "サード パーティ" を検索する
- [Cookie とサイト データの管理と削除] に移動します
- [サード パーティの Cookie をブロックする] の設定をオフにする
Chrome:
- Chrome の [設定] に移動します
- "サード パーティ" を検索する
- [既定の動作] で、[サードパーティの Cookie を許可する] を選択します
Firefox:
- Firefox の [設定] に移動します
- 「Cookie」を検索します
- [強化型トラッキング防止] で、[例外を管理] を選択します
- お使いの環境の
https://documentintelligence.ai.azure.comまたは Document Intelligence Studio の URL に例外を追加します
Safari の場合:
- [Safari]>[設定] の順に選択します
- [プライバシー] を選択します
- [すべての Cookie をブロック] を選択解除します
トラブルシューティング
| シナリオ | 原因 | 解決策 |
|---|---|---|
カスタム プロジェクトを開いたときに、エラー メッセージ Form Recognizer Not Found が返される。 |
このカスタム プロジェクトにバインドされている Document Intelligence リソースが削除されたか、または別のリソース グループに移動されました。 | この問題を解決するには、次の 2 つの方法があります。 • 同じサブスクリプションと、同じ名前を持つリソース グループで、Document Intelligence リソースを再作成します。 • カスタム プロジェクトを再作成して Document Intelligence リソースを移行し、同じストレージ アカウントを指定します。 |
事前構築済みのアプリを使用しているとき、または事前カスタム プロジェクトを開いたときに、エラー メッセージ PermissionDenied が返される。 |
事前構築済みモデルに対して分析したり、カスタム プロジェクトを開いたりする場合、プリンシパルは API/操作にアクセスできません。 Document Intelligence リソースに対してローカル (キーベース) 認証が無効になっており、リソースにアクセスするための十分なアクセス許可がない可能性があります。 | 「Azure でのロールの割り当て」を参照して、アクセス ロールを構成してください。 |
カスタム プロジェクトを開いたときに、エラー メッセージ AuthorizationPermissionMismatch が返される。 |
要求には、指定されたアクセス許可を使用して操作を実行する権限がありません。 ストレージ アカウントに対してローカル (キーベース) 認証が無効になっており、BLOB データにアクセスするためのアクセス許可が付与されていない可能性があります。 | 「Azure でのロールの割り当て」を参照して、アクセス ロールを構成してください。 |
Document Intelligence Studio にサインインできず、エラー メッセージ InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in が返される |
ブラウザーがサードパーティの Cookie をブロックしているため、正常にサインインできない可能性があります。 | 解決するには、お使いのブラウザーのサード パーティの設定の管理を参照してください。 |