アプリ接続のトラブルシューティング

アプリがロード、接続、再接続、ツールアクセスの保存、または切断されない場合の問題を診断します。

アプリがロード、接続、再接続、ツールアクセスの保存、または期待どおりに切断されない場合は、このガイドを使用します。プロバイダーフローを盲目的に繰り返すのではなく、Runner が実際に表示している状態から開始します。

エントリパス: プロジェクト → アプリ

開始する前に

対象プロジェクトとワークスペースのアプリを開いているか確認します。
ツールを検索とカテゴリを解除します。
一度更新して接続状態を待ちます。
接続、接続中…、接続済み、再接続、審査中、要対応の表示を読みます。
状態に合った復旧操作だけを使用します。
キー、シークレット、本人確認書類、支払い情報、完全なコールバックURLをサポートの文章や画像に含めないでください。

英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。

検索で一覧を絞り込めます。見つからない場合は、リクエスト前に検索とフィルターを解除してください。検索結果は承認済み接続ではありません。画像は英語の画面です。

重要なコントロールと結果

コントロール	選択後に何が起こるか
検索をクリア	現在の Agent アプリ検索を削除して、利用可能なカタログが再度表示されるようにします。
接続 / 接続して認可	そのアプリのセットアップまたは外部認可フローを開きます。
再接続（表示される場合）	既存のプロバイダー接続の認可を再開します。
再試行	現在のパネルで表示されている失敗したカタログ、ツールリスト、または接続リクエストを繰り返します。
オンボーディングを続行	アクションが必要な場合、既存の Stripe オンボーディングフローに戻ります。
切断	確認を開くか、文書化された削除フローを開始します。プロバイダー側の認証情報を変更する前に保存された状態を確認します。

症状と復旧表

表示内容	可能性のある意味	安全な次のアクション
アプリが見つからない	検索、カテゴリ、ワークスペースアクセス、または条件付き機能がそれを非表示にしています。	検索をクリアし、すべてを選択してから、この機能がこのワークスペースで利用可能であることを確認します。
カードがロード中のままです	Runner は保存された接続を解決していません。	アプリを 1 回更新します。状態が不明な間に別の接続を送信しないでください。
アプリが見つかりません	Agent アプリが現在のフィルターと一致しません。	検索をクリアを選択します。
接続が何もしない	必須フィールドが空または無効であるか、プロバイダーフローを開始できませんでした。	フィールドエラーを読み、必須値を再度コピーし、該当する場合はプロバイダーポップアップを許可します。
接続中… が終了しない	外部認可が閉じられた、ブロックされた、または結果を返しませんでした。	アプリに戻り、状態を更新してから、Runner が提供する場合は再接続を使用します。
プロバイダーは成功と言いますが Runner は言いません	Runner は使用可能な接続を確認していません。	アプリを再度開きます。接続済みのみを成功として扱い、重複を作成する代わりに再接続を使用します。
再接続	既存の認可に注意が必要です。	それを選択し、プロバイダーフローを再度完了します。
レビュー待機中	Stripe は送信された詳細を確認しています。	アクション通知に従ってください。ラベルを削除するためだけに別のアカウントを開始しないでください。
Stripe アクションが必要	Stripe は情報が必要であるか、機能を一時停止しています。	今すぐ期限、後で期限、確認中、支払い、およびペイアウト通知を確認してから、表示される場合はオンボーディングを続行を使用します。
API キーまたはシークレットが拒否されました	値が間違っている、期限切れ、間違ったアカウントからのもの、またはこの統合で受け入れられていません。	プロバイダーから再度コピーします。推測でシークレットを編集しないでください。
Shopify ドメインが無効です	値が永続的な Shopify ストアドメインではありません。	カスタムストアフロントドメインではなく `your-store.myshopify.com` を使用します。
Agent アプリ認可ウィンドウがブロックされています	ブラウザが外部フローを防止しました。	Runner のポップアップを許可し、接続して認可を再度開始します。
Agent アプリツールがロードに失敗します	Runner はそのアプリのツールリストを取得できませんでした。	アプリ詳細で再試行を選択します。
ツールスイッチが失敗を報告します	新しいツール設定は保存されませんでした。	スイッチが更新されるまで待ち、現在の状態を確認してから、1 回再試行します。
切断が失敗を報告します	Runner は削除を確認しませんでした。	既存の接続がまだアクティブであると想定し、再度試行する前にアプリを再度開きます。