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

# Airtable

> 配置一个使用已连接的 Airtable 账户读取或写入 Airtable 记录的工作流步骤

# Airtable

当你希望工作流步骤从已连接的账户在 Airtable base 中创建、列出、更新或检索记录时,请使用 **Airtable**。

## 配置

| 选项                  | 是否必填 | 说明                                                                                                        |
| ------------------- | ---- | --------------------------------------------------------------------------------------------------------- |
| Name                | 否    | 步骤在工作流画布中的标签。                                                                                             |
| Authentication      | 是    | 此步骤使用的已连接 Airtable 账户。                                                                                    |
| Action              | 是    | 要执行的 Airtable 操作(Create Record、List Records、Update Record、Get Record)。                                    |
| Arguments           | 是    | 由操作的 schema 生成的每操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮用于注入 `{{placeholder}}` 值。提供 **Raw JSON** 标签供高级使用。 |
| When the step fails | 否    | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。                                                      |

在配置此步骤之前,请在工作区的 **Integrations** 中连接 Airtable。如果没有可用的活动 Airtable 连接,该步骤会显示警告并链接到 **Integrations**,而不是账户选择器。

## Arguments 表单

当你选择一个操作时,**Arguments** 区域会自动渲染一个由该操作输入 schema 驱动的表单——无需手动编辑 JSON。每个字段包含:

* 来自操作 schema 的标签和描述。
* 标签旁边的 **Insert Variable** 按钮,可在光标位置注入诸如 `{{step_1.output.id}}` 的引用。
* 如果必填字段为空,则显示内联验证反馈。

### 字段类型

| 字段类型              | 渲染方式                                                                                         | 是否支持 Insert Variable               |
| ----------------- | -------------------------------------------------------------------------------------------- | ---------------------------------- |
| 文本 / 数字           | 普通输入框。                                                                                       | 仅在 Create Record 和 Update Record 中 |
| 布尔值               | 开关(标签在左,开关在右)。                                                                               | 否                                  |
| Base ID(`baseId`) | 从已连接 Airtable 账户填充的下拉菜单——按名称选择你的 base。                                                       | 否                                  |
| 字段                | JSON 文本区域(等宽字体)。粘贴原始 JSON 对象,或当字段来自先前步骤输出时使用 **Insert Variable** 传入 `{{step_1.record}}` 占位符。 | 始终支持                               |
| 标签列表 / 数组         | 文本输入列表。**Add** 按钮显示在数组标签旁边。                                                                  | 否(数组项不支持变量插入)                      |

切换到 **Raw JSON** 标签可供高级用户使用,或当你倾向于手写完整参数对象时使用。两个标签之间的更改保持同步。

## 操作

| 操作            | 说明            |
| ------------- | ------------- |
| Create Record | 在指定的表中创建新记录。  |
| List Records  | 列出表中的记录,可选筛选。 |
| Update Record | 通过 ID 修改现有记录。 |
| Get Record    | 通过 ID 检索单条记录。 |

## 输出

此步骤将 Airtable API 响应存储为步骤输出。响应的形状取决于操作。

在后续步骤中使用完整输出引用:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

例如,在 **Create Record** 步骤之后,你可以引用新记录的 ID:

```text theme={null}
{{step_2.output.id}}
```

## 示例

1. 打开 **Integrations** 并连接 Airtable(如果尚未连接)。
2. 将 **Airtable** 步骤添加到你的工作流。
3. 在 **Authentication** 中选择已连接的账户。
4. 在 **Action** 中选择 **Create Record**。
5. 在 **Arguments** 表单中,填写 **Table ID** 和字段值。使用 **Insert Variable** 为任何字段值引用早前步骤的输出。
6. 点击步骤标题中的 **Run** 来测试操作,然后在 **Output** 中查看返回的载荷。

{/* Add screenshot: Airtable step output tab after a test run */}

## 备注

* 此步骤依赖于工作区中已连接的 Airtable 集成。
* 如果你倾向于直接编写 JSON,Arguments 中的 **Raw JSON** 标签始终可用。
* `tableId` 是 Airtable 表标识符(以 `tbl` 开头)。

## 将 Airtable 用作智能体工具

你也可以在 **Agent Editor** 中将 Airtable 添加为工具。打开智能体,点击 **Add tool**,然后选择 **Airtable**。在工具设置面板中,选择智能体应使用的已连接 Airtable 账户。智能体将在对话中相关时自动调用 Airtable 操作。

另见:[Integrations](../../../workspace/integrations)、[创建和编辑](../../creating-and-editing) 和 [测试与迭代](../../testing-and-iteration)