トラブルシューティング troubleshooting
IMPORTANT
Adobe LLM Appsは現在Betaにいます。
ここに示す機能、ワークフロー、UIは、必ずしも製品の最終状態を表すものではありません。 Betaに参加するには、llm-apps-beta@adobe.comに電子メールを送信します。
ご覧の症状から始めます。 トラブルシューティング中は、資格情報、トークン、プライベート MCP URL、機密性の高いハンドラーの結果を共有しないでください。
アプリの作成とオンボーディング
症状
体験する施策
新しいリポジトリが表示されない
「GitHubでリポジトリを管理」を選択し、Adobe LLM Apps GitHub アプリに両方のリポジトリへのアクセス権を付与し、ダイアログに戻ってリストを更新します
EDS リポジトリにはAEM Code Syncが必要です
EDS リポジトリ用のAEM Code Syncをインストールしてから、「LLM アプリを作成」ダイアログに戻ります
EDS検証では、管理者ではないことが示されます
「AEM Live Adminを開く」を選択し、自分をEDS サイトの管理者として追加してから、リポジトリを更新します
オンボーディングは
約15分。 ページを離れて、後で戻ることはできます
オンボーディングレポートの失敗
両方のリポジトリにアクセス可能であること、およびweb サイトがHTTPS経由で公開されていることを確認してから、表示されるエラーメッセージをBeta チームに連絡します
アクションとハンドラー
症状
体験する施策
アクションは呼び出されません
ChatGPT プラグインを添付し、AI モデルへの公開が有効になっていることを確認し、アクションの説明を改善して、メタデータの変更を再展開します
空またはエラーの応答
ハンドラーはローカルで動作しますが、デプロイメント後は動作しません
最新のコミットがプッシュされ、ランタイム設定が存在し、アクションコード識別子が
actions/<code-identifier>/index.jsと一致することを確認します生成されたアクションをレビュー済みとしてマークすることはできません
ハンドラーとウィジェットの生成が成功したことを確認します。 生成されたプル要求を確認して結合の競合を確認し、アクションを再読み込みして、レビュー済みとしてマークをもう一度選択します
ウィジェット
症状
体験する施策
Widgetがレンダリングされない
スクリプト URL、ウィジェット URL、HTTPS、EDS パブリケーション、CSP ドメイン、およびCORS ヘッダーを確認します
ウィジェットはレンダリングされますが、データは表示されません
MCP Inspectorでハンドラーを呼び出し、
structuredContentの形状をbridge.toolResultから読み取ったフィールドと比較しますWidgetは直接プレビューでは機能しますが、ChatGPTでは機能しません
直接プレビューでは、サンプルデータを使用できます。 デプロイされたハンドラー結果をテストし、EDS オリジンがCORSおよびCSPで許可されていることを確認します
ブラウザーリクエストはブロックされています
必要なオリジンのみを正しいCSP フィールドに追加し、再展開します
HTTP ヘッダーエディターは設定を保存できません
AEM Configuration Serviceを使用するか、EDS管理者にサイトヘッダー設定の初期化を依頼します
個人データや機密データを含めることができる完全なbridge.toolResult値は記録しないでください。
デプロイメント
症状
体験する施策
準備中にデプロイメントが失敗しました
ハンドラーリポジトリがリンクされていて、Adobe Developer Console アクセスが有効であることを確認します
ビルド アプリ中にデプロイメントが失敗しました
npm install、npm test、npm run buildをローカルで実行します。 依存関係、構文、またはテストの失敗を修正し、変更をプッシュしますデプロイメントは成功しましたが、変更がありません
想定されたコミットがプッシュされ、同じ環境に再デプロイされたことを確認します
アクションは引き続きデプロイされていません
アクションを確認するか、そのメタデータを変更した後に、もう一度展開します
認証 authentication
認証を有効にするがオンの場合に適用されます。 独自のID プロバイダーでエンドユーザーを認証するを参照してください。
症状
体験する施策
設定を保存した後もアクションは公開されたままです
その環境にアプリを再びデプロイします。 認証の変更は、次のデプロイで有効になります
環境を切り替えると設定が正しく表示されない
Workspace ピッカーに、意図した環境が表示されていることを確認します。 ステージと 実稼動 は個別に設定されています
ログインが開始されない
認証を有効にしてからアプリがデプロイされていることを確認してください。また、呼び出すアクションが 必須 に設定されていることを確認してください。 オプション アクションは、ハンドラーがサインインを要求する場合にのみプロンプトが表示されます
プラットフォームが間違ったログインページにユーザーを送信する
発行者がID プロバイダーの発行者URLと完全に一致し、パブリック HTTPS経由で到達できることを確認します
ログインは成功しますが、すべての呼び出しは拒否されます
ID プロバイダーが、その環境のアプリのMCP サーバーURLをオーディエンスとするトークンを発行し、トークンが非対称アルゴリズムで署名されたJWTであることを確認します。 トークン要件を参照してください
ID プロバイダーはトラフィックを受信しません
プロバイダーの検出、認証、トークンのエンドポイントは、パブリック HTTPS経由で到達できる必要があります。 ファイアウォール、WAF、IP アドレスが手前にあることを確認します。プロバイダーが手元にない場合は、アプリにアクセスできます
ID プロバイダーは、要求されたオーディエンスに対するトークンの発行を拒否します
一部のプロバイダーは、登録されているリソースに対してのみトークンを発行します。 アプリのMCP サーバーURLがID プロバイダーのリソース識別子として登録されていることを確認します
ログイン時に新しく追加されたスコープは要求されません
LLM プラットフォームは、アプリが公開したメタデータを数分キャッシュします。 待ってから、ログインを再試行してください
ユーザーは、スコープのために再度ログインするよう求められます
アクションには、トークンが実行しないスコープが必要です。 ID プロバイダーのクライアントの付与にスコープを追加するか、アクションから削除します
ユーザーは、ループで何度もログインするよう求められます
どの電話でも対応が難しくなります。 呼び出し元が既に認証されているかどうかを最初に確認せずに
extra.challengeAuth()を返すハンドラーは、再びサインインすると同じ課題が発生するため、満たすことができません。 アクションに必要なIDが欠落している場合にのみ課題を設定しますユーザーがID プロバイダーに到達する前に、ログインが拒否されます
LLM プラットフォームが送信したリダイレクト URIが、認証サーバーに登録されていません。 一部のプラットフォームではコネクタごとに異なるコネクタが発行されるため、コネクタ設定画面に表示される値を登録します
サポートされていない範囲メッセージで保存がブロックされています
スコープを サポート対象 に追加するか、スコープを必要とするアクションから削除します
Noneに設定されたアクションは、引き続きログインを求めます
Claudeでは、アクションではなくコネクタごとに認証されます。
すべてのアクションが None であるにもかかわらず、アプリはログインを求めるメッセージを表示します
認証を有効にするをオフにしてデプロイします。 オンになっている間、アクションがゲーテッド化されていない場合でも、アプリは認証サーバーをアドバタイズします
アクセストークン、要求セット、またはID プロバイダーのクライアントシークレットをサポートリクエストに貼り付けないでください。
ChatGPT プラグイン
症状
体験する施策
プラグインが表示されない
開発者モードを有効にし、chatgpt.com/pluginsを開き、プラグインが存在することを確認して、接続を選択します
プラグインの作成に失敗する
開発者モードが有効になっていることを確認し、アプリをテストしてからMCP サーバーのURLをもう一度コピーし、認証なしで サーバーのURL を使用します
プラグインは接続しますが、アクションを呼び出すことができません
プラグインがチャットに添付され、アクションがモデルに公開され、最新バージョンがデプロイされていることを確認します
プラグインが間違った環境を使用しています
目的のステージングまたは実稼動MCP サーバーのURLを使用して、プラグインを編集または再作成します
問題が解決しない場合は、Beta チームに連絡する前に、アプリ名、環境、失敗した手順、時間、表示されるエラーメッセージを記録してください。 機密情報や機密性の高い顧客データは含めないでください。
recommendation-more-help
llm-apps-help-main-toc