旧版扣子智能体外部调用,机器人ID和令牌到底在哪拿?
用旧版扣子知识库、扣子智能体,想让自己写的外部程序去调用它,手上必须有两个东西:
- 机器人 ID(BOT ID)
- 个人服务令牌(PAT)
参数没拿对,程序调一次报一次错,折腾半天还不知道问题出在哪。今天把这两个参数的获取方法讲清楚。
一、机器人 ID:别拿 Workflow ID 当机器人 ID
这是最多人踩的坑。
很多小伙伴建的是工作流、对话流,在浏览器地址栏里只看到一串 Workflow ID,就以为这就是机器人 ID——大错特错。
再说清楚一点:
- 工作流的 Workflow ID ≠ 机器人 ID
- 这篇讲的是旧版扣子的获取方式,新版扣子智能体的入口也不一样
正确拿法:
- 先创建一个智能体(智能体里面是可以添加工作流的,工作流要挂到智能体上)
- 在项目开发列表里点开你的智能体
- 进入预览调试页面
- 看浏览器地址栏
地址栏里会出现两组编号:
- 一个是 Space ID(空间 ID)
- 一个是 BOT,BOT 后面跟着的那串字符,就是你要的机器人 ID
二、个人服务令牌:一定设成永久有效
第二个参数,个人服务令牌,获取路径:
- 进入 API 管理
- 找到授权板块
- 点开服务身份及凭证
- 在这里生成个人服务令牌
⚠️ 关键一步:有效期选永久
生成令牌的时候一定要设置成永久有效。
要是随便生成一个,默认可能一个月就过期。到期之后你的外部程序直接调不通,还很难想起来是令牌过期的问题,白白排查半天。
三、完整流程捋一遍
| 参数 | 在哪拿 | 注意事项 |
|---|---|---|
| 机器人 ID | 项目开发列表 → 点开智能体 → 预览调试页 → 浏览器地址栏 BOT 后面那串 | 不是 Workflow ID;要先建智能体 |
| Space ID | 同一地址栏里,Space 后面那串 | 区分好两组编号 |
| 个人服务令牌 | API 管理 → 授权 → 服务身份及凭证 → 生成令牌 | 务必设成永久有效 |
写在最后
调 API 这事,参数位置搞清楚了就两分钟的事;搞不清楚,能卡你一晚上。
记住两个核心点:机器人 ID 在智能体预览调试页的地址栏里,不是工作流的 ID;令牌生成时选永久有效。
用旧版扣子做外部对接的小伙伴,照这个流程走,基本不会再卡在参数这一步。
十年开发经验程序员,独立开发《唯一客服系统》
一款基于Golang+Vue开发的在线客服系统,软件著作权编号:2021SR1462600。一套可私有化部署的网站在线客服系统,编译后的二进制文件可直接使用无需搭开发环境,下载zip解压即可,仅依赖MySQL数据库,是一个开箱即用的全渠道在线客服系统,致力于帮助广大开发者/公司快速部署整合私有化客服功能。
开源地址:唯一客服(开源学习版)
官网地址:唯一客服官网
浙公网安备 33010602011771号