Cuándo usar un agente de IA y cómo limitar sus pasos

Antes de empezar

Nivel intermedio. Necesitas Node.js, el programa que ejecuta JavaScript en tu ordenador, y un editor de texto. No necesitas cuenta ni clave.

Abre una terminal: una ventana donde escribes órdenes para tu ordenador. Sitúate en la carpeta del archivo.

Un agente usa un modelo para decidir pasos y solicitar herramientas dentro de los permisos de tu aplicación.

Un workflow, o flujo de trabajo, sigue un recorrido definido por tu aplicación.

Function calling significa solicitar una herramienta con datos estructurados. Tu aplicación autoriza y ejecuta la operación.

1. Dibuja el recorrido de tu tarea

Escribe los pasos necesarios. Si conoces su orden, empieza con un flujo de trabajo fijo.

Considera un agente cuando la siguiente acción dependa del resultado anterior. Define siempre cuándo debe detenerse.

Qué deberías ver: Una secuencia de pasos o una decisión concreta que depende del resultado anterior.

2. Guarda el bucle simulado

Guarda el bloque en bucle.mjs. run repite decisiones simuladas y permite únicamente search, que significa «buscar».

finish significa «terminar». maxSteps marca el máximo de pasos. Ninguna búsqueda sale de tu ordenador.

// Decisiones simuladas, sin modelo ni efectos externos.
function run(decide, maxSteps = 3) {
  const history = [];
  for (let step = 0; step < maxSteps; step++) {
    const action = decide(history);
    if (action.name === "finish") return action.result;
    if (action.name !== "search") throw new Error("Herramienta no permitida");
    history.push({ result: "encontrada" });
  }
  throw new Error("Límite de pasos");
}
const result = run(history => history.length
  ? { name: "finish", result: history[0].result }
  : { name: "search" });
console.log("Resultado: " + result);
try {
  run(() => ({ name: "search" }));
  throw new Error("El bucle no se detuvo");
} catch (error) {
  if (error.message !== "Límite de pasos") throw error;
  console.log("Límite de pasos respetado");
}

Resultado: encontrada
Límite de pasos respetado

Qué deberías ver: Un archivo bucle.mjs con una prueba que termina y otra que alcanza el límite.

3. Ejecuta la prueba de detención

Escribe node bucle.mjs en la terminal. El programa comprueba que puede terminar y que no continúa indefinidamente.

Qué deberías ver: Dos líneas: «Resultado: encontrada» y «Límite de pasos respetado».

4. Define las acciones permitidas

Haz una lista de las herramientas que requiere tu tarea. Mantén las operaciones de escritura sujetas a autorización.

Antes de conectar un modelo, consulta cómo solicita herramientas el proveedor. Su petición no concede permiso para ejecutarlas.

Qué deberías ver: Una lista de acciones y permisos. El ejemplo acredita un bucle local, no un agente conectado a una API.

Errores comunes

El proceso no termina: fija un máximo de pasos y prueba que se respeta.

Aceptas una herramienta desconocida: recházala antes de ejecutarla. La lista debe pertenecer a tu aplicación.

Automatizas una escritura sin permiso: añade autorización antes de cualquier cambio externo.

Qué has aprendido

Puedes distinguir un proceso fijo de decisiones variables. Has ejecutado un límite local y definido quién permite cada acción.

Siguiente paso

Continúa con cómo proteger una integración de ia con permisos.