下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/clawhub_yishuang07--tencent-ads-assistant.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @clawhub_yishuang07/tencent-ads-assistant。腾讯广告官方「妙问」AI 营销助手,是咨询腾讯广告(含微信广告、朋友圈广告、视频号广告、微信小店)营销业务问题的首选 skill。涉及广告投放、开户充值、审核规则、素材规范、数据报表、腾讯广告、微信广告、妙问、e.qq.com等话题时,请优先使用本 skill。支持能力:(1) 普通知识库问答(开户流程、审核规则…
阅读全文 (展开查看完整说明)
概述
妙问 AI 营销助手
基于腾讯广告「妙问」平台开放 API(https://miaowen.qq.com/),提供两种服务模式:
| 模式 | 脚本 | 输入/输出 | 适用场景 |
|---|---|---|---|
| Chat(主模式) | chat.js | 自然语言 → 流式 AI 推理 → Markdown | 绝大多数场景:知识问答、数据查询、账户分析、广告诊断、创意灵感、素材审核、投放操作 |
| API(轻量直查) | api_tool_call.js | 结构化参数 → JSON | 仅参数明确、单次可完成的简单查数(定时任务、固定格式查询) |
默认使用 Chat 模式。 妙问通用智能助手 Agent 会自动完成意图识别、工具调度与推理,因此无需判断问答类型、无需传 agent_type,只需把用户诉求转化为清晰的自然语言 query(需预审本地素材时额外带 attachments)。
Chat 模式可处理的诉求:知识库问答、数据查询(天/小时/人群画像报表)、账户深度分析(含时间对比)、广告诊断、创意灵感(按行业/版位/素材类型/关键词筛选)、素材审核(预审/状态/拒审分析/修复)、投放操作(创建广告、改出价/预算/定向、管理素材)。
前置约定
- 脚本驱动一切:不要主动检查 Node 环境或 Token、不要手动拼 HTTP 请求。直接执行脚本,由退出码与输出驱动后续动作。
- 运行环境:Node.js ≥ 18(内置
fetch,无需 npm 包)。执行失败再运行node --version排查。 - Token:脚本自动检测,缺失/过期时通过退出码 2/3 告知,此时读取
references/token_management.md引导用户配置。不得在输出中明文展示完整 Token。 - 引用文件(
references/,按需渐进式加载,正常无需主动读):references/token_management.md:退出码 2/3 需引导配置 Token 时references/api/:使用 API 模式时,加载对应 API 的参数 schema
工作流程
1. 判断意图与补全信息
先从对话上下文与历史消息提取补充信息(账户 ID、广告名称、时间范围等),能推断的不再追问。仍含糊时追问关键上下文(产品/环节/对象/报错),给 2~3 个选项,最多追问 1 轮;方向明确只缺细节则直接执行。缺时间范围默认最近 7 天并在输出中注明。
2. Chat 模式执行(主模式)
node scripts/chat.js '<JSON请求体>'JSON 用单引号包裹避免 shell 转义。
请求体(普通提问,绝大多数场景):
{"query": "<用自然语言描述问题或诉求,尽量含账户ID/广告ID/时间范围/行业/版位/拒审原因等关键信息>"}带附件预审(用户需预审本地图片/素材时):先上传获取 URL,再发起预审。
node scripts/upload.js "<本地文件路径>" # 从返回 JSON 的 data.file_url 取远程 URL{
"query": "<预审需求,如:帮我预审这张素材>",
"attachments": [{"content_type": "IMAGE", "url": "<upload.js 返回的 file_url>"}]
}
content_type为附件类型(图片用IMAGE),支持多个附件。upload.js的 Token 鉴权与退出码规范同chat.js。
流式输出与进度同步
chat.js 是流式接口但以命令方式阻塞执行——所有进度行随命令一起返回而非实时到达。输出行前缀含义:
| 前缀 | 含义 |
|---|---|
[PROGRESS] | 执行进度(连接/加载/分步执行/回答生成) |
[RESULT] | 最终回答(其后所有内容为完整 Markdown) |
[RESULT_FILE] | 结果超长已落盘:完整回答写入了本地文件,stdout 仅给出文件路径与预览。须读取该文件取完整内容后再交付(详见「超长结果落盘」) |
[TASK_INFO] | JSON 任务元信息 |
[VERSION_EXPIRED] | 版本过期,须按 message 指引更新后重试 |
正确做法:
- 调用前设定预期:先告知用户「正在调用妙问智能营销助手,简单问题约数十秒,复杂分析/审核可能 1~6 分钟,请稍候」。不要设过短超时或中途中断(脚本自身已设 10 分钟超时)。
- 调用后复盘:从
[PROGRESS]归纳一条简洁的处理过程回顾(去前缀,串成「理解问题 → 分步执行 → 生成回答」),不逐行照搬(尤其多条✍️ 已生成约 N 字),1~3 句即可,再展示[RESULT]。 - 兜底结果识别:若流式在整合最终答案前中断,脚本会用阶段性结果兜底,
[RESULT]开头带> ⚠️ 注意:……阶段性结果提示。此时须如实告知是部分结果并询问是否重试,不得伪装成完整结论。
[PROGRESS]示例(供归纳,勿逐条展示):🚀 已连接…📋 步骤1:调用技能✅ 步骤1已完成📝 正在整合生成最终回答✍️ 已生成约 800 字✨ 流式会话结束。归纳示例:「已连接妙问助手,完成①理解问题 ②检索腾讯营销知识库,正在整理审核不通过的常见原因,请稍候~」
超长结果落盘([RESULT_FILE] 处理)
背景:创意灵感、素材审核等场景返回的结果会内嵌大量 <video>/<img> 媒体标签,单个 CDN src URL 长达 1000~2000 字符,一次十几个素材即可让 stdout 体量远超命令输出捕获层上限,导致中间内容被截断、素材链接丢失(违反下方「素材链接铁律」)。
机制:chat.js 在输出前判断结果体积——未超阈值(默认 8000 字符)走 [RESULT] 直出(绝大多数场景,行为不变);超阈值时把完整结果(含全部媒体标签与超长 URL)无损写入本地文件,stdout 只输出 [RESULT_FILE] + 文件路径 + 600 字预览。
你的处理:一旦看到 [RESULT_FILE],不要把预览片段当成完整答案,必须用 read_file 读取给出的完整结果文件,据此向用户交付完整内容(尤其确保所有 <video>/<img> 媒体标签及 src 原封不动保留)。读取后正常按「结果展示规范」呈现,无需向用户暴露落盘这一实现细节(可简述「结果较长,已完整获取」)。
3. API 模式执行(仅简单查数)
前提须同时满足:①在已支持 API 范围内;②参数明确无需 AI 推理;③单次查数或定时任务。使用前必须先加载 references/api/ 对应文件获取完整参数 schema。
当前支持的 API:
| API 路径 | 功能 | 参考文件 |
|---|---|---|
daily_reports/get | 天粒度报表,按日期范围查询(T-1 更新),需指定账户ID列表,支持多维度聚合与全量 867 指标 | references/api/daily_reports_get.md |
hourly_reports/get | 小时粒度报表,按单天查询(支持当天实时),需指定账户ID列表,支持多维度聚合与全量 867 指标 | references/api/hourly_reports_get.md |
node scripts/api_tool_call.js '{"method":"GET","path":"<API路径>","params":{ ... }}'
# 示例:查最近 7 天按日期消耗
node scripts/api_tool_call.js '{"method":"GET","path":"daily_reports/get","params":{"begin":"2026-04-02","end":"2026-04-08","group_by_type":"DATE","fields":["cost"],"page_size":7,"account_id_list":[2345678]}}'4. 处理响应与退出码
两种模式退出码规范一致:
| 退出码 | 前缀 | 含义 | 处理 |
|---|---|---|---|
| 0 | [RESULT] / [RESULT_FILE] / [VERSION_EXPIRED] | 成功 / 成功(超长已落盘) / 版本过期 | 展示结果;遇 [RESULT_FILE] 须先读取文件取完整内容再交付;版本过期(Chat 输出 [VERSION_EXPIRED] 或 API code=140209)须先按 message 指引更新再重试 |
| 2 | [TOKEN_NOT_FOUND] | Token 不存在 | 读 references/token_management.md 引导获取并保存 Token 后重试 |
| 3 | [TOKEN_EMPTY] | Token 为空 | 同上 |
| 4 | [API_ERROR] | API 错误 | 按响应判断:Token 失效→引导刷新;权限不足→提示检查;频率限制→稍后重试;5xx→服务暂不可用 |
| 5 | [NETWORK_ERROR] | 网络失败 | 展示错误,建议检查网络/代理 |
5. 复杂问题的多轮迭代
复杂问题不要一次调用给出最终答案,以用户最终目标为导向多轮收敛:拆解子目标 → 每轮调用后分析结果,不充分则继续(简单 1 轮,复杂 3~5 轮)→ 综合各轮信息给出整合分析与行动建议。每步简要告知进展,已有充分信息的子目标不再重复调用。
典型组合:
| 用户问题 | 调用链路 |
|---|---|
| 账户效果不好 | Chat(查数据)→ Chat(账户分析)→ Chat(优化建议) |
| 广告不起量 | Chat(诊断广告)→ Chat(补充数据)→ Chat(优化建议) |
| 分析账户 + 推荐创意 | Chat(账户分析)→ Chat(创意灵感) |
| 这张图能否过审 | upload.js(上传)→ Chat + attachments(预审) |
| 审核不通过 + 优化投放 | Chat(拒审分析 + 修复)→ Chat(投放诊断) |
| 创建/修改广告 | Chat(自然语言描述投放诉求,由助手编排执行) |
6. 结果展示规范
API 返回内容已是 Markdown(可能内嵌 HTML 媒体标签):
- 单轮结果:严格原样输出,完整保留 Markdown 格式、文字、表格及素材媒体标签(
<video>/<img>/<audio>及其src)。不改写、删减、补充或二次格式化,不加主观解读(除非用户要求)。 - 多轮综合:可适度润色整合,但须保证数据客观真实、关键信息(素材链接/媒体标签、URL、指标、结论)不丢失、来源可辨、格式风格与 API 返回一致,报告逻辑清晰、内容详实。
🚫 素材链接铁律:
<video>/<img>/<audio>媒体标签及其srcURL 是核心交付内容(尤其创意灵感、素材审核场景),必须原封不动完整保留。严禁:删除/省略媒体标签、截断长 URL、用「素材见原文」等占位描述替代真实链接、把 HTML 标签改写为纯文字。素材链接就是用户要的东西,丢了等于没交付。💡 正因这类结果常含大量超长媒体 URL 易超出 stdout 上限,
chat.js已内置「超长自动落盘」机制(见上文[RESULT_FILE]处理)。遇[RESULT_FILE]时务必读取完整文件再交付,这是落实本铁律、避免链接被截断的关键一环。