智能AI客服

上新

智能知识库客服:上传文档生成专属聊天页,访客问答按次计费

智能知识库客服:上传文档(txt/md/docx/pdf),自动切片向量化;生成公开聊天页 URL,访客可像在线客服一样提问。
管理调用免费;访客每次提问扣 1 次(检索 + DeepSeek 生成)。

典型流程:create → upload → 分享 public_url → 访客在页面提问。

调用地址:https://api.ynlskj.com.cn/gateway/smartbot

请求方法:POST

在其他地方怎么调用

  1. 请求地址用上面的调用地址,把 JSON 放在请求体里
  2. 方法用 POST
  3. API Key 只能放在请求头 X-API-Key,不要写进网址,也不要写进 Query 框
  4. Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key

参数说明

参数位置必填说明
actionBody JSONcreate / list / update / delete / status / docs / upload / doc_delete / ask;以及 db_add / db_update / db_delete / db_list / db_test / db_tables / db_columns / db_preview / db_sync
name / welcomeBody JSONcreate 时客服名称、欢迎语
system_promptBody JSON回答风格与约束(默认:只根据知识片段回答)
bot_idBody JSON管理时Bot ID,格式 sb_xxx
content / file_base64Body JSONupload 时纯文本或 Base64 文件;也可 multipart 字段 file
filename / titleBody JSON文件名与文档标题;支持 txt/md/csv/docx/pdf,≤2MB
questionBody JSONask 时用户问题,最长 1000 字;可选 history 多轮(最多 6 条)
host / port / db_name / username / passwordBody JSONdb_add 时公网 MySQL 连接;禁止内网/本机
table_name / columnsBody JSON同步前表名与白名单列数组;仅生成 SELECT
filtersBody JSON等值过滤对象,如 {"status":"1"},禁止自由 WHERE
source_idBody JSONdb_* 管理时数据源 ID,格式 sdb_xxx
sync_every_hoursBody JSON定时同步间隔小时,0 仅手动,最大 168
X-API-KeyHeader你的 API Key

这个接口是干什么的?

上传产品说明、FAQ,并可同时连接业务 MySQL。公开页 /bot/{code}:数据统计类问题走库直查,业务说明类走文档知识库;一侧答不上会自动尝试另一侧。

计费说明

  • 管理操作免费:create / list / update / delete / status / docs / upload / doc_delete / db_* 不扣次
  • 提问扣 1 次:API action=ask 与公开页访客提问,均扣 Bot 所属账号的 smartbot 套餐
  • 公开页无需访客 API Key;额度不足时返回错误提示

典型流程

步骤Body 示例
1. 创建{"action":"create","name":"产品客服","welcome":"你好,有问题直接问我"}
2. 上传文本(可选){"action":"upload","bot_id":"sb_xxx","title":"退货政策","content":"七天无理由……"}
3. 添加 MySQL 源{"action":"db_add","bot_id":"sb_xxx","host":"db.example.com","db_name":"shop","username":"ro","password":"***"}
4. 试问(直连查库){"action":"ask","bot_id":"sb_xxx","question":"有几个商户"}
5. 分享返回的 public_url,如 https://api.ynlskj.com.cn/bot/sbxxxxxxxxxxxx

说明与限制

  • 每账号最多 20 个 Bot;每 Bot 最多 50 份文档;单文件 ≤ 2MB
  • 支持 txt / md / csv / docx / pdf(文本抽取);自动切片约 450 字
  • MySQL 直连问答:仅公网;模型根据表结构生成 SELECT/WITH,服务端强制只读与 LIMIT;每 Bot ≤ 3 源
  • 可选 db_sync 把表数据同步进知识库作兜底;定时同步依赖队列 cron
  • 文档向量可走火山 doubao-embedding-vision(config 中 SMARTBOT_EMBEDDING_*
  • 也可在「个人中心 → 智能客服 / 知识库」可视化管理

返回说明

字段说明
retok 成功,err 失败
data.bot_id / codeBot ID 与公开短码
data.public_url公开聊天页,如 /bot/sbxxxxxxxxxxxx
data.doc_count / chunk_count / ask_count文档数、切片数、提问次数
data.answerask 时模型回答
data.sources命中的知识片段摘要(可在 Bot 设置关闭)
data.bots / data.docslist / docs 时的列表
data.source_id / data.sourcesdb_add / db_list 时的数据源
data.row_count / data.doc_iddb_sync 同步行数与生成的知识文档 ID
data.tables / data.columns / data.samplesdb_tables / db_columns / db_preview
msg本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」
remain_quota本次调用后的剩余次数

可直接复制的代码

未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。

<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/smartbot');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{
    "action": "create",
    "name": "产品客服",
    "welcome": "你好,我是产品智能客服,有问题直接问我。"
}',
]);
echo curl_exec($ch);

请求参数演示

{"action":"create","name":"产品客服","welcome":"你好,我是产品智能客服,有问题直接问我。"}

响应演示

{"ret":"ok","data":{"action":"create","bot_id":"sb_xxxxxxxx","code":"sbxxxxxxxxxxxx","name":"产品客服","public_url":"https://api.ynlskj.com.cn/bot/sbxxxxxxxxxxxx","status":"active"}}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录