旧版扣子智能体外部调用,机器人ID和令牌到底在哪拿?

用旧版扣子知识库、扣子智能体,想让自己写的外部程序去调用它,手上必须有两个东西:

  • 机器人 ID(BOT ID)
  • 个人服务令牌(PAT)

参数没拿对,程序调一次报一次错,折腾半天还不知道问题出在哪。今天把这两个参数的获取方法讲清楚。


一、机器人 ID:别拿 Workflow ID 当机器人 ID

这是最多人踩的坑。

很多小伙伴建的是工作流、对话流,在浏览器地址栏里只看到一串 Workflow ID,就以为这就是机器人 ID——大错特错。

再说清楚一点:

  • 工作流的 Workflow ID ≠ 机器人 ID
  • 这篇讲的是旧版扣子的获取方式,新版扣子智能体的入口也不一样

正确拿法:

  1. 先创建一个智能体(智能体里面是可以添加工作流的,工作流要挂到智能体上)
  2. 在项目开发列表里点开你的智能体
  3. 进入预览调试页面
  4. 看浏览器地址栏

地址栏里会出现两组编号:

  • 一个是 Space ID(空间 ID)
  • 一个是 BOT,BOT 后面跟着的那串字符,就是你要的机器人 ID

二、个人服务令牌:一定设成永久有效

第二个参数,个人服务令牌,获取路径:

  1. 进入 API 管理
  2. 找到授权板块
  3. 点开服务身份及凭证
  4. 在这里生成个人服务令牌

⚠️ 关键一步:有效期选永久

生成令牌的时候一定要设置成永久有效。

要是随便生成一个,默认可能一个月就过期。到期之后你的外部程序直接调不通,还很难想起来是令牌过期的问题,白白排查半天。


三、完整流程捋一遍

参数 在哪拿 注意事项
机器人 ID 项目开发列表 → 点开智能体 → 预览调试页 → 浏览器地址栏 BOT 后面那串 不是 Workflow ID;要先建智能体
Space ID 同一地址栏里,Space 后面那串 区分好两组编号
个人服务令牌 API 管理 → 授权 → 服务身份及凭证 → 生成令牌 务必设成永久有效

写在最后

调 API 这事,参数位置搞清楚了就两分钟的事;搞不清楚,能卡你一晚上。

记住两个核心点:机器人 ID 在智能体预览调试页的地址栏里,不是工作流的 ID;令牌生成时选永久有效。

用旧版扣子做外部对接的小伙伴,照这个流程走,基本不会再卡在参数这一步。

posted @ 2026-09-09 15:49  程序员老狼  阅读(15)  评论(0)    收藏  举报