客宝AI知识客服
工作台 值班台 客户经营 业务交付 经营中心 平台管理
独立平台后台
余额与充值 套餐与优惠 支付配置

平台总览

配置是否就绪、健康与运维入口

接入站点 运营
-
知识、接待与嵌入代码
今日词元
-
配置就绪 -
成员构成

超管可建项目管理员与座席。座席登录后进值班台,不会停在系统设置。

健康摘要
模型与通道
最近备份
快照距今
最近操作
时间动作操作者

模型列表

对话、向量、ASR、TTS、文生图可以来自不同厂商。先在「接入与密钥」保存厂商地址和密钥,再把模型绑到对应厂商。模型未单独填密钥时沿用该厂商的密钥,不会拿默认接入的密钥去调另一家。

用途 模型 ID 展示名 厂商 当前 状态
厂商列表

每家厂商单独保存地址和密钥。模型绑到厂商后,未单独填写的密钥沿用该厂商,不会串用其他厂商的 Token。带「默认接入」的厂商是未绑定模型时的全局兜底;环境变量只作用于这家。月之暗面、智谱、火山方舟等请点「添加厂商」。

厂商 API Base URL 密钥 模型
从厂商拉取到的模型

检索与开关

对话 / 向量模型在「模型列表」里切换。这里只管开关和检索阈值。

限流与会话

单价只用于用量页估算,不参与硬闸。站点日/月预算在接入站点编辑页。

座席转语音

值班台点「转语音」时,用这里的性别、音色和语速合成后发给访客。不是 AI 自动播报。TTS 模型在「模型列表」里设为当前。

当前 TTS 模型:-

略慢更接近真人客服。

0 为默认音量,一般不用调高。

试听和座席转语音走 MP3,硅基流动只支持这两种采样率。

MOSS 等对话合成模型主要靠音色和语速,这段指令不会读出来。

访客门禁作用于挂件、在线咨询与访问上报。后台门禁作用于网页登录与设备登录,两道闸分开配。紧急放行:环境变量 AICS_GEO_CONSOLE_BYPASS=1 或下方办公网 CIDR。渠道回调、开放 API 不受此限制。接待设置「按地区」只改欢迎弹窗文案。

-今日拦截 · 访客沟通工具
-今日拦截 · 后台登录

管理后台 / 设备登录

限制运营、系统设置与值班台登录的来源地区。出差前把办公网或自己的 IP 写入 CIDR,或设置紧急放行变量。

空=该范围内全部省
先选省。不选市=已选省内全部城市

你打开本页的网络

判定中…

访客沟通工具

新站默认跟随这份。命中限制时前端不显示在线咨询;单个站点可在运营「访客地区策略」覆盖。

空=该范围内全部省
先选省。不选市=已选省内全部城市

你打开本页的网络

判定中…

保存后下一请求生效,不用重载服务。

角色权限

内置三种角色:超级管理员(全站)、项目管理员(被分配的接入点)、客服座席(值班接单)。可改项目管与座席的权限,也可新增自定义角色。平台级能力(模型、系统、新建/删除接入点)始终仅超级管理员拥有。

把角色赋给具体的人,请到成员与权限。

角色类型权限成员
客服分组

用于访客侧在线座席目录,可增删改、调整顺序。未分组的座席不出现在目录,值班与转人工不受影响。一人可兼多组。

把成员放进分组,请到成员与权限。

显示名标识点名分类热线座席
成员

超级管理员可建项目管理员、座席与自定义角色。座席登录后进独立值班台(电脑 /desk/,手机 /agent/ 或 Android App)。转人工告警的手机号与办公账号请到「通知对象」填写。

显示名用户名角色分组站点状态

后台界面语言

所有值班台、运营、客户、系统设置、大屏和客户端都使用这里的语言。访客对话语言不受影响。仅超级管理员可改。

全局值班策略

写入全局配置。各接入点仍可在运营覆盖排队、SLA、对话自动关闭、售后工单超时与欢迎语。对话和售后工单超过设定小时未关闭会自动结束。

需先在「模型服务」添加并设为当前使用的 ASR 语音识别模型。未配置 ASR 时无法开启。已配置时默认开启。

转人工告警、群机器人、坐席手机号与 App 锁屏推送请到「通知与通道」。Android 走个推或极光,iOS 走极光或 APNs 直连。

挂件与转人工默认

站点未单独配置时使用。

新建站点的主动接待模板

