问题排查
提示词执行后未能得到预期结果时的处理方法,以及开发团队跟踪的已知不具合。如有重现的症状,请通过 支持・反馈 附上版本号报告 —— 可加快修复速度。
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(零销售定向切出)
对应方法: 重复在执行时自动排除,因此无运维影响。表观件数比实际多,但 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 重新执行,或等待数据累积。
Q. 发送提示词后没有任何返回
Section titled “Q. 发送提示词后没有任何返回”可能是连接断开或提示词未被智能体识别。
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 的响应。处理海外销售(US / EU / UK)的 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 连接。
如遇本页未列出的症状,请通过 支持・反馈 提示词 1 报告,开发团队会着手对应。附上版本号(连接广告账户 提示词 4 中获取)可加快修复。