Azure OpenAI Service の 店舗運営用コパイロット テンプレートのトラブルシューティング

この記事では、Store Operations のコパイロット テンプレートまたは店舗運営の AI 店舗運営で発生する可能性のある問題の解決方法について説明します。

制限

現在リリースされている店舗運営用コパイロット テンプレートには、以下の制限があります:

回答を裏付ける文書へのアクセス制限

店舗運営用コパイロットのテンプレートで質問して関連する回答を得たら、ドロップダウン ボタンを選択して、その回答をサポートする関連ドキュメントを表示できます。 ただし、アクセスが制限されているため、ドキュメントを開くことはできません。

クライアント シークレット値を保存する必要がある

店舗運営用コパイロット テンプレートのアプリ登録作成時に、画面に表示されるシークレット値を保存する必要があります。 このシークレット値は、店舗運営用コパイロット テンプレートを構成するために使用するキーです。 Store Operations を更新するたびに、これを構成に追加する必要があります。

タブや画面を更新すると、シークレット値が消えてコピーできなくなります。 したがって、アプリ登録を作成するときに必ずシークレット値を保存してください。

Store Operations をインストールした顧客は、店舗運営コントロール用のコパイロット テンプレートをキャンバス アプリに「コピー」できますか？

いいえ。店舗運営管理用のコパイロット テンプレートは、Store Operations 管理をインストールした顧客からキャンバス アプリにコピーすることはできません。 このコントロールは、Store Operations 管理ポータルでのみ使用できます。

フォーム入力機能を使用して、ケース、インシデント、チケットなどの、別のフォーム (非タスク フォーム) に入力することはできますか?

いいえ

トラブルシューティング

コパイロットのテンプレートを店舗運営用に構成する際に発生する可能性のある一般的なエラーを以下に示します。

Azure OpenAI キーのシリアル化解除に失敗しました: 応答ステータス コードは成功を示しません: 403 (Forbidden)

このエラーは、必要な権限に問題があることを示唆しています。 アプリ登録用の 投稿者 ロールが存在しない場合、このエラーが発生する可能性があります。 この問題は、Azure portal のアプリ登録に 投稿者 ロールを割り当てることで解決できます。

無効なリクエスト: リクエストは無効です、HTTP ステータス: 404

このエラーは、Azure OpenAI セットアップの Store Operations の構成に誤った値が設定されている場合に発生します。 これらの構成値を修正すると、問題が解決します。

識別子「a1ade287-xxxx-4ad4-xxxx-20310ffbb47f」を持つアプリケーションがディレクトリに見つかりませんでした

このエラーは、Azure OpenAI セットアップ - 認証の Store Operations の構成で誤ったアプリ登録 ID 値が設定されている場合に発生します。 正しい値が設定されていることを確認すると、問題は解決します。

PluginAssembly 7eed7839-xxxx-4b54-xxxx-f6609a55198a がマネージド IDに関連付けられていません

このエラーは通常、ソリューションの更新後に発生します。 この問題は、Azure OpenAI セットアップの Store Operations の認証ウィンドウでアプリ ID とクライアント シークレットの値が正しく設定されていることを確認することで解決できます。

Azure Cognitive Search の呼び出し時にエラーが発生しました: Azure Search Error: 400, message='Server responded with status 429'

このエラーにクォータ制限の詳細が含まれている場合、断続的な問題であれば、通常は数秒後に解決します。 再試行で解決する場合があります。

Azure Cognitive Search の呼び出し時にエラーが発生しました: Azure Search Error: 503, message='Server responded with status 503'

このエラーが調整の問題を示している場合は、検索サービスがその容量に近づいていることを示唆しています。 通常、断続的な問題の場合は、数秒後に自動的に解決されます。 この場合、再試行が役立つ場合があります。

Store Operations 管理ポータルの権限の問題を修正する

Store Operations 管理者ポータルで Azure OpenAI 構成を開けない場合は、レコードが見つからないことが原因である可能性があります。 この問題は、ブラウザのコンソールでクエリを使用して手動で解決できます。

1. ブラウザーで Store Operations 管理ポータルを開き、検査 を選択してコンソールを開きます。

2. コンソール タブを選択し、次のクエリを入力します。 resource_name を AI 店舗運営リソースの名前に置き換えます。

   
   var data = {"msiai\_aoaiconfigurationid": "3c8f9f1c-6238-ee11-be6d-000d3a318cdb", "msiai\_name": "Keys", "msiai\_resourcename": "resource\_name"}  
   Xrm.WebApi.createRecord("msiai\_aoaiconfiguration", data)
   
   

3. 入力 を押してクエリを送信します。