Skip to main content
Conecta una Base y una tabla de Airtable para consultar registros y, si el caso de uso lo requiere, crearlos o modificarlos.

Capacidades y requisitos

La aplicación puede leer, crear, actualizar y eliminar registros según los permisos que habilites en Inagent. Necesitas una cuenta de Airtable con acceso a la Base, una tabla preparada y permiso suficiente para las acciones seleccionadas. Antes de empezar, obtén:

Preparar Airtable

1

Abre la Base y la tabla

Crea o revisa los campos que utilizará el agente. Conserva sus nombres exactos.
2

Copia los identificadores

Obtén el Base ID y el Table ID desde Airtable. Usa el ID de tabla, no su nombre visible.
3

Crea el token

En el Developer Hub, crea un Personal Access Token dedicado y añade la Base como único recurso de acceso.
4

Selecciona los scopes

Añade data.records:read y schema.bases:read. Incluye data.records:write solo si habilitarás creación, actualización o eliminación.
El token nunca puede hacer más de lo permitido al usuario que lo creó y solo alcanza los recursos seleccionados. Consulta Crear Personal Access Tokens en Airtable y la introducción a la Web API.

Crear las credenciales en Inagent

Necesitas dos credenciales:
  1. Variables de configuración con BASE_ID y TABLE_ID.
  2. API Key con el Personal Access Token. Usa un nombre reconocible y no pegues el token en descripciones ni campos de variables.
Si necesitas revisar el alta de cada tipo, consulta Credenciales.

Añadir Airtable desde el Market

1

Abre el Market

En el agente, selecciona Crear herramienta → Market → Airtable.
2

Asocia las credenciales

Selecciona la credencial de Variables de configuración y la credencial API Key creadas anteriormente.
3

Define los permisos

Empieza con Lectura. Activa inserción o actualización solo si el agente debe escribir; deja eliminación desactivada inicialmente.
4

Guarda

Revisa la Base, la tabla y el alcance antes de guardar la herramienta.

Instrucciones recomendadas para el guion del AV

Añade estas instrucciones al guion del Agente Virtual y adáptalas al caso de uso. El texto no sustituye los permisos configurados en la herramienta: si una operación está deshabilitada, el agente no podrá ejecutarla.

Comprobación final

  1. Solicita una lectura limitada de una tabla con datos de prueba.
  2. Confirma que los campos corresponden a la tabla elegida.
  3. Si habilitaste escritura, crea o actualiza un registro de prueba y revísalo en Airtable.
  4. Verifica que una operación deshabilitada sea rechazada.

Errores frecuentes

Comprueba que los IDs comiencen por app y tbl, y que la Base figure entre los recursos del token.
Añade schema.bases:read; es necesario para que la aplicación reconozca los campos de la tabla.
Revisa data.records:write, los permisos del usuario de Airtable y que la operación esté habilitada en Inagent.
Comprueba que no se haya regenerado, eliminado o modificado. Si se regeneró, actualiza la credencial en Inagent.