困ったとき
プロンプトを実行して期待通りの結果が出ない時の対処法と、開発チームが把握している既知の不具合をまとめます。再現する症状があれば、サポート・フィードバック からバージョン番号を添えて報告いただけると修正が速くなります。
まず確認すること
Section titled “まず確認すること”1. Picaro 接続が有効か
Section titled “1. Picaro 接続が有効か”接続エラー・認証エラーのほとんどは Picaro 接続が切れているのが原因です。広告アカウントを接続する のプロンプト 1 で接続状況を確認してください。期限切れの場合は同カテゴリのプロンプト 2 で AI エージェント環境の Custom Connector を再接続します。
2. バージョンが古くないか
Section titled “2. バージョンが古くないか”広告アカウントを接続する のプロンプト 4 で現在のバージョンを確認してください。利用している AI エージェント環境の拡張機能を再インストールするとアップデートされます（MCP 接続の場合）。
3. アカウント切替が意図通りか
Section titled “3. アカウント切替が意図通りか”代理店で複数クライアントを管理している場合、想定外のアカウントで操作している可能性があります。プロンプト 1 で「現在の既定アカウント」を確認してください。
既知の不具合（修正中）
Section titled “既知の不具合（修正中）”開発チームが認識している不具合と対処法です。それぞれフィードバック登録済みで、解決次第このページから削除します。
OpenAPI ツール認識不可問題
Section titled “OpenAPI ツール認識不可問題”症状: AI エージェント環境で「このツールは利用可能なツール一覧に含まれていません」と表示される。MCP サーバーには存在するツールが認識されない。
該当ツール（一例）:
assign_search_term_labels/assign_product_labels/assign_dsp_labelscheck_budget_statusdiscover_report_sources/collect_report_dataset/build_report_slide_specprecheck_contribution_datapreview_search_term_action_workflow
対処法: 代替手段を AI エージェントが自動で提案します。利用している AI エージェント環境の拡張機能経由（MCP 直接呼び出し）では動作する可能性があります。修正完了次第この一覧から削除されます。
detect_negatives / analyze_promotion の重複表示バグ
Section titled “detect_negatives / analyze_promotion の重複表示バグ”症状: 除外キーワード候補や Auto→Manual 昇格候補で、同じ検索語句が複数回（最大 3 回）表示される。
該当プロンプト:
- 除外キーワードを追加する プロンプト 1, 3
- Auto から Manual に昇格する プロンプト 1, 2
- 入札単価を調整する プロンプト 3（売上ゼロ切り出し）
対処法: 重複は実行時に自動で除外されるため運用上の影響はありません。見かけの件数が実件数より多くなりますが、reported_items の item_id が同じものは 1 件として扱われます。
RainForest API（外部 API）の障害
Section titled “RainForest API（外部 API）の障害”症状: 競合 ASIN 自動ラベリングが「商品情報取得失敗（HTTP 403）」で 0 件返却される。
該当プロンプト: ラベル分類を設計する プロンプト 1
対処法: 外部の RainForest API 側の一時的な障害が原因です。時間を置いて再実行してください。再現が続く場合はフィードバックでご連絡ください。
get_dashboard の KPI=0 集計問題
Section titled “get_dashboard の KPI=0 集計問題”症状: ダッシュボードで KPI を見る のプロンプト 1 で、広告費・売上・注文数などが 0 で返却される（売上トレンドだけ値が入る矛盾もあり得ます）。
該当プロンプト: ダッシュボードで KPI を見る プロンプト 1
対処法: 期間と frequency の組み合わせによっては 0 で返ることがあります。frequency=monthly で 30 日範囲を指定した場合などに発生しやすいので、frequency=daily で再実行してください。
placement-table の orders=0 集計問題
Section titled “placement-table の orders=0 集計問題”症状: 掲載位置別の入札倍率調整提案で、orders が全行 0 で返却され、CVR 比率ベースの推奨倍率が出ない。
該当プロンプト: 入札単価を調整する プロンプト 6
対処法: 注文データの集計問題で、min_clicks を下げて再実行するか、データ蓄積を待ってください。
よくある質問
Section titled “よくある質問”Q. プロンプトを送ったら何も返ってこない
Section titled “Q. プロンプトを送ったら何も返ってこない”接続が切れているか、プロンプトがエージェントに認識されていない可能性があります。
- 広告アカウントを接続する のプロンプト 1 で接続状況を確認
- サポート・フィードバック でバージョン情報を確認
- 利用している AI エージェント環境の拡張機能を再起動（MCP 接続の場合）
Q. 提案 ID の有効期限が切れた
Section titled “Q. 提案 ID の有効期限が切れた”提案には 24 時間の TTL があります。再度同じ条件で最適化プロンプトを実行して新しい提案 ID を取得してください。extend_proposal で最大 48 時間まで延長することもできます。
Q. KPI 目標を登録したのに自動参照されない
Section titled “Q. KPI 目標を登録したのに自動参照されない”KPI 目標は登録した月のプロンプトで自動参照されます。対象月が正しく登録されているかを 月次 KPI 目標を設定する のプロンプト 2 で確認してください。
Q. ASIN ラベリングの結果が薄い
Section titled “Q. ASIN ラベリングの結果が薄い”外部 RainForest API のレスポンスに依存します。海外販路の ASIN を扱う場合は、先に ラベル分類を設計する のプロンプト 5 で update_asin_enrichment を実行して amazon_domain / currency / language を登録してください。
Q. SQP データが取れない
Section titled “Q. SQP データが取れない”SQP で市場検索ファネルを見る は、Brand Analytics に登録された商品のみ対応します。list_sqp_products で data_crawled 状態の商品のみが対象です（not_monitor 状態の商品は SQP 分析に使えません）。
Q. 「承認するまで反映されません」と出るが反映したい
Section titled “Q. 「承認するまで反映されません」と出るが反映したい”提案を生成した直後に「実行して」「承認して」と返してください。全件反映する場合は何も追加指定不要、部分反映する場合は提案項目 ID を指定します。詳細は 自動化ルールを設定する のプロンプト 2 を参照してください。
Q. Amazon Ads OAuth が必要と表示される
Section titled “Q. Amazon Ads OAuth が必要と表示される”新規キャンペーン作成（キャンペーンを作る）には Amazon 広告アカウント連携が必要です。データ取得・分析・最適化・ダッシュボード表示には不要です。広告アカウントを接続する のプロンプト 3 で連携してください。
報告のお願い
Section titled “報告のお願い”このページに載っていない症状が出た場合は、サポート・フィードバック のプロンプト 1 から報告いただけると、開発チームが対応に向けて動きます。バージョン番号（広告アカウントを接続する のプロンプト 4 で取得）を添えていただけると修正が速くなります。