跳转到主要内容

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 响应存储为步骤输出。响应的形状取决于操作。 在后续步骤中使用完整输出引用:
{{STEP_IDENTIFIER.output}}
例如,在 Create Record 步骤之后,你可以引用新记录的 ID:
{{step_2.output.id}}

示例

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

备注

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

将 Airtable 用作智能体工具

你也可以在 Agent Editor 中将 Airtable 添加为工具。打开智能体,点击 Add tool,然后选择 Airtable。在工具设置面板中,选择智能体应使用的已连接 Airtable 账户。智能体将在对话中相关时自动调用 Airtable 操作。 另见:Integrations创建和编辑测试与迭代