Scripts, automatizaciones que una persona aprueba

Un script es una automatización pequeña escrita en JavaScript que trabaja sobre la API de Nori. Sirve para tareas repetitivas que ninguna pantalla resuelve de una vez: un resumen semanal de ventas, una revisión de artículos sin existencia o un aviso que se arma con datos de varios módulos. Los encuentras en IA › Scripts.

Qué es un script

• Corre en una caja de arena aislada: no ve archivos, ni la base de datos, ni internet. Lo único que puede hacer es llamar a la API de Nori de tu empresa.
• Corre como un usuario (una persona o un agente de IA) y nunca puede más que ese usuario.
• Solo corre la versión publicada. Cada cambio es una versión nueva que alguien con permiso revisa antes de que corra.
• Puede correr a petición, a una hora (diario, semanal o mensual) o cuando pasa algo, como un pedido de venta nuevo.

Escribir un script

1. En IA › Scripts, elige Nuevo script.
2. Escribe el código. Es el cuerpo de una función: usa await nori.get('/documents', { type: 'invoice' }) para leer, nori.log('texto') para escribir en la bitácora y return para devolver el resultado.
3. Marca en Qué podrá hacer solo lo que el script necesita.
4. Elige con quién corre, cuándo corre y sus límites de tiempo, llamadas y tamaño del resultado.
5. Guarda el borrador. Con Probar lo ejecutas tú, solo con permisos de lectura, para ver qué devuelve.

Nori revisa el código antes de enviarlo: no acepta import, eval, Function, fetch, temporizadores, globalThis ni Deno. Si algo no pasa, la pantalla dice en qué línea.

Qué puede hacer un script

Cada script declara sus permisos, por ejemplo «leer artículos» o «crear, modificar y enviar documentos de venta». La pantalla los muestra como una frase: «Este script podrá: leer documentos de venta».

• Lo que no declaró, la API se lo niega aunque el usuario sí pueda hacerlo.
• Lo que declaró, solo lo puede hacer si el usuario con el que corre también tiene ese permiso en su rol.
• Por omisión un script solo lee. Lo que modifica datos se marca aparte y se resalta para quien aprueba.

Cada ejecución recibe un acceso que dura minutos y se borra al terminar. Ese acceso no sirve para iniciar sesión ni para otras partes de Nori.

Aprobar y publicar

1. Cuando el borrador está listo, elige Enviar a aprobación.
2. Quien tiene el permiso Aprobar, publicar y revertir scripts (normalmente el administrador) ve la versión con sus cambios contra la publicada, lo que podrá hacer, con quién corre y sus límites.
3. Elige Aprobar y publicar o Rechazar, con un comentario si quieres.

Si una versión nueva da problemas, en Versiones elige Volver a esta versión en la anterior: desde ese momento es la que corre. Apagar detiene el script sin borrarlo.

Ejecuciones y bitácora

Cada script guarda sus ejecuciones: quién la pidió, con quién corrió, cuánto tardó, el resultado o el error. Al abrir una ejecución ves:

• Resultado: lo que devolvió el script.
• Bitácora del script: lo que escribió con nori.log.
• Llamadas a la API: cada llamada con su respuesta, incluidas las que la API negó.

Todo cambio de versión, publicación, rechazo o reversión queda en el Historial del script con quién lo hizo.

Cuando un agente de IA propone un script

El asistente y los agentes de IA con el permiso Escribir y probar scripts pueden proponer un script o una versión nueva. Esa propuesta nunca se publica sola, sin importar cuánta autonomía tenga el agente:

1. La propuesta llega a IA › Aprobaciones de agentes con el código, lo que podrá hacer y los cambios.
2. Solo una persona con permiso de publicar scripts puede aprobarla. Al aprobarla queda publicada.
3. El script corre como el agente que lo propuso, con los permisos de su rol.

Un agente también puede ejecutar scripts publicados. Si el script solo lee, corre de inmediato; si modifica datos, espera aprobación igual que cualquier otra acción del agente.

Permisos

Los asignas en el rol de cada usuario. Ver Roles y permisos.

Si los scripts están apagados

Si la pantalla avisa que falta el programa que ejecuta los scripts, el servidor todavía no lo tiene instalado. Puedes escribir y aprobar scripts; correrán cuando se instale.