---
title: Airtable
description: 读取、创建和更新 Airtable
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="airtable"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Airtable](https://airtable.com/) 是一个强大的云平台，它将数据库的功能与电子表格的简便性相结合。它允许用户创建灵活的数据库，用于组织、存储和协作处理信息。

使用 Airtable，您可以：

- **创建自定义数据库**：为项目管理、内容日历、库存跟踪等构建量身定制的解决方案
- **可视化数据**：以网格、看板、日历或画廊的形式查看您的信息
- **自动化工作流程**：设置触发器和操作以自动化重复性任务
- **与其他工具集成**：通过原生集成和 API 连接数百种其他应用程序

在 Sim 中，Airtable 集成使您的代理能够以编程方式与您的 Airtable 数据库交互。这使得数据操作变得无缝，例如检索信息、创建新记录和更新现有数据——所有这些都可以在您的代理工作流程中完成。将 Airtable 用作动态数据源或目标，使您的代理能够在决策和任务执行过程中访问和操作结构化信息。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Airtable 集成到工作流程中。可以创建、获取、列出或更新 Airtable 记录。需要 OAuth 授权。可用于触发模式，当 Airtable 表格更新时触发工作流程。

## 工具

### `airtable_list_records`

从 Airtable 表中读取记录

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `baseId` | string | 是 | Airtable 基础的 ID |
| `tableId` | string | 是 | 表的 ID |
| `maxRecords` | number | 否 | 要返回的最大记录数 |
| `filterFormula` | string | 否 | 用于筛选记录的公式 \(例如："\(\{字段名称\} = \'值\'\)"\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `records` | json | 检索到的 Airtable 记录数组 |

### `airtable_get_record`

通过 ID 从 Airtable 表中检索单个记录

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `baseId` | string | 是 | Airtable 基础的 ID |
| `tableId` | string | 是 | 表的 ID 或名称 |
| `recordId` | string | 是 | 要检索的记录 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `record` | json | 检索到的 Airtable 记录，包括 id、createdTime 和字段 |
| `metadata` | json | 操作元数据，包括记录数 |

### `airtable_create_records`

向 Airtable 表中写入新记录

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `baseId` | string | 是 | Airtable 基础的 ID |
| `tableId` | string | 是 | 表的 ID 或名称 |
| `records` | json | 是 | 要创建的记录数组，每个记录包含一个 `fields` 对象 |
| `fields` | string | 否 | 无描述 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `records` | json | 创建的 Airtable 记录数组 |

### `airtable_update_record`

通过 ID 更新 Airtable 表中的现有记录

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `baseId` | string | 是 | Airtable 基础的 ID |
| `tableId` | string | 是 | 表的 ID 或名称 |
| `recordId` | string | 是 | 要更新的记录 ID |
| `fields` | json | 是 | 包含字段名称及其新值的对象 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `record` | json | 更新后的 Airtable 记录，包含 id、createdTime 和字段 |
| `metadata` | json | 操作元数据，包括记录数和更新的字段名称 |

### `airtable_update_multiple_records`

更新 Airtable 表中的多个现有记录

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `baseId` | string | 是 | Airtable 基础的 ID |
| `tableId` | string | 是 | 表的 ID 或名称 |
| `records` | json | 是 | 要更新的记录数组，每个记录包含一个 `id` 和一个 `fields` 对象 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `records` | json | 更新的 Airtable 记录数组 |
