腾讯营销妙问

SKILL.md 节选

# 妙问 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 模式执行（主模式）

```bash
node scripts/chat.js '<JSON请求体>'
```

> JSON 用**单引号**包裹避免 shell 转义。

**请求体**（普通提问，绝大多数场景）：

```json
{"query": "<用自然语言描述问题或诉求，尽量含账户ID/广告ID/时间范围/行业/版位/拒审原因等关键信息>"}
```

**带附件预审**（用户需预审本地图片/素材时）：先上传获取 URL，再发起预审。

```bash
node scripts/upload.js "<本地文件路径>"   # 从返回 JSON 的 data.file_url 取远程 URL
```

```json
{
    "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 指引更新后重试 |

**正确做法**：

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 10 个文件，合计 190.7 KiB