磁力青松

要解决什么问题

投放同学在快手磁力引擎里查规则、对口径、核对政策时，往往要在文档、工单和内部 IM 里来回翻。这个技能把用户最新一条消息当作广告知识问答，通过 Ad Star Gateway 上的 Jarvis Skill HTTP API 调用后端 qingsong_ads_qa，只处理广告知识 Q&A，不负责开户、改计划等操作型意图。

技能如何工作

Agent 按 SKILL 约定组装 snake_case JSON（通常只带 query），用 Node.js 18+ 执行 scripts/chat.js 发起请求：

• 默认端点：POST https://ad.e.kuaishou.com/rest/dsp/jarvis/skill/chat
• 固定 req_type 为 KNOWLEDGE_CHAT；tenant_id 为数字，默认 1
• 请求头使用 Authorization: Bearer + app-key（可经 setup_token.js 或环境变量 ADS_QA_APP_KEY 等配置）

脚本退出码约定清晰：2/3 表示未配置或空 token，应引导用户提供 app-key；4/5 分别对应 API 与网络错误。成功时（退出码 0）应原样输出 stdout，不要改写、摘要或补写模型未返回的内容。

适用边界与注意点

• 仅支持广告知识问答；若返回内容表明意图不支持，在展示返回文案后提醒：当前还在开发中，很快会支持其他意图。
• 不要主动探测 Node 或凭证状态，先跑脚本再根据退出码处理；切勿向用户回显完整 app-key。
• 联调字段细节见 references/ads_qa_openapi_spec.md，日常问答流程不必展开。