joblanders.ai/agentesQué es un agente, qué no lo es, y cómo se monta uno.
Todo el mundo vende agentes. Casi nadie explica qué es un agente. Esta página tiene la definición, las seis cosas que se confunden con un agente, las nueve capas que hacen falta y los seis pasos para poner uno a trabajar. Hay un segundo tab con la parte técnica, para quien escribe el código, y un tercero con un diagnóstico: cuéntanos tus flujos y te decimos si necesitas un agente, y cuál.
01 · joblanders.ai/agentesQué es un agente
Un agente es software que recibe un objetivo, no una orden. Decide solo el siguiente paso, usa herramientas reales sobre tus sistemas, y sabe cuándo parar y cuándo llamar a una persona. Nada más, y nada menos.
Recibe un objetivo
No le dices los pasos. Le dices el resultado: que ningún candidato quede sin respuesta en menos de una hora.
Decide por su cuenta
Dos casos parecidos pueden necesitar pasos distintos. El agente elige el orden, y puede cambiar de idea a mitad de camino.
Usa herramientas reales
Lee y escribe en tu ATS, tu CRM, tu calendario. Si solo puede hablar, no es un agente.
Sabe cuándo parar
Cierra el caso, o lo pasa a una persona con todo el contexto. Un agente sin freno no es un producto, es un riesgo.
02 · joblanders.ai/agentesQué no es un agente
La mitad de lo que hoy se vende como agente es una de estas seis cosas. Las seis son útiles. Ninguna es un agente. Pulsa cada tarjeta para ver qué es en realidad y cuándo sí conviene.
Un chatbot con respuestas escritas
Contesta. No actúa. No cambia nada en ningún sistema.
Una automatización (si esto, entonces aquello)
La decisión la tomó quien escribió la regla, no el software.
Un prompt muy largo
Es texto, no un sistema. Sin herramientas, sin memoria, sin límites, sin registro.
Un modelo de lenguaje
Es el motor. Un coche es mucho más que un motor.
Un robot que imita clics (RPA)
Repite la pantalla. Se rompe el día que la pantalla cambia.
Una persona con un atajo
Alguien que pega en un chat y copia la respuesta. Sigue siendo trabajo humano.
03 · joblanders.ai/agentesLos seis bloques
Todo agente tiene las mismas seis piezas. Apaga una y mira con qué te quedas.
04 · joblanders.ai/agentesLas nueve capas
Una demo necesita cuatro capas. Un sistema en producción necesita nueve. Esta es la lista honesta, con la pregunta que hay que responder en cada una.
05 · joblanders.ai/agentesCómo se monta uno
Seis pasos, en este orden. Saltarse el paso 3 es el error más común y el más caro.
Elige un flujo aburrido
Repetido, medible y con un dueño claro. No el más difícil, ni el más visible: el que pasa cien veces por semana.
ej. contestar a candidatos que preguntan por su estadoEscribe el resultado en una frase
Si no puedes decir en una línea qué es un buen resultado, no lo puedes medir, y luego nadie se pondrá de acuerdo en si funcionó.
ej. todo candidato contestado en menos de 1 hora, sin dato erróneoReúne 50 casos resueltos
Conversaciones reales que acabaron bien, y las que acabaron mal. Ese es el examen. Sin examen no se distingue una versión buena de una con suerte.
los fallos valen más que los aciertosPrimero solo lectura
Que proponga y que una persona apruebe, durante dos semanas. Aprendes dónde se equivoca sin pagar el error.
el porcentaje de aprobación es tu primera métrica realPon los límites antes del primer cliente
Tope de pasos, traspaso a persona dentro del mismo canal, registro de cada decisión, y la lista de lo que nunca debe decir ni hacer.
y un interruptor que lo apagaAbre la mano por tramos
Lo que acierta 95 veces de 100 se aplica solo. El resto se queda como propuesta para una persona. Cada noche, lo aprendido que acerca al objetivo se aplica, y lo que no, se propone a un humano al día siguiente.
este bucle nocturno es la parte que acumula¿Y tú, necesitas uno?
Ocho preguntas sobre tus flujos. Al final tienes un veredicto, el agente que encaja, las capas que te faltan y las horas que recuperarías al mes.
joblanders.ai/agentes · técnicoEl modelo no es el problema. El arnés sí.
Esta parte es para quien lo va a construir. Un modelo mejor no arregla un agente que dice que terminó cuando no ha terminado, que se olvida de una regla o que pide aprobación sin parar. Las tres cosas viven en el software que rodea al modelo. Aquí están las decisiones de ese software, con cifras, y las piezas de gobierno que lo hacen usable dentro de una empresa europea. Da por leída la guía: la definición, las nueve capas y los seis bloques están en el primer tab y aquí no se repiten.
T1 · joblanders.ai/agentesEl arnés, y quién pone cada pieza
Llamamos arnés al software que rodea al modelo: el bucle, las herramientas, la memoria, los permisos y la verificación. Ya tienes uno. Casi nadie lo diseñó. Por eso dos equipos con el mismo modelo obtienen resultados muy distintos.
El motor y su fontanería
- El bucle interno que llama al modelo una y otra vez
- Las herramientas de serie: leer un fichero, buscar, ejecutar código
- Cómo se maneja y se compacta la ventana de contexto
Todo lo que decide el resultado
- El fichero de instrucciones: tu criterio, escrito
- El examen: casos reales con respuesta conocida
- Los permisos: qué puede tocar, y dónde se para
- La definición de terminado
T2 · joblanders.ai/agentesLas seis decisiones
Ojo, no son los seis bloques de la guía. Los bloques son las piezas que tiene todo agente. Estas son las decisiones que tomas sobre esas piezas, cada una con una respuesta buena y una mala. Abre cada una para ver la regla y la cifra que la respalda.
T3 · joblanders.ai/agentesTres formas reales, y lo que cuestan
Tres empresas publicaron su arnés. Son tres formas distintas para tres problemas distintos. Elige la que encaja con tu problema, no la que suena mejor.
El arnés como plataforma
Una máquina virtual de un solo uso por agente, guías escritas en YAML, y una sola pasarela de herramientas que lo registra todo. Escala porque nadie se monta la suya.
130.000 tareas al mes, 25.000 revisiones por semanaEl repositorio es el arnés
Un fichero de instrucciones de unas 100 líneas que funciona como índice, y las reglas de arquitectura convertidas en linters propios. Lo que se rompió dos veces se convirtió en una comprobación, no en un párrafo.
3 personas, unos 1.500 PR en 5 mesesReparto de papeles
Un agente escribe la especificación, otro construye, otro puntúa desde el navegador. Se hablan solo por ficheros, así cada traspaso deja un rastro legible.
misma tarea: 6 h y 200 $, contra 20 min y 9 $ sin arnésT4 · joblanders.ai/agentesEl agente no toca tablas
La idea más difícil de copiar de todo lo que hemos visto. El agente no recibe tablas en crudo ni APIs sueltas. Recibe objetos con tipo, y cada objeto tiene tres caras.
Semántica: qué es la cosa
Una vacante, un candidato, un contrato, con su vocabulario y sus relaciones. No una fila de una tabla: una cosa que tu empresa ya sabe nombrar.
Cinética: qué puede hacer
Las acciones permitidas sobre ese objeto, incluida la escritura de vuelta. El agente no se inventa una actualización, llama a una acción que el objeto ya ofrece.
Dinámica: simular antes
Probar el cambio y ver el efecto antes de confirmarlo. Es lo que convierte una escritura arriesgada en una propuesta que una persona puede leer.
T5 · joblanders.ai/agentesCuatro piezas de gobierno que salen baratas
La ontología necesita años. Estas cuatro piezas necesitan semanas, y son las que te va a preguntar un departamento legal o un comité de empresa. Cada una encaja en una capa del stack.
Puntos de control y aprobación de verdad
Una puerta real dentro del bucle, no una frase en el prompt. La ejecución se para en la puerta y espera a una persona, y la espera queda registrada. En empleo esto no es un extra, es la ley.
Permiso por finalidad, no por rol
El acceso se concede para una finalidad declarada, y caduca. Encaja casi uno a uno con la limitación de finalidad de la ley europea. Un rol dura para siempre, una finalidad no.
Ramas del estado completo
Se crea una rama del dato, corre el agente, se inspecciona lo que hizo y se fusiona. Es control de versiones para la capa de datos, y es la única forma honesta de probar sobre datos reales sin tocar producción.
Canales de publicación del comportamiento
El comportamiento se empaqueta y se publica por canal: interno, canario, general. Es lo que te deja volver a la versión de ayer sin tocar código, y es la capa que casi nadie tiene.
T6 · joblanders.ai/agentesMesa puesta, y lo que casi nadie tiene
Útil cuando compares proveedores. La columna de la izquierda está en todas las presentaciones del mercado, así que no decide nada. La de la derecha es la que decide si funciona en producción.
Esto lo tiene todo el mundo
- Catálogo de modelos, incluido el tuyo
- Ocultación de datos personales
- Caché y reintentos
- Disparadores por horario, evento o API
- Construir, orquestar y evaluar agentes
- Paneles de observabilidad
Pregunta por estas cinco
- Memoria de verdad, no una ventana más larga
- Un precio atado al resultado
- El detalle de cómo se evalúa, no la palabra evaluación
- Una historia para muchos clientes en un mismo sistema
- Coste por caso, en euros
T7 · joblanders.ai/agentesSeis detalles que se olvidan
Estos no salen en ningún hilo. Salen de nuestros propios sistemas en producción, y cada uno nos ha costado algo al menos una vez.
Idempotencia
Toda herramienta que escribe necesita una clave propia del caso. El agente va a reintentar, y un reintento no puede crear dos candidatos ni enviar el mismo correo dos veces.
El texto de fuera es dato, no orden
Un CV, un correo o una página web pueden traer instrucciones escondidas. El texto de terceros se marca como dato y nunca se lee como instrucción. Es el agujero de seguridad propio de los agentes y de nada más.
Versión del modelo fijada
Si apuntas a la última versión, tu proveedor cambia el comportamiento de tu agente sin avisarte. Se fija la versión y se sube a mano, con una pasada del examen antes y después.
Cachea la parte fija
La parte del contexto que no cambia se cachea. En bucles largos es la diferencia entre una factura que asusta y una que no. Es una línea de código.
Tope de gasto por caso
Además del tope de pasos, un techo en euros por caso y por día. El caso raro es el que se come el presupuesto, y siempre llega un viernes.
Agentes pequeños contra un bucle gordo
Medido en nuestro propio sistema: partir el trabajo en investigar, escribir y revisar cuesta lo mismo que un bucle único, y además deja usar un modelo barato en la parte de investigar. El bucle único perdió el formato de salida en dos de dos intentos.
T8 · joblanders.ai/agentesLa versión de fin de semana
Resumen a propósito de este tab: las cinco cosas que dan casi todo. En este orden, y cuestan un fin de semana. Aquí no hay nada nuevo, así que si solo lees una hoja, lee esta.
Un fichero de instrucciones, menos de 100 líneas
Funciona como índice y enlaza a los documentos de verdad. Largo no es mejor: largo se salta.
Lo que se rompe dos veces pasa a ser comprobación
No un párrafo pidiéndole que no lo vuelva a hacer. Una comprobación que falla, en el pipeline.
Los cuatro ficheros, y un commit cada vez
Especificación, plan, progreso, decisiones. Commit tras cada cambio que funciona, así una caída cuesta minutos y no un día.
Fija las reglas que nunca se resumen
En un fichero que el agente vuelve a leer, no en la conversación. La conversación se compacta y la regla desaparece.
Tres pasadas por caso, puntúa la peor
Los casos ya los tienes de la guía. Empieza por veinte y pasa cada uno tres veces, en sesión limpia. La media esconde la pasada mala, y la pasada mala es la que le toca a tu cliente.
¿Quieres que lo montemos?
Montamos el arnés, no la demo. Si prefieres saber primero si de verdad necesitas un agente, el diagnóstico son ocho preguntas y es honesto: en la mitad de los casos la respuesta es que no.
¿Tus flujos necesitan un agente?
Ocho preguntas, un minuto. No preguntamos por tecnología, preguntamos por tu trabajo. El resultado es honesto: en la mitad de los casos la respuesta correcta no es un agente.