input y pasan los resultados a los pasos posteriores mediante la función output.set().
Cuándo usar Ejecutar script en lugar de las acciones integradas
En general, utiliza las acciones integradas cuando se ajusten a tus necesidades. Utiliza Ejecutar script cuando necesites lógica personalizada, transformación de datos o una interacción compleja con una API.
Entorno
Cómo configurarla
- Añade una acción Ejecutar script a tu flujo de trabajo.
- El editor de scripts se abre con un lienzo en blanco. Escribe aquí tu código JavaScript.
- El script puede leer datos de pasos anteriores mediante el objeto
input(consulta la información siguiente). - Utiliza
output.set(key, value)para pasar resultados a los pasos posteriores. - (Opcional) Añade dependencias npm en el panel de configuración si tu script necesita bibliotecas externas.
- Haz clic en Probar para ejecutar el script con datos reales de la ejecución más reciente del desencadenador.
- Comprueba la salida de la prueba y los registros de la consola para verificar que el script funciona correctamente.
- Guarda la acción.
Leer datos de entrada
El objetoinput contiene datos de todos los pasos anteriores del flujo de trabajo. Cada paso se identifica por el ID de su acción.
Estructura de la entrada
Obtener datos del desencadenador (Campos del Registro)
Obtener datos de un paso Obtener Registros
Obtener datos de las salidas de otras acciones
Escribir la salida
Utilizaoutput.set(key, value) para poner los datos a disposición de los pasos posteriores. Puedes definir varias claves.
output.set("status", "success"), el paso siguiente puede hacer referencia a status en la salida de este script.
Depurar con console.log
Durante el desarrollo, utilizaconsole.log() para inspeccionar datos y seguir el flujo de ejecución. La salida de los registros aparece en el panel de prueba al hacer clic en Probar.
Gestión de paquetes npm
Puedes utilizar paquetes npm en tus scripts. Declara las dependencias en el panel de configuración:require():
Variables integradas
Seguridad: alcance de AUTOMATION_TOKEN
ElAUTOMATION_TOKEN se genera automáticamente para cada ejecución de la Automatización. Tiene los mismos permisos que el creador de la Automatización y su alcance se limita a la ejecución actual. Aspectos clave:
- Puede acceder a cualquier Tabla a la que tenga acceso el creador de la Automatización.
- Solo es válido mientras dure la ejecución del script (tiempo de espera de 60 segundos).
- No expongas este token a sistemas externos: está destinado a llamar a la API de Teable desde el script.
Llamar a la API de Teable
Llamar a la IA desde un script
POST /api/automation/runtime/ai envía un prompt al modelo de IA de tu Base. La Base se obtiene del contexto de la Automatización, por lo que no se necesita ningún ID de Base. El cuerpo acepta prompt, además de los parámetros opcionales attachments, modelKey, temperature y outputType; la respuesta es { "message": ... }.
Los archivos adjuntos son elementos { url, mimetype, name }: se admiten hasta 10 por llamada, cada uno de menos de 20 MB y con 30 segundos para su descarga, e incluyen imágenes, archivos PDF y documentos de Office. Es posible que el modelo de chat predeterminado no pueda leer imágenes y archivos similares, así que proporciona modelKey cuando envíes archivos. Cada llamada consume créditos.
Gestión de errores
Envuelve siempre las operaciones de riesgo en bloques try/catch para que el flujo de trabajo pueda gestionar los fallos correctamente:fetch o un formato de datos inesperado bloqueará el script, y los pasos posteriores no recibirán ninguna salida.
Ejemplo completo: procesar y dirigir tickets de soporte
Consejos
- Empieza con console.log. Al crear un script nuevo, registra primero el objeto
inputcompleto para comprender su estructura. - Crea scripts específicos. Haz bien una sola cosa en vez de concentrar varias tareas en un único script. Encadena varias acciones Ejecutar script si es necesario.
- Ten en cuenta el tiempo de espera de 60 segundos. Las operaciones prolongadas (procesamiento de grandes volúmenes de datos o muchas llamadas secuenciales a API) pueden alcanzar el tiempo de espera. Divide las tareas grandes en fragmentos más pequeños.
- Haz pruebas con datos reales. El panel de prueba utiliza datos reales de la ejecución más reciente del desencadenador para ofrecerte resultados realistas.
- Gestiona los datos que faltan. Utiliza valores predeterminados (operador
||) para los Campos que puedan estar vacíos o no definidos.
Contenido relacionado
- Generar con IA — para tareas de IA basadas en prompts que no necesitan código personalizado
- Solicitud HTTP — para llamadas sencillas a API que no necesitan scripts

