Saltar al contenido principal

Airtable

Usa Airtable cuando quieras que un paso del flujo de trabajo cree, liste, actualice o recupere registros en una base de Airtable desde una cuenta conectada.

Configuración

OpciónRequeridoDescripción
NameNoEtiqueta del paso en el lienzo del flujo de trabajo.
AuthenticationLa cuenta de Airtable conectada que se usará para este paso.
ActionLa acción de Airtable a realizar (Create Record, List Records, Update Record, Get Record).
ArgumentsCampos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón Insert Variable para inyectar valores {{placeholder}}. Hay disponible una pestaña Raw JSON para uso avanzado.
When the step failsNoControla si el flujo de trabajo debe Terminate Workflow o Continue si este paso falla.
Antes de configurar este paso, conecta Airtable en Integrations para tu espacio de trabajo. Si no hay una conexión activa con Airtable disponible, el paso muestra una advertencia con un enlace a Integrations en lugar del selector de cuenta.

Formulario de Arguments

Cuando seleccionas una acción, la sección Arguments renderiza automáticamente un formulario basado en el esquema de entrada de la acción — no se requiere edición manual de JSON. Cada campo incluye:
  • Una etiqueta y descripción tomadas del esquema de la acción.
  • Un botón Insert Variable junto a la etiqueta que inyecta referencias como {{step_1.output.id}} en la posición del cursor.
  • Retroalimentación de validación en línea si se deja vacío un campo obligatorio.

Tipos de campo

Tipo de campoCómo se renderizaInsert Variable disponible
Texto / númeroEntrada simple.Solo en Create Record y Update Record
BooleanoInterruptor (etiqueta a la izquierda, interruptor a la derecha).No
Base ID (baseId)Menú desplegable poblado desde tu cuenta conectada de Airtable — selecciona tu base por nombre.No
FieldsUn área de texto JSON (fuente monoespaciada). Pega un objeto JSON sin procesar o usa Insert Variable para pasar un marcador de posición {{step_1.record}} cuando los campos provengan de la salida de un paso anterior.Siempre
Lista de etiquetas / arregloLista de entradas de texto. El botón Add aparece junto a la etiqueta del arreglo.No (los elementos de arreglo no admiten inserción de variables)
Cambia a la pestaña Raw JSON para usuarios avanzados o cuando prefieras escribir manualmente el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

Acciones

AcciónDescripción
Create RecordCrea un nuevo registro en una tabla especificada.
List RecordsLista registros de una tabla con filtrado opcional.
Update RecordModifica un registro existente por ID.
Get RecordRecupera un solo registro por ID.

Salida

Este paso almacena la respuesta de la API de Airtable como salida del paso. La forma de la respuesta depende de la acción. Usa la referencia completa de salida en pasos posteriores:
{{STEP_IDENTIFIER.output}}
Por ejemplo, después de un paso Create Record podrías referenciar el ID del nuevo registro:
{{step_2.output.id}}

Ejemplo

  1. Abre Integrations y conecta Airtable si aún no lo has hecho.
  2. Agrega un paso Airtable a tu flujo de trabajo.
  3. Selecciona una cuenta conectada en Authentication.
  4. Elige Create Record en Action.
  5. En el formulario Arguments, completa Table ID y los valores de los campos. Usa Insert Variable para referenciar la salida de un paso anterior para cualquier valor de campo.
  6. Haz clic en Run en el encabezado del paso para probar la acción y, a continuación, revisa la respuesta devuelta en Output.

Notas

  • Este paso depende de una integración de Airtable conectada en tu espacio de trabajo.
  • La pestaña Raw JSON en Arguments siempre está disponible si prefieres escribir JSON directamente.
  • El tableId es el identificador de tabla de Airtable (comienza con tbl).

Uso de Airtable como herramienta de agente

También puedes agregar Airtable como herramienta en el Agent Editor. Abre el agente, haz clic en Add tool y selecciona Airtable. En el panel de configuración de la herramienta, elige la cuenta de Airtable conectada que el agente debe usar. El agente llamará a las acciones de Airtable automáticamente durante las conversaciones cuando sea relevante. Consulta también: Integraciones, Creación y edición y Pruebas e iteración