智能AI运营辅助

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

智能知识库客服:上传文档(txt/md/docx/pdf),自动切片向量化;生成公开聊天页 URL,访客可像在线客服一样提问。
管理调用免费;提问和「猜你想问」按大模型实际 token(输入 + 输出加权)扣额度,套餐价已含加价。FAQ / 本地日期推算不走模型则不扣。

典型流程: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

参数说明

参数位置必填说明
action Body JSON 是 create/list/update/delete/status/docs/upload/doc_delete/ask/suggest;以及 db_add/update/delete/list/test/tables/columns/preview/sync
name / welcome Body JSON create 时 客服名称、欢迎语
system_prompt Body JSON 否 回答风格与约束
bot_id Body JSON 管理时 Bot ID,格式 sb_xxx
content / file_base64 Body JSON upload 时 纯文本或 Base64 文件;也可 multipart 字段 file
filename / title Body JSON 否 文件名与文档标题;支持 txt/md/csv/docx/pdf,≤2MB
question Body JSON ask / suggest 时 用户问题,最长 1000 字
host / port / db_name / username / password Body JSON db_add 时 公网 MySQL 连接;禁止内网/本机
table_name / columns Body JSON 同步前 表名与白名单列数组;仅生成 SELECT
filters Body JSON 否 等值过滤对象,如 {"status":"1"}
source_id Body JSON db_* 管理时 数据源 ID,格式 sdb_xxx
sync_every_hours Body JSON 否 定时同步间隔小时,0 仅手动,最大 168
X-API-Key Header 是 你的 API Key(请求头,不要放进网址或 Query)

这个接口是干什么的?

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

计费说明

  • 管理操作免费:create / list / update / delete / status / docs / upload / doc_delete / db_* 不扣额度
  • 按 token 扣额度:action=ask / 公开页提问,以及 action=suggest /「猜你想问」,按本轮大模型实际用量计费
  • 怎么算:输入 token + 输出 token ×(输出官方价/输入官方价),走了模型时单次至少扣 500 token;套餐售价已含加价,客户侧只看剩余 token
  • 不扣的情况:命中 FAQ 或本地日期/节日推算(不调用模型)不扣;创建、上传、改配置免费
  • 公开页无需访客 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"}}

在线调试

登录后可在线调试。调试会按实际 token 扣额度。

去登录