扣子（Coze）是字节跳动的智能体搭建平台。把 AskTable 的官方插件加进去，你的扣子机器人就能用自然语言查 AskTable 上已经连好的数据源。插件背后调的是 AskTable 的 REST 接口，所以凭证和数据范围仍然在 AskTable 这一侧管。

​
开始前

  • 一个 AskTable 项目，里面已有连好的数据源，并记下它的 ID（形如 ds_xxxxxxxx）。还没有数据源就先去连接数据源。
  • 一个 asker 类型的项目 API-Key：左侧主导航 → 「设置」 → 「API-Key」 → 「创建 API-KEY」，在类型里选 asker。完整值形如 ASKER_xxxxxxxx，只在创建时显示一次。
  • 一个扣子账号。
  • 插件按最小权限用：不要用 admin Key。

​
操作步骤

1

确认官方插件

在扣子插件商店搜索 AskTable，选一句话查 Excel 或数据库。它查的是你已经连在 AskTable 里的数据源，Excel 和数据库都行。
2

在智能体里添加插件

打开扣子，创建一个智能体，填好基本信息。在智能体编辑页找到「插件」区，点「+」，搜索 AskTable，把「一句话查 Excel 或数据库」加进来。
3

建两个变量

在智能体的「变量」里建两个：
4

把插件参数绑到变量

在插件的参数配置里：
  • Authorization 绑定变量 at_auth。
  • datasource_ids 是数组，添加一个数组项，值绑定变量 at_ds_id。要一次查多个数据源，就添加多个数组项，每项填一个数据源 ID。
5

用预览调试

用预览功能提一个数据问题，确认能返回结果。插件不传角色，所以数据范围等于这些数据源的全部内容；挑数据源时按最小够用原则来。
6

工作流或对话流里同样配置

在工作流或对话流里加一个 AskTable 插件节点，参数用同一套变量绑定：Authorization 保持 Bearer YOUR_API_KEY 的格式，datasource_ids 的数组项绑定 at_ds_id。

​
关键约束

​
出问题怎么判断

​
下一步

  • 想按角色限制数据范围，自己传 role_id：OpenAPI
  • 让 AI 客户端直接调用 AskTable 的更多能力：MCP
  • 先把数据源连好：连接数据源