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.Crear las credenciales en Inagent
Necesitas dos credenciales:- Variables de configuración con
BASE_IDyTABLE_ID. - API Key con el Personal Access Token. Usa un nombre reconocible y no pegues el token en descripciones ni campos de variables.
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
- Solicita una lectura limitada de una tabla con datos de prueba.
- Confirma que los campos corresponden a la tabla elegida.
- Si habilitaste escritura, crea o actualiza un registro de prueba y revísalo en Airtable.
- Verifica que una operación deshabilitada sea rechazada.
Errores frecuentes
La Base o la tabla no se encuentran
La Base o la tabla no se encuentran
Comprueba que los IDs comiencen por
app y tbl, y que la Base figure entre los recursos del token.Falta acceso al esquema
Falta acceso al esquema
Añade
schema.bases:read; es necesario para que la aplicación reconozca los campos de la tabla.Una escritura devuelve acceso denegado
Una escritura devuelve acceso denegado
Revisa
data.records:write, los permisos del usuario de Airtable y que la operación esté habilitada en Inagent.El token dejó de funcionar
El token dejó de funcionar
Comprueba que no se haya regenerado, eliminado o modificado. Si se regeneró, actualiza la credencial en Inagent.

