エージェント向け財務ドキュメント分析スキルの展開における前提条件 (プレビュー)

[アーティクル]
12/19/2024

重要

これはプレビュー機能です。この情報は、リリース前に大幅に変更される可能性のあるプレリリース機能に関するものです。マイクロソフトは、ここで提供される情報に関して、明示または黙示を問わず、いかなる保証も行いません。

エージェントに財務ドキュメント分析スキルを展開する前に、環境がすべての必要な前提条件を満たしていることを確認してください。

Azureサブスクリプションの所有者ロールが必要です。
Azure OpenAI リソースに対してシステム割り当てマネージドIDを有効にします。詳細については、マネージドIDを有効にするをご覧ください。
「 OpenAI リソースにロールを割り当てる OpenAI 」の説明に従って、Cognitive Services 投稿者ロールをAzure OpenAI リソースに割り当てます。
ストレージアカウントを次のように構成します。
- 「Azure AI SearchのAzure Storageのインデクサーを使用した変更と削除の検出」で説明されているように、検索インデックスからドキュメントを自動的に削除できるようにします。
- 保持ポリシーを、インデクサー間隔スケジュールよりも高い値に設定します。
ドキュメントが取り込まれるBLOBコンテナーを構成します。
「アプリ登録を作成する」の説明に従って、アプリを登録します。
デプロイする前に、サブスクリプションに十分なPremium v3 P1mv3リソースがあることを確認してください。追加のリソースが必要な場合は、 ヘルプ + サポート セクション、選択 クォータからサポートチケットを開き、増加をリクエストしてください。サポートに問い合わせて支援を受けてください。最も一般的な Microsoft Azure 制限の詳細については、 Azureサブスクリプションとサービスの制限、クォータ、制約を参照してください。

前提となるタスク

エージェントに財務ドキュメント分析スキルを展開する前に、いくつかの操作を実行する必要があります。

リソースに役割を割り当てる OpenAI

オーナーの役割で Azureポータルにログインします。
ナビゲーションメニューで、選択 アクセス制御 (IAM) を選択します。

追加>ロールの割り当ての追加 を選択します。
選択 認知サービス OpenAI 投稿者 and選択次へ。

メンバー タブで、選択 マネージドID、続いて + 選択メンバー。
次の画像に示すように、選択でリソースを選択し、選択 OpenAI 次へ を選択します。

選択 レビュー + 割り当て (次の画像を参照)。

特定のロールが割り当てられていることを確認します。

a. OpenAI リソースの概要ページに戻ります。

b. ナビゲーションメニューで、選択 リソース管理 > ID を選択します。

c. 選択 Azureロールの割り当て をクリックして、割り当てられているすべてのロールを確認します。

d. Azureロールの割り当てページで、 Cognitive Services OpenAI 投稿者 ロールが OpenAI リソースに割り当てられているかどうかを確認します。

アプリ登録を作成する

重要

アプリ登録を作成するには、Application管理者ロールが必要です。詳細については、「ユーザーにロールを割り当てる Microsoft Entra 」をご覧ください。

Azure ポータルにサインインします。
選択 Microsoft Entra ID を示します。

ナビゲーションメニューで、選択 [管理] > [アプリの登録]、続いて [+ 新規登録] を選択します。

アプリの一意の名前を入力し、選択 登録します。

登録したアプリの「アプリ登録」ページに移動し、選択 APIを公開します。

選択 + スコープ を追加し、 DocQnA.Usersを追加します。この値は大文字と小文字が区別されます。
選択 クライアントアプリケーションを追加し、 04b07795-8ddb-461a-bbee-02f9e1bf7b46 クライアントID として入力し、選択 承認済みスコープの下のチェックボックスをオンにします。クライアントIDは、Azure CLIのアプリケーションIDです。

ヒント

アプリがユーザーに代わってトークンを受信するようにする場合は、バックエンドアプリのクライアントIDも追加する必要があります。
選択 アプリロール を選択し、 ユーザー ロールを追加します。このロールは、Document Insights APIにアクセスするために重要です。