连接广告账号
开始使用 Picaro.AI 所需的 连接设置 提示词集合。账号切换以及连接断开时的重新登录也在此处理。
本类别的适用场景
Section titled “本类别的适用场景”- 「想确认当前的连接状态和默认账号」
- 「想切换到其他亚马逊广告账号」
- 「连接似乎已断开，想重新登录」
- 「为了创建新的广告活动，想连接亚马逊广告账号」
提示词 1：确认连接状态与切换账号
Section titled “提示词 1：确认连接状态与切换账号”确认当前的 Picaro 连接和默认账号，必要时切换到其他账号。
📋 适用场景
Section titled “📋 适用场景”- 想确认当前的连接状态
- 想确认当前在哪个账号下操作
- 想切换到其他账号
确认当前的 Picaro 连接与默认账号：1. 确认 Picaro 连接是否有效2. 确认当前默认账号及最近一次切换后经过的时间3. 获取可访问的亚马逊广告账号列表4. 必要时切换至 {{TARGET_ACCOUNT}}
代理公司管理多个客户时，与其每次都指定 account_id，不如先切换好，之后系统会自动在该账号下运作。占位符：
| 占位符 | 说明 | 默认解析来源 |
|---|---|---|
{{TARGET_ACCOUNT}} | 想切换到的亚马逊广告账号名称或 ID（例：「客户 A」「JP-12345」） | 未指定时仅显示列表，不执行切换 |
⚙️ AI 执行的操作
Section titled “⚙️ AI 执行的操作”- 确认 Picaro 连接是否有效 — 若连接已断开，引导至提示词 2 的重新登录流程
- 为什么放在最前：连接无效时后续步骤都会失败，应在入口处拦截
- 显示默认账号及切换后的经过时间 — 同时显示最近一次切换以来的间隔
- 为什么显示经过时间：便于判断是否仍在使用过旧的账号设定操作
- 获取可访问的亚马逊广告账号列表 — 显示具有访问权限的全部账号
- 必要时执行切换 — 对指定账号验证访问权限后再保存
- 为什么验证后保存：防止意外切换到错误账号
📊 Example Output
Section titled “📊 Example Output”Picaro 连接：有效（连接至 picaro.ai，最近确认于 2 分钟前）
默认账号：客户 A（JP-12345，距上次切换已 14 天）
可访问的亚马逊广告账号：4 个
# 显示名 账号 ID 国家 默认 1 客户 A JP-12345 JP ✓ 2 客户 B JP-23456 JP — 3 客户 C US-34567 US — 4 内部测试 JP-99999 JP — 若需切换，可使用「切换到 2 号」之类的指令。
🔒 安全机制
Section titled “🔒 安全机制”- 切换时先验证访问权限再保存（无权限的账号无法切换）
- 未明确说「切换」时不会变更默认账号
- 切换历史会记录在连接日志中，事后可查询何时切换到了哪个账号
- 仅获取列表时不会发生写入操作
🚦 执行模式
Section titled “🚦 执行模式”| Phase | 状态 | 条件 |
|---|---|---|
| Phase 1（现在） | 一次性 | 仅需 Picaro 连接即可使用 |
| Phase 2（Q3 2026） | 保持一次性 | 「一旦决定半年内不变」，自动化优先级较低 |
| Phase 3（Q4 2026） | 一次性（仅在过期时） | 连接到期时发出通知 |
| Phase 4（2027） | 自动更新 + 失效时通知 | 连接失效时发出通知并提供重新登录入口 |
- 设定月度 KPI 目标 — 确定默认账号后，注册目标 ACoS 与 TACoS，之后的提示词将自动引用
- 标签管理 — 按账号设计商品分类体系（taxonomy），即可使用按标签的 KPI 汇总
提示词 2：连接错误时的重新登录
Section titled “提示词 2：连接错误时的重新登录”将过期或认证已失效的 Picaro 连接，以相同用户身份安全地更新。
📋 适用场景
Section titled “📋 适用场景”- 出现连接错误提示，想要解决
- 在 Picaro.AI 重新登录后想同步更新 AI 智能体环境的连接
- 出现「认证已过期」之类的提示，想要应对
更新 Picaro 连接：1. 获取重新登录用的 URL2. 在浏览器中打开该 URL，登录 Picaro.AI3. 完成后再次发送提示词，新连接即生效
注意：如需切换到其他 Picaro 账号，需要先在 AI 智能体环境的 Picaro 扩展中断开再重新连接。（此重新登录流程无法切换账号）占位符：无（固定为同一用户的重新登录）
⚙️ AI 执行的操作
Section titled “⚙️ AI 执行的操作”- 签发重新登录 URL — URL 带有短期有效期
- 为什么短期有效：降低第三方拾取 URL 后被滥用的风险
- 引导浏览器跳转 — 打开该 URL，在 Picaro.AI 完成登录
- 指引在新连接下重新执行 — 登录完成后，在同一会话中再次发送提示词，即可在新连接下运作
- 为什么需要「再次发送提示词」：连接信息会在下一次提示词发送时重新加载
📊 Example Output
Section titled “📊 Example Output”已签发重新登录 URL
请在 10 分钟内于浏览器打开以下 URL，并登录 Picaro.AI：
https://picaro.ai/auth/reconnect?token=...完成后请在本对话再次发送操作内容，将在新连接下重新执行。
如需切换到其他 Picaro 账号，请勿使用本流程，而应在 AI 智能体环境的 Picaro 扩展中断开后再重新连接。
🔒 安全机制
Section titled “🔒 安全机制”- 重新登录 URL 必须在 10 分钟内 使用（超时需重新签发）
- URL 与签发该会话的用户绑定，无法用于切换到其他账号
- 需要切换到其他账号时，会明确引导至另一路径（AI 智能体环境的扩展重新连接）
- 浏览器操作由用户本人执行，AI 不会以错误账号登录
🚦 执行模式
Section titled “🚦 执行模式”| Phase | 状态 | 条件 |
|---|---|---|
| Phase 1（现在） | 一次性 | 出错时即时执行 |
| Phase 2（Q3 2026） | 保持一次性 | 连接更新约半年一次，自动化优先级较低 |
| Phase 3（Q4 2026） | 一次性（仅在过期时） | 收到过期通知后一键签发 URL |
| Phase 4（2027） | 自动更新 + 失效时通知 | 通过 refresh token 自动更新，仅在失效时通知 |
- 确认连接状态与切换账号 — 重新登录后可顺便确认默认账号是否符合预期
- 支持与反馈 — 若重新登录后仍出现连接错误，附上版本信息反馈可加快修复
❓ 常见问题
Section titled “❓ 常见问题”Q：重新登录 URL 已过期。 A：再次发送同样的提示词即可签发新的 URL，旧 URL 将失效。
Q：想切换到其他 Picaro 账号。 A：此重新登录流程无法切换。请在 AI 智能体环境的 Picaro 扩展中断开后，再用其他账号重新连接。
提示词 3：连接亚马逊广告账号（用于新建广告活动）
Section titled “提示词 3：连接亚马逊广告账号（用于新建广告活动）”作为创建新广告活动的前置步骤，将亚马逊广告账号连接到 Picaro，并获取可用的广告档案。
📋 适用场景
Section titled “📋 适用场景”- 为了创建新的广告活动想连接亚马逊广告账号
- 想在连接后确认可用的广告档案
- 想在进入广告活动创建提示词前整备前提
为新建广告活动连接亚马逊广告账号：1. 确认当前连接状态2. 若未连接，则获取连接用 URL3. 在浏览器中打开该 URL 并登录亚马逊4. 完成后获取可用的广告档案列表5. 使用获取到的档案创建广告活动
注意：此连接仅在创建新的广告活动时需要。广告数据的取得、分析、优化以及仪表盘显示均不需要。占位符：无（连接对象在连接流程中由亚马逊侧 UI 选择）
⚙️ AI 执行的操作
Section titled “⚙️ AI 执行的操作”- 确认当前的亚马逊广告账号连接状态 — 若已连接则跳至第 4 步获取档案列表
- 为什么先确认：已连接时再要求重新登录，会因二次认证引起混乱
- 未连接时签发连接用 URL — 生成跳转至亚马逊侧授权页的 URL
- 指引浏览器操作 — 由用户登录亚马逊并对目标账号进行授权
- 获取广告档案列表 — 连接后按国家分组展示可用档案
- 为什么按国家分组：同一广告主在不同国家拥有不同档案，分组可防止误连接
- 引导至广告活动创建提示词 — 取得的档案 ID 将在下一提示词使用
📊 Example Output
Section titled “📊 Example Output”亚马逊广告账号连接：未连接
请在浏览器中打开以下 URL，并登录亚马逊：
https://picaro.ai/auth/amazon-ads?token=...登录后请选择要连接的广告账号并完成授权。
连接完成后（参考）
可用的广告档案：3 个
# 档案名 国家 账号类型 1 Picaro Brand JP JP Seller 2 Picaro Brand US US Seller 3 Picaro Vendor JP JP Vendor 如需继续创建广告活动，可使用「以 1 号档案创建广告活动」之类的指令。
🔒 安全机制
Section titled “🔒 安全机制”- 连接用 URL 带有短期有效期
- 连接前会明确说明「这是为新建广告活动而设的连接，数据取得、分析、优化均不需要」
- 连接范围仅限广告管理所需权限（不会触及订单信息等无关数据）
- 浏览器中的授权由用户本人执行，不会发生连接到错误账号的情况
- 已连接时不会再要求重新认证
🚦 执行模式
Section titled “🚦 执行模式”| Phase | 状态 | 条件 |
|---|---|---|
| Phase 1（现在） | 一次性 | 仅在新建广告活动时执行 |
| Phase 2（Q3 2026） | 保持一次性 | 连接通常只需一次，不在自动化范围内 |
| Phase 3（Q4 2026） | 保持一次性 | 检测到失效时发出通知 |
| Phase 4（2027） | 完全自动（refresh token） | 通过 refresh token 自动更新，仅在失效时提示重新认证 |
❓ 常见问题
Section titled “❓ 常见问题”Q：已连接但创建广告活动时仍出错。 A：可能是档案选择有误。请在提示词 1 中确认可访问的账号，并重新指定目标国家的档案。
Q：想解除过去连接的账号。 A：可在亚马逊侧的安全页面解除应用授权，Picaro 侧会在之后的首次访问中检测到失效。
提示词 4：版本确认
Section titled “提示词 4：版本确认”获取当前所用 Picaro.AI 的版本与构建时间，整理出可附在缺陷报告或咨询中的信息。
📋 适用场景
Section titled “📋 适用场景”- 想确认当前所用 Picaro.AI 的版本
- 想知道是否运行在最新版本上
- 想为缺陷报告获取所需信息
获取当前所用 Picaro.AI 的版本信息：- 版本号- 构建时间- 该版本的主要变更点
缺陷报告时附上该版本号，将有助于加快修复。占位符：无
⚙️ AI 执行的操作
Section titled “⚙️ AI 执行的操作”- 获取版本号 — 当前 AI 智能体环境所连接 Picaro.AI 的语义化版本
- 为什么是版本号：在锁定修复对象时是最可靠的线索
- 获取构建时间 — 该版本何时构建
- 显示近期变更点 — 发布说明中记载的主要变更
- 生成缺陷报告用的粘贴文本 — 报告时可直接使用的一行摘要
📊 Example Output
Section titled “📊 Example Output”Picaro.AI 版本信息
- 版本：
2.14.3- 构建时间：2026-05-15 09:22 JST
- 连接至：
picaro-mcp-server.workers.dev主要变更点（2.14.3）
- 缩短了 N-gram 分析的处理时间
- 改进了商品推广（SP）按标签的 KPI 汇总
- 出价优化更稳定
缺陷报告时请附上：
Picaro.AI 2.14.3 (2026-05-15 build)
🔒 安全机制
Section titled “🔒 安全机制”- 只读操作（不会发生写入或计费变更）
- 输出中不包含内部 API 密钥、连接令牌等敏感信息
- 显示的发布说明仅限已公开内容
🚦 执行模式
Section titled “🚦 执行模式”| Phase | 状态 | 条件 |
|---|---|---|
| Phase 1（现在） | 一次性 | 按需即时执行 |
| Phase 2（Q3 2026） | 保持一次性 | 版本确认时机不固定，不在自动化范围内 |
| Phase 3（Q4 2026） | 保持一次性 | 重大版本更新时发出通知 |
| Phase 4（2027） | 保持一次性 + 自动通知 | 出现版本升级带来的不兼容变更时自动通知 |
- 支持与反馈 — 附上取得的版本信息进行反馈，可加快支持响应
- 确认连接状态与切换账号 — 版本更新后可顺便确认默认账号是否符合预期
提示词速查表
Section titled “提示词速查表”| 想做的事 | 使用的提示词 |
|---|---|
| 确认连接状态 / 切换账号 | 提示词 1 |
| 连接错误时的重新登录 | 提示词 2 |
| 为新建广告活动连接亚马逊广告账号 | 提示词 3 |
| 版本确认 | 提示词 4 |
- 设定月度 KPI 目标 — 连接完成后注册目标 ACoS 与 TACoS，之后的提示词将自动引用
- 创建广告活动 — 在提示词 3 完成连接后进入
- 支持与反馈 — 附上提示词 4 的版本信息可加快修复