投放Agent自动化体验测试#

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

前置条件#

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

安装中文字体#

bash

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

检查Playwright#

bash

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 — 解析用户提供的 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
   • 点击执行，观察结果反馈

输出物#

截图命名规范#

text

{序号}_{场景}.png

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

报告结构#

参见 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 上传）

关键选择器参考#

元素选择器快捷指令卡片[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加载
• 每次发送对话后建议新开会话（避免上下文串扰测试结果）