トラブルシューティング 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をローカルで実行します。 依存関係、構文、またはテストの失敗を修正し、変更をプッシュしますデプロイメントは成功しましたが、変更がありません
想定されたコミットがプッシュされ、同じ環境に再デプロイされたことを確認します
アクションは引き続きデプロイされていません
アクションを確認するか、そのメタデータを変更した後に、もう一度展開します
ChatGPT プラグイン
症状
体験する施策
プラグインが表示されない
開発者モードを有効にし、chatgpt.com/pluginsを開き、プラグインが存在することを確認して、接続を選択します
プラグインの作成に失敗する
開発者モードが有効になっていることを確認し、アプリをテストしてからMCP サーバーのURLをもう一度コピーし、認証なしで サーバーのURL を使用します
プラグインは接続しますが、アクションを呼び出すことができません
プラグインがチャットに添付され、アクションがモデルに公開され、最新バージョンがデプロイされていることを確認します
プラグインが間違った環境を使用しています
目的のステージングまたは実稼動MCP サーバーのURLを使用して、プラグインを編集または再作成します
問題が解決しない場合は、Beta チームに連絡する前に、アプリ名、環境、失敗した手順、時間、表示されるエラーメッセージを記録してください。 機密情報や機密性の高い顧客データは含めないでください。
recommendation-more-help
llm-apps-help-main-toc