投放Agent自动化体验测试
通过 Playwright 浏览器自动化 + Cookie注入 对 ad.qq.com 投放Agent功能进行完整UX测试。
前置条件
- 中文字体：服务器需安装中文字体（否则截图中文为方块）
- Cookie：需要用户提供有效的 adhome 免登录 Cookie
- Playwright：需要 Node.js + playwright 已安装
安装中文字体
yum install -y google-noto-sans-cjk-sc-fonts
检查Playwright
npx playwright --version
Cookie 获取流程
引导用户操作：
- 打开 adhome 免登录页面，选择目标账户
- 点击免登录进入 ad.qq.com/atlas/{account_id}/agent
- 在浏览器 F12 控制台执行
document.cookie - 将结果发给 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 — 解析用户提供的 cookie 字符串并注入到 Playwright context。
测试流程
第一阶段：环境验证
- 注入Cookie
- 访问
https://ad.qq.com/atlas/{account_id}/agent - 等待8秒页面加载
- 验证是否进入Agent页面（非登录页）— 检查页面是否包含"对话"/"妙招"等文字
第二阶段：对话功能测试
2.1 首页快捷指令
遍历首页展示的快捷指令卡片（通常4个），依次：
- 点击指令
- 等待3秒
- 截图记录模板展示
- 提取输入框中的模板文案（含slot类型）
- 新开会话测试下一个
2.2 常用指令面板
- 点击底部"常用指令"按钮（
[title="常用指令"]） - 截图完整指令面板
- 提取所有指令分类和名称
2.3 模板Slot交互
- 点击快捷指令后，在模板中点击 asset slot
- 记录下拉列表内容
- 点击 select slot，记录选项
2.4 自由对话
测试覆盖投放全链路：
投放前：
- 预算规划："我有5000元预算，想推广一个教育类小程序，应该怎么设置投放计划？"
- 选品定向："我是做电商的，卖女装，适合选择什么投放版位和定向人群？"
投放中：
- 数据查询："帮我查一下今天的广告消耗和转化数据"
- 优化建议："我的广告点击率很低只有0.5%，有什么优化建议？"
- 调预算："帮我把所有在投的广告日预算统一调整到200元"
投放后：
- 复盘分析："帮我分析一下上周的投放效果，哪些广告ROI最高？"
- 批量关停："帮我把转化成本超过50元的广告全部暂停"
每轮对话：输入 → 等待25秒 → 截图 → 提取回复文本
第三阶段：妙招功能测试
- 切换到妙招页面（点击侧边栏"妙招"或首页"探索投放妙招"卡片）
- 逐一点击每个妙招卡片，截图配置面板
- 测试"一键执行"：
- 验证按钮默认disabled状态（
title="请先完成必要配置"） - 通过规则选择广告
- 验证按钮变为enabled
- 点击执行，观察结果反馈
- 验证按钮默认disabled状态（
输出物
截图命名规范
{序号}_{场景}.png
示例：01_home.png、05_chat_fashion.png、07_miaozahao.png
报告结构
参见 references/report-template.md — 完整报告 Markdown 模板。
报告核心章节：
- 功能全景（对话 + 妙招）
- 对话功能体验（快捷指令 + 自由对话）
- 妙招功能体验（配置面板 + 一键执行）
- 信息架构与体验一致性
- 优化建议（按P0/P1/P2分级）
- 体验亮点
报告输出
- 本地Markdown文件：
output/agent-test/体验报告_投放Agent_{date}.md - 企微文档（通过
wecom_mcp的smartpage_create上传）
关键选择器参考
| 元素 | 选择器 |
|---|---|
| 快捷指令卡片 | [class*="guideCard"] 或 text=模仿优质广告新建 |
| 常用指令按钮 | [title="常用指令"] 或 [class*="commandButton"] |
| 输入框 | [contenteditable="true"] |
| 发送按钮 | [class*="sendButton"] |
| 妙招侧边栏 | [class*="menuItem"] 含文字"妙招" |
| 一键执行按钮 | button 含文字"一键执行" |
| 广告选择规则 | [class*="ruleSelect"] 或含"规则"文字的tab |
注意事项
- Cookie约2小时过期，过期后自动跳转登录页
- 如截图中文显示为方块，先安装
google-noto-sans-cjk-sc-fonts - Agent回复需要10-25秒，部分场景会卡在"分析中"状态
- 使用DOM文本提取（
page.evaluate）比截图更可靠，确保内容被记录 - 首次进入Agent页面需等8秒完成SPA加载
- 每次发送对话后建议新开会话（避免上下文串扰测试结果）