> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asktable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在扣子中集成和查询数据

> 把 AskTable 作为插件接入扣子的智能体、工作流或对话流，让扣子机器人用一句话查 Excel 和数据库。

扣子（Coze）是字节跳动的智能体搭建平台。把 AskTable 的官方插件加到扣子里，你的扣子机器人就能用自然语言查 AskTable 上的数据——比如「张三考了多少分」。

## 官方插件

在扣子插件商店搜索 **AskTable**，选 [一句话查 Excel 或数据库](https://www.coze.cn/store/plugin/7407079384349343784)。它用来查询你已经在 AskTable 里连好的数据源（Excel、数据库都行）。

## 前置条件

在 AskTable 控制台准备好两样东西：

1. **数据源**：已经连好，并记下它的 ID（形如 `ds_xxxxxxxx`）。还没连见 [连接数据源](/concepts/data/connect)。
2. **API-Key**：在 **设置 → API-Key** 新建一个 **asker** 类型的 key（问数用，权限低），完整值形如 `ASKER_xxxxxxxx`。

<Warning>
  扣子插件用 **asker**（低权限）key，不要用 admin key。asker 只能问数，万一泄露风险也小。
</Warning>

## 在智能体中使用

<Steps>
  <Step title="创建智能体">
    打开 [扣子](https://www.coze.cn)，创建一个智能体，填好基本信息。
  </Step>

  <Step title="添加插件">
    在智能体编辑页找到「插件」区，点 **+**，搜索 **AskTable**，选「一句话查 Excel 或数据库」添加。
  </Step>

  <Step title="创建两个变量">
    在智能体的「变量」里建两个：

    | 变量名        | 值                                           |
    | ---------- | ------------------------------------------- |
    | `at_auth`  | `Bearer ASKER_xxxxxxxx`（注意 `Bearer ` 前缀加空格） |
    | `at_ds_id` | `ds_xxxxxxxx`（你的数据源 ID）                     |
  </Step>

  <Step title="配置插件参数">
    在插件的参数配置里绑定：

    * `Authorization` → 变量 `at_auth`
    * `datasource_ids` 是数组，添加一个数组项，值绑定变量 `at_ds_id`（或直接填数据源 ID）。要一次查多个数据源，就添加多个数组项。
  </Step>

  <Step title="预览调试">
    用预览功能问一句（比如「张三考了多少分」），确认能正确返回结果。
  </Step>
</Steps>

## 在工作流 / 对话流中使用

流程一样：在工作流或对话流里添加 AskTable 插件节点，同样用 `at_auth`、`at_ds_id` 两个变量配置参数，`Authorization` 保持 `Bearer ASKER_xxxxxxxx` 格式，`datasource_ids` 数组项填数据源 ID 即可。

## 后续步骤

* [连接数据源](/concepts/data/connect) — 先把数据接进 AskTable
* [MCP](/how-to/mcp) — 想让其它 AI agent 接入 AskTable，可以用 MCP