投放Agent自动化体验测试

通过 Playwright 浏览器自动化 + Cookie注入 对 ad.qq.com 投放Agent功能进行完整UX测试。

前置条件

1. 中文字体：服务器需安装中文字体（否则截图中文为方块）
2. Cookie：需要用户提供有效的 adhome 免登录 Cookie
3. Playwright：需要 Node.js + playwright 已安装

安装中文字体

yum install -y google-noto-sans-cjk-sc-fonts

检查Playwright

npx playwright --version

Cookie 获取流程

引导用户操作：

1. 打开 adhome 免登录页面，选择目标账户
2. 点击免登录进入 ad.qq.com/atlas/{account_id}/agent
3. 在浏览器 F12 控制台执行 document.cookie
4. 将结果发给 Agent

Cookie 解析要点

• 必需Cookie：gdt_mlogin、gdt_owner、tap_free_login_token、tap_free_login_userid
• .woa.com 域Cookie（RIO_TOKEN等）用于内网认证
• .qq.com 域Cookie（ptcz、RK等）用于QQ登录态
• Cookie有效期约2小时（会话级），过期会跳转登录页

Cookie 注入代码模板

参见 [scripts/inject_cookies.js](scripts/inject_cookies.js) — 解析用户提供的 cookie 字符串并注入到 Playwright context。

测试流程

第一阶段：环境验证

1. 注入Cookie
2. 访问 https://ad.qq.com/atlas/{account_id}/agent
3. 等待8秒页面加载
4. 验证是否进入Agent页面（非登录页）— 检查页面是否包含"对话"/"妙招"等文字

第二阶段：对话功能测试

2.1 首页快捷指令

遍历首页展示的快捷指令卡片（通常4个），依次：

1. 点击指令
2. 等待3秒
3. 截图记录模板展示
4. 提取输入框中的模板文案（含slot类型）
5. 新开会话测试下一个

2.2 常用指令面板

1. 点击底部"常用指令"按钮（[title="常用指令"]）
2. 截图完整指令面板
3. 提取所有指令分类和名称

2.3 模板Slot交互

1. 点击快捷指令后，在模板中点击 asset slot
2. 记录下拉列表内容
3. 点击 select slot，记录选项

2.4 自由对话

测试覆盖投放全链路：

投放前：

• 预算规划："我有5000元预算，想推广一个教育类小程序，应该怎么设置投放计划？"
• 选品定向："我是做电商的，卖女装，适合选择什么投放版位和定向人群？"

投放中：

• 数据查询："帮我查一下今天的广告消耗和转化数据"
• 优化建议："我的广告点击率很低只有0.5%，有什么优化建议？"
• 调预算："帮我把所有在投的广告日预算统一调整到200元"

投放后：

• 复盘分析："帮我分析一下上周的投放效果，哪些广告ROI最高？"
• 批量关停："帮我把转化成本超过50元的广告全部暂停"

每轮对话：输入 → 等待25秒 → 截图 → 提取回复文本

第三阶段：妙招功能测试

1. 切换到妙招页面（点击侧边栏"妙招"或首页"探索投放妙招"卡片）
2. 逐一点击每个妙招卡片，截图配置面板
3. 测试"一键执行"：

- 验证按钮默认disabled状态（title="请先完成必要配置"）

- 通过规则选择广告

- 验证按钮变为enabled

- 点击执行，观察结果反馈

输出物

截图命名规范

{序号}_{场景}.png

示例：01_home.png、05_chat_fashion.png、07_miaozahao.png

报告结构

参见 [references/report-template.md](references/report-template.md) — 完整报告 Markdown 模板。

报告核心章节：

1. 功能全景（对话 + 妙招）
2. 对话功能体验（快捷指令 + 自由对话）
3. 妙招功能体验（配置面板 + 一键执行）
4. 信息架构与体验一致性
5. 优化建议（按P0/P1/P2分级）
6. 体验亮点

报告输出

• 本地Markdown文件：output/agent-test/体验报告_投放Agent_{date}.md
• 企微文档（通过 wecom_mcp 的 smartpage_create 上传）

关键选择器参考

注意事项

• Cookie约2小时过期，过期后自动跳转登录页
• 如截图中文显示为方块，先安装 google-noto-sans-cjk-sc-fonts
• Agent回复需要10-25秒，部分场景会卡在"分析中"状态
• 使用DOM文本提取（page.evaluate）比截图更可靠，确保内容被记录
• 首次进入Agent页面需等8秒完成SPA加载
• 每次发送对话后建议新开会话（避免上下文串扰测试结果）