只在创建新站且未单独填写时带出。默认关闭,不会让现网站点突然弹窗。已上线站点请到运营 接待设置 开关。

最近通知事件

销售页弹出的「跟进到期」会记在这里。有逾期或今日待跟进时写一条,同一天、同一条数不重复。点标题回到今日待办。

时间类型标题内容状态
正在读取…
通知会发到哪里

发给坐席和运维的告警集中在这里。发给客户的短信/邮件在 客户 · 通知短信;推给对方系统的业务事件在 开放 API · Webhook。

事件通道说明
转人工 / 留言 / 回呼 / 再排队锁屏推送 · 企微 · 短信 · 钉钉 · 飞书 · 群机器人App 请到左侧「移动推送」;IM/短信在本页开关
健康巡检 / 备份过期 / 渠道失败企微群机器人 Webhookcron 脚本与开放 Webhook 死信也走同一地址
值班台浏览器系统通知 + 提示音坐席打开值班台后浏览器授权即可,无需本页配置
跟进到期浏览器通知 · 站内通知事件销售页核对到逾期或今日待跟进后提醒,并写入上面的事件列表

作用范围

未单独覆盖的接入点沿用全局默认。

群机器人 / 运维 Webhook

企微群机器人。转人工、健康巡检、开放 Webhook 死信都会打到这里。须 https://。

转人工坐席通知

默认关闭。企微走运营「渠道对接」里的企微应用。钉钉 / 飞书可填群机器人(整组收一条);要发到个人,请到「通知对象」填 UserId / open_id,并在渠道对接保存应用密钥(钉钉还需 AgentId)。短信只发客户已审的通知模板,不会发给访客。

坐席通知对象

转人工告警只发给这里填了通道的成员,不会用访客手机号。账号本身请到「成员」管理。

显示名用户名角色手机企微钉钉飞书已接通
总体状态
-
引擎正常
-
警告
-
引擎异常/降级
-
核心引擎与组件

只做本地探测,不调用 LLM。总状态取最差一项。

目录权限

后台进程必须能写入这些目录,否则知识同步、日志、备份或保存配置会失败。探测会写一个临时文件并立刻删掉。

用途路径状态
最近备份
目录距今
最近异常

脱敏后的结构化错误(log/errors.jsonl),不含客户消息与密钥。

时间级别位置摘要
同步状态
-
最近运行
-
最近替换
-
冲突文件
-
主端代码 → 辅端

每 5 分钟检查一次主端安全代码目录;辅站专属配置、数据和资源会保留。

最近文件结果
文件结果
尚未运行

回滚备份:每次实际替换前都会在辅站创建回滚备份。

最近备份
-
可用快照
-
快照空间
-
迁移包
未上传
服务器快照

快照包含业务库、成员、配置和服务器密钥,保存在服务器私有目录。立即备份在后台执行,可以离开本页,完成后回到列表查看。下载时默认排除成员账号与密钥;两类数据需显式勾选并再次验证身份。不需要的快照可删除以释放磁盘。

创建时间编号大小状态

导入迁移包

支持由本页下载的 ZIP 包。浏览器按 1MB 分片上传,服务端会校验 SHA-256、ZIP 路径、解压体积、SQLite 与配置文件;校验阶段不会改动现网。

尚未选择文件

校验结果

-

执行前会自动创建当前服务器的完整安全快照;切换期间 API 短暂进入维护状态,失败会自动尝试回滚。

时间操作者动作站点对象说明

项目管理员只能看到自己站点的知识库与关单;成员、模型与备份变更仅超管可见。

时间姓名公司电话邮箱咨询业务使用场景状态

官网「联系销售」提交的线索。状态可标记。

软件打包资料

怎么用

  1. 选平台和渠道。内部试用选 internal;上架再选对应商店。
  2. 核对包名。已从源码带入,可直接改,一般不用动。
  3. 个推 / 极光不要在这里填。到「移动推送」配好,保存资料时自动写入安装包。
  4. 签名只填引用。secret:// 或 keychain://,不要上传证书文件或密码。
  5. 先保存资料,再生成快照。Android 保存后可在打包目录执行 pack.sh。

相关配置,请到对应页面处理

个推 AppID到「移动推送」填写。保存打包资料时自动写入 APK,这里不用再填。 极光 AppKey到「移动推送」填写。打包时自动带入,不要复制到本页。 APNs 直连坐席 iOS 若不用极光、直接走苹果推送,在这里配证书。 软件版本包打好后,到这里上传并发布给客户端检查更新。 渠道发布小米 / 华为 / App Store 等商店后台数字 ID 和提审资料在这里登记。

