Help 使用说明

接入、值班、知识库怎么用。

脚本、样式、密钥都在登录后按站点取。公开页面不放可复制片段。访客站点自己的公开文章仍走 /help/?site=YOUR_SITE,与本页产品说明分开。

01

从哪里开始

运营后台管站点与知识,系统设置管密钥与成员,值班台管接待。不要混用入口。

STEP 01 登录运营后台

/admin/ 建站点、写知识、看访问分析、复制接入代码。

STEP 02 系统设置

/system/ 对话模型、成员、通道密钥、值班默认、开放 API。密钥仅超管可见。

STEP 03 值班入口

/duty/ 选电脑或手机。坐席账号不能进管理后台取脚本。

热线 400-656-3113。条款见 服务条款。

02

网站 / 微信 / 小程序 / App

公开页面不展示可复制脚本。每个站点的片段按已登记域名生成,必须登录后从后台复制。

渠道怎么接
网站把 widget.js 插到已登记 Hosts 页面的 </body> 前。接入代码「网站」默认给命令队列;data-site 仍是简写
接入插件网站 aics() / identify;App 官方壳、WordPress、npm。说明见 接入插件
公众号全屏 H5 /chat.html?site=YOUR_SITE&channel=mp,或在渠道对接填密钥走原生消息
小程序业务域名填 kebao.qianqianai.com,web-view 打开接入代码里的地址
App 访客系统 WebView 打开 /chat.html?site=YOUR_SITE&channel=app,官方壳见仓库 plugins/,不要嵌坐席工作台
站点帮助中心访客文章地址 /help/?site=YOUR_SITE,内容来自该站已发布知识

形态如下(把站点 ID 换成后台里的标识):

HTML
<script src="https://kebao.qianqianai.com/widget.js" data-site="YOUR_SITE" async></script>

登录用户请在首条消息前 identify,只传用户 id 和显示名。不要把开放 API 密钥写进网页。功能介绍见 接入插件。

网站四种样子:圆形气泡、底部咨询条、侧边标签、卡片入口。颜色和左右位置在同一弹窗里选,保存后下次打开生效。

企业微信、微信客服、拼多多、快手:在运营「渠道对接」绑定密钥与回调。买家仍在原对话框收消息。完整名单见 对接平台。

抖音私信暂不支持接入客宝 AI 客服。查看抖音官方公告。

03

挂件不显示 / 发不了

浏览器会带 Origin。必须是该站 Hosts 里的域名,含子域。

现象先核对
气泡不出现页面里没有 widget.js,或 CSP / 广告拦截挡了脚本;站点未启用
能看见气泡,一发就失败当前域名没写进该站 Hosts。登记 example.com 可覆盖 www.example.com
贴到了 localhost本地调试也要把 localhost 或 127.0.0.1 写进 Hosts,否则没有 CORS 头
答了另一套知识data-site 贴错了站点 ID
样式不对在接入代码弹窗改,不要改 widget.js 本身

本站 /chat.html 按 site 标识放行,不靠 Origin。

04

知识库

每个接入站点一套独立知识,互不检索。应答顺序固定:FAQ 精确匹配 → 向量检索 → 站点大模型。

  • 能放进去:Word、PDF、Markdown、纯文本;也可以粘贴正文或抓取网页。
  • 待审 FAQ 审核通过后才对外。检索只读已发布条目。
  • 文档勾选「公开到帮助中心」后,出现在该站 /help/?site=YOUR_SITE。未公开文档仍可被内部检索。
  • 改了知识仍答旧内容:先确认已发布,再点「重建向量」。表述接近标题走 FAQ,表述很散才走向量。

欢迎语和快捷问题挂在知识集合上。功能细节见 知识库、AI 应答。

05

人工值班

电脑、手机、App 用同一套坐席账号,入口不同。答不了再排队转人工;下班走留言。

入口地址用途
入口一览/duty/选电脑还是手机
电脑值班台/desk/完整接待:转接、备注、质检、关单
手机网页/agent/轻量接单与回复
Android 坐席 App包名 com.qianqianai.aics.agent锁屏推送、转接、内部备注。说明见 Android 坐席
客服中心/center/客户档案、商机、通知短信与智能回拨
运营大屏/screen/值班室电视:访问、接待、排队与坐席在岗

坐席账号不能进管理后台改知识或取接入脚本。

06

通知短信

只发云厂商已审模板,做客服通知,不是营销群发。开放 API / MCP 不包含发短信。

  1. 在云厂商审核通过短信模板(腾讯云或阿里云)。
  2. 到 客服中心 · 短信模板 登记或从云同步。密钥在 通道配置 · 短信。
  3. 到 发送 按分组、标签、来源圈选,或点选指定客户。
  4. 预览人数和变量样例后再发。遵守间隔、日上限、勿扰和黑名单。

功能页:通知短信、客户邮件。

06b

客户邮件

本地模板 + 队列投递,做客服通知,不是默认同站群发。通道可选腾讯云邮件推送 SES 或自建邮箱 SMTP。开放 API / MCP 不包含发邮件。

  1. 在 通道配置 · 邮件 选择邮件通道:腾讯云 SES(发件人 + 腾讯云密钥)或自建邮箱(SMTP 主机与授权码)。
  2. 到 客户管理 · 邮件模板 写主题和正文,或一键创建 5 套带图 HTML5 风格。用 {name} 插入客户字段;点击跳转默认是项目主页,可改。
  3. 到 发送 按分组、标签、来源圈选,或点选指定客户。必须预览人数后再发。
  4. 遵守间隔、日上限、勿扰、退订和黑名单。每封信带退订链接。

07

智能回拨

对值班台离线留言做任务制 AI 回拨。接通走同一套知识库;说转人工就回值班台。不是预测式外呼。

  1. 在 通道配置 · 智能回拨 打开语音并填写腾讯云联络中心密钥。默认关闭。
  2. 到 客户 · 待回拨留言 单条立即回拨,或把当前列表建成 回访任务。
  3. 回拨窗口按当地时间设置,窗外不打。黑名单号码会跳过。
  4. 通话记录可看转写与摘要,结果写回工单和客户跟进。

不从导入名单群呼,没有 IVR 热线。功能页:智能回拨。

07b

其它功能

应答策略、沙箱、话术、缺口、访问控制、多语言和备份,介绍页与后台入口如下。客户管理是产品特色,不放在功能介绍里重复讲。

功能后台入口介绍页
客户管理/center/客户管理
应答策略运营后台 · 应答策略应答策略
应答沙箱运营后台 · 应答沙箱应答沙箱
话术库运营后台 · 话术库;值班台 /desk/#canned话术库
知识缺口运营后台 · 知识缺口知识缺口
访问控制运营后台 · 访问控制访问控制
多语言回复挂件 data-locale;集合英文欢迎语多语言回复
运营大屏/screen/运营大屏
备份迁移系统设置 · 备份与迁移(超管)备份迁移

总览:功能介绍。

08

角色与后台

运营后台 /admin/系统设置 /system/
知识、接入代码、访问分析是否
运营大屏是(/screen/)否
对话模型、检索阈值、限流否是
成员、值班默认、健康巡检否是
开放应用密钥否是
  • 普通用户:自助注册后的站点主人,看本站用量、账单和挂件,不占客服席位。
  • 客服:只走值班入口,接待访客,占用席位。不进经营和系统设置。
  • 项目管理员:只看被分配站点;不能新建/删除接入点;不能看模型密钥;不占席位。
  • 超级管理员:全部站点;可新建/删除接入点;可见模型密钥。
  • 销售、技术:只在黔前智算内部站点使用。客户租户不能开通这两个角色。

09

开放调用

REST 和 MCP 是两套独立说明页,不要把管理后台 Cookie 或 /api/admin 开放给三方。密钥在系统设置 → 开放应用签发,明文只显示一次。站点须打开「开放 API / MCP」渠道。

REST 开放 API

给人写的后端。基址 /api/open/v1/。问答、知识库、工单、客户、售后、Webhook。

打开开放 API →

MCP MCP 接入

给 CodeNeo 代码编排工具。协议 2025-03-26,地址 POST /mcp/。本机配置不要提交 Git。

打开 MCP 接入 →

KEY 签发密钥

runtime 问答、ops 同步、agent 给 Agent。格式 aics_live_….secret。

去签发 →

10

套餐与计费

三档套餐:基础版、专业版、企业版。首月免费并可试用专业版功能。席位、站点、Token 加油包和短信、邮件、语音用量包按需加购。价格以套餐页为准。

项目内容
档位基础版(100 元/月、999 元/年):AI 应答、基础知识库、网页挂件与公众号、人工值班、基础客户管理。专业版(299 元/月、2990 元/年):全部渠道、高级知识库、多应答 Agent 与 Copilot、质检、自动化、商机营销、产品订单项目、高级分析与导出、开放 API。企业版(1000 元/月、10000 元/年):专业版全部 + 数据范围与访问复核、审计链与凭据保险箱、区域门禁、渠道治理。
谁能购买企业所有者与企业管理员(权限 billing.write)。客服、客户经理、只读成员只能查看账单;需要升级时提示联系管理员。
席位只算能接待客户的客服账号;所有者与管理员不占席位。基础版含 1 个、专业版 3 个、企业版 10 个,每加 1 个每月 100 元。同一企业多个站点共用席位,一个人在多个站点接待只占 1 席。
站点基础版 1 个、专业版 2 个、企业版不限;加站点每个每月 50 元。企业管理员在「接入站点」自建,新站点与主站点共用套餐、额度和席位。
Token按大模型实际消耗(输入 + 输出)计,FAQ 精确命中不消耗。套餐额度按自然月计算、不结转;用完先扣 Token 加油包(100 万 50 元,12 个月有效,不随月清零),都用完 AI 改为常见问题回答,对话不断。
短信 / 邮件 / 语音按条、按封、按分钟计。专业版每月赠送短信 500 条、邮件 5000 封、语音 100 分钟;企业版 2000 条、2 万封、500 分钟;基础版只含邮件 500 封。试用期短信 20 条、邮件 200 封、语音 10 分钟。赠送量用完扣用量包;发送失败、未接通自动退回。登录验证码短信由平台承担,不计入。
开放 API / MCP / Webhook专业版每月 1 万次,企业版每月 10 万次,基础版不含。按站点所属企业合计。
升级 / 续费 / 降级有效期内升档按当前套餐剩余天数抵扣差价,新档位从付款当天起算;同档续费从到期日顺延;降档要等当前套餐到期后购买。
到期后AI 改为常见问题回答,高级功能转为只读,席位回到 1 个;历史对话与知识库保留,账号仍可登录看账单和续费。到期前 7、3、1 天通知企业所有者。
退款套餐付款 7 天内且未使用加油包、用量包可全额退;加油包、用量包未使用可退;加席位、加站点 7 天内可退;升档抵扣后按实付退。请联系客服办理。
发票已支付订单在「余额与充值 → 订单」申请电子发票,抬头与税号以企业认证信息为准,金额为实付金额。