应用身份

默认从源码预填,可直接改。商店后台数字 ID 仍到「渠道发布」登记。

本页需要填的打包参数

保存后写入打包目录。网页不会编译。个推 / 极光见上方「移动推送」链接。

当前安装版本会自动绑定,无需填写。

正在读取当前安装版本…

签名与证书

只填引用,不上传私钥。macOS 到 Apple 后台取 Team ID 和 Developer ID;iOS 取 Distribution 证书。当前渠道不强制的项也可先填上。

平台 / 渠道版本完整性Profile hash生成时间
正在读取…

渠道发布控制面

正在读取渠道状态…

新建发布活动

先选打包 profile。小程序不用绑软件版本;其他平台的版本、family 和 build 必须与 profile 一致。预检会检查商店标题、完整说明、更新说明和两个 HTTPS 地址。

请先选择 profile

只列出与 profile 同一平台的渠道。门户交接和尚未开放的渠道需要手动勾选,正式提交仍然关闭。

活动 / 版本渠道进度资料与制品状态任务
正在读取…
Windows
尚未发布
macOS
尚未发布
iOS
尚未发布
Android
尚未发布
软件版本中心

正在读取清单签名配置…

平台 / family通道版本 / build发布策略制品与验证状态
正在读取…
更新成效

选择一条版本记录查看更新事件。

发布硬门禁

stable 必须同时具备 Ed25519 清单签名、服务器重算 SHA-256,以及对应平台的系统签名、公证或商店可见性验证。未通过时后端会拒绝发布。

internal 可发布 unsigned 包,但不能设置强制更新。暂停或撤回后,匿名检查 API 会立即停止返回该版本。

按周设置各站人工值班时段。保存后立即影响排队与离线留言判定。休息日的访客进入留言。

买家仍在抖音、快手、拼多多、微信里说话,消息进同一套 AI 先回 + 坐席跟进。密钥只存在本机。每个模块点「对接说明」看步骤;接入代码请到运营「接入站点」复制。公开目录:对接平台。

Android 锁屏走个推或极光;iOS 锁屏走极光(经苹果 APNs)或本页「APNs 直连」。极光的 Android 与 iOS 字段完全不同,请分开填写。转人工的企微 / 短信 / 钉钉 / 飞书在「事件与通道」。密钥只保存在服务器,页面不回显原文。

个推

仅 Android。AppID 在本页保存即可;「软件打包资料」保存时会自动写入安装包,不必再到打包页或 local.properties 抄一遍。去打包

-

应用凭证

AppKey / MasterSecret 对 Android 和 iOS 共用,在极光控制台「应用设置 → 应用信息」复制。「软件打包资料」保存时会自动带入 AppKey,不必再到打包页抄一遍。去打包

-

Android 通知

下发字段与个推、iOS 都不同:要用通知渠道、点击 Intent、以及国内厂商二次推送。应用包名须与极光控制台、APK 签名包名一致。

须与 App 里创建的 NotificationChannel 一致,否则锁屏无声或被系统拦截。

厂商通道的 AppID、AppKey、AppSecret 在极光控制台「Android 设置」填写,并在 App SDK 初始化。本页只决定下发时是否走二次推送,不保存厂商密钥。

iOS 通知

iOS 走苹果 APNs,没有 Android 的渠道 ID 和厂商通道。证书或 Auth Key 上传到极光控制台「iOS 配置」;本页只控制下发环境、角标和打断级别。坐席 App 若未集成极光 SDK、直接用系统 APNs,请改用「APNs 直连」。

生产 / 开发必须与极光控制台当前证书环境一致,否则 iOS 收不到。Time Sensitive 需 App 开通对应 entitlement。

APNs 直连

iOS 坐席 App 默认走这条,不经极光。在 Apple Developer 创建 APNs Auth Key(.p8),填 Team ID、Key ID、Bundle ID 和私钥。密钥不回显。

-

短信、邮件、智能回拨分开配置。密钥只保存在服务器,页面不回显原文。短信可同时登记两家云,发送按模板所选通道走;邮件按默认通道走腾讯云 SES 或自建邮箱。密钥仅超级管理员可改。

腾讯云短信

腾讯云密钥与邮件推送、智能回拨共用。已在其它选项卡填过可留空。

阿里云短信

发送限额

腾讯云邮件推送 SES

群发走腾讯云 邮件推送 SendEmail。发件人须已在控制台完成域名 / 发信地址验证。

与短信、回拨共用同一套腾讯云密钥。已在其它选项卡填过可留空。

自建邮箱服务器

走本机 SMTP(企业邮箱、Postfix、Exchange 等)。密钥不回显。发送页在 客户 · 邮件群发。

云联络中心

任务未选话术模板时使用。可用 {name} {site}。不超过 120 字。

与短信、邮件推送共用同一套腾讯云密钥。已在其它选项卡填过可留空。

回呼测试

向自己的手机发一通测试呼叫,确认 SdkAppId、密钥和外呼主叫已接通。不会写入客户档案。测试不受回拨窗口限制。

开放 API
调用说明 OpenAPI

给三方系统、自有后端、ERP 的 REST 调用面。基址 /api/open/v1/,鉴权 Authorization: Bearer。密钥明文只显示一次,库内只存哈希。

MCP 是另一套协议(JSON-RPC 工具调用),请到 页单独签发。不要把管理后台 Cookie 或 /api/admin 交给三方。

能力与范围勾选范围后,对应 REST 才可调用;未勾选返回 403 forbidden_scope
能力范围REST说明
探测任意有效密钥GET /meta · /openapi.json站点、渠道开关、能力列表。不含密钥。
问答chatPOST /chat · GET /chat/sessions/{id}与挂件同一条 FAQ → RAG → LLM。站点须开「开放 API」渠道。
知识检索kb.readGET /kb/search · /kb/collections已发布片段,不含草稿。
知识写入kb.write 敏感FAQ / 文档 / RAG / 入库立即参与线上答复。只签给受信后端。
建单 / 留言live.writePOST /tickets · …/messages排队或下班留言。写操作建议带 Idempotency-Key。
机器人回复agent.reply 敏感POST /tickets/{id}/reply对访客可见。
读会话ticket.readGET /tickets无内部备注、无坐席真名。
关单ticket.write 敏感POST /tickets/{id}/close
客户 / 商机crm.read / write / pii/contacts · /deals默认掩码手机。crm.pii 才返回完整号码。
售后工单work.read / write/work
Webhookhooks.write/webhooks业务事件推到对方 URL。MCP 无此能力,在本页配置。
分析 / 日志analytics.read · logs.read/analytics/overview · /logs/chats字段已裁剪,无 CSV 大导出。

本页不开放:模型密钥、成员与 TOTP、渠道 AppSecret、短信 / 邮件 / 回拨、MCP 工具调用。

站点渠道默认关。点各列状态开关。未开时问答与建单返回 403 channel_disabled
站点开放 APIMCP
REST 应用 类型:运行时(代访客问答)或业务同步(ERP / 电商)
名称类型站点范围密钥状态
应用

应用设置

类型在创建时选定,之后不可改。范围应尽量收窄;crm.pii 才能看到完整手机号。

至少选一个。多站密钥调用时必须带 site。

已勾选 crm.pii:接口会返回完整手机号。只签给受信后端,不要给浏览器或 MCP 默认打开。

填写后,不在名单内的来源会 403 forbidden_ip。Webhook 投递不受此限制。

密钥

密钥无法回显。旧密钥在吊销前仍然有效。测试密钥与生产密钥能力相同,仅前缀 aics_test_ / aics_live_ 不同,便于对方区分环境。

公钥 ID环境状态签发最近使用签名今日词元

Webhook

POST 到对方 HTTPS 地址,带 X-AICS-Signature: sha256=…。失败满 8 次进入死信,可手动重投。添加时签名密钥只显示一次。这是给对方系统的业务事件,不是坐席告警;坐席告警请到 通知。MCP 应用没有 Webhook。

URL事件状态

Webhook 投递

配置变更记 audit.jsonl,每次调用记开放调用日志。两套不要混用。

时间事件状态次数错误

近 100 次调用

时间方法路径状态预览
MCP
接入说明

给 Cursor / Claude / CodeNeo 等 Agent 的工具调用面。协议 MCP 2025-03-26,地址 POST /mcp/(也可用 /api/mcp)。tools/list 只出现当前范围里的工具。

REST 问答、Webhook、OpenAPI 请到 。不要把管理后台 Cookie 或 /api/admin 交给 Agent。

能力与范围默认只读。写工具带 destructiveHint,须在密钥上显式勾选对应范围
能力范围MCP 工具说明
探测任意有效密钥kebao_meta站点与渠道开关。握手:initialize → tools/list。
问答chatkebao_chat走与挂件同一条引擎。站点须开「MCP」渠道。
知识检索kb.readkebao_kb_search · kebao_kb_collections · kebao_kb_collection_get · kebao_kb_gaps只读已发布内容与知识缺口判定。
知识写入kb.write 敏感建集 / FAQ / 文档 / RAG / 入库 / kebao_kb_gap_promote / kebao_kb_gap_dismiss会写库,立即影响答复。写前先 kebao_kb_collections。噪声缺口不要晋升。
读会话ticket.readkebao_ticket_get · kebao_ticket_list默认最近 20 条,无内部备注。
建单live.writekebao_ticket_create排队或留言。
回复agent.reply / live.writekebao_ticket_replyas=bot 对访客可见。
关单ticket.write 敏感kebao_ticket_close
客户crm.read / write搜索 / 档案 / 商机 / 跟进手机默认掩码。完整号码要 crm.pii。
售后work.read / writekebao_work_list · kebao_work_update

本页不开放:Webhook 订阅、OpenAPI 契约、短信 / 邮件 / 回拨、模型密钥、SQL / 文件 / 渠道密钥。资源形如 kebao://site/{id}/meta。

站点渠道与开放 API 分开开关。点各列状态即可开或关。旧站点若只开过「开放 API / MCP」,MCP 会沿用该开关
站点MCP开放 API
MCP 应用 类型固定为 Agent。默认范围:问答、检索、读会话、读客户
名称站点范围密钥状态
MCP 审批
模式读取中

仅展示 MCP 写操作审批;参数预览已脱敏。批准或拒绝需要平台写权限。

申请时间应用 / 站点工具风险参数预览状态决定人
成员

转人工告警的手机号、企微 / 钉钉 / 飞书账号请到「通知对象」填写,不在成员账号里改。

仅用于访客侧在线座席目录。可同时勾选多组。不填则只走原来的转人工排队,不影响值班。分组在「客服分组」里管理。

至少选择一个接入点。

-

-

用验证器 App 扫描此二维码。无法扫码时,可手动输入下方密钥。

密钥:

otpauth 链接:

角色权限

勾选该角色可使用的功能。实际授权以后端校验为准。

字母开头,仅小写字母、数字、下划线和连字符。创建后不可改。

类型决定站点范围与默认权限模板,不能做成超级管理员。

未勾选的功能在菜单中隐藏,接口也会拒绝。模型、系统与开站始终仅超级管理员可用。

客服分组

用于链接 ?group=标识。字母开头,仅小写字母、数字、下划线和连字符。创建后不可改。

访客从目录点名该组座席时,带给值班台的技能分类。与站点技能组分流是两套。

新建开放 API

一次填完名称、类型、站点与范围。创建后密钥只显示一次。

显示在列表与审计里,对方系统里建议用同一名称便于对账。

类型决定默认范围,创建后不可改。仍可在本页勾选或取消具体权限。

MCP 应用类型固定为 Agent。默认只读:问答、检索、读会话与客户。写操作须显式勾选。

至少选一个。未打开对应渠道的站点,问答与建单会失败。

切换类型会重置为该类型的默认范围。不需要的请去掉;写操作、完整手机号务必显式勾选。

已勾选 crm.pii:接口会返回完整手机号,只签给受信后端。

测试与生产只是密钥前缀不同,都会打到同一套数据。对方联调请用 test,上线再签 live。

添加模型

同一用途只能有一个当前模型。密钥留空时使用该厂商已保存的密钥;只有不绑定厂商、或地址和默认接入是同一主机时,才沿用默认接入。

添加厂商

内置厂商已在列表中。这里添加的是目录里没有的 OpenAI 兼容接口。

坐席通知对象

登录验证需先填写手机号,并在通知与通道中配置短信密钥、SdkAppId 与验证码模板。已启用 TOTP 的账号会依次完成 TOTP 和短信验证。

新建软件版本

当前安装版本会自动绑定,无需填写。

正在读取当前安装版本…

版本创建后先上传制品并完成验证,再发布。stable 不接受 unsigned;internal 不允许强更。WPF 与 native-mac 当前只允许 internal/manual,Windows 与 macOS 正式通道统一使用 Electron。