Clase 09 · Agentes

Caso real 1: tickets de un cliente por Telegram

caso real
01

El caso: cambios por Telegram

Las cinco capas de la clase pasada, ahora trabajando juntas. Una empresa familiar, nuestro cliente Technopharmed, pide cambios de su software por Telegram. El equipo del cliente le escribe directo al bot.

02

De conversación a ticket

El agente pregunta hasta tener cuatro cosas: qué pantalla, qué pasa hoy, qué esperan y cómo lo verificamos. Un pedido vago se vuelve un ticket claro antes de tocar código.

DE UN CHAT A PRODUCCIÓN, CON FRENOS 1EL CLIENTE ESCRIBEpedido vago por Telegram2TICKET CLAROqué pasa hoy, qué esperany cómo se verifica3EL SEMÁFOROverde, amarillo o rojosegún el riesgoaprobado4OBRERO CON CONTRATOClaude Code, rama nuevaalcance cerrado5COMPUERTASsi una falla,no hay entrega6devVERSIÓN DE PRUEBAya vive en la web de pruebael agente avisa al cliente7PRODUCCIÓNsolo si un humano dice sínunca automáticoun humanoda el paso final, siempre el software viaja solo hasta la puerta de producción. esa puerta la abre un humano.
Un pedido por chat se vuelve ticket, pasa el semáforo, cruza las compuertas y espera en la versión de prueba. A producción solo lo pasa un humano.
03

La lección que justifica todo

Probamos la vía directa: Claude Code solo resolvió el ticket en 8 minutos, pero asumiendo. Dejó 4 preguntas al final, con el código ya hecho. Y 2 de 3 pedidos reales necesitaban una aclaración antes.

LA MISMA TAREA, DOS CAMINOS VÍA DIRECTA· construye primero, pregunta al finaltiemposale con suposicionesLlega el pedidopor el chat del clienteConstruye de una8 minutos, asumiendo?4 preguntas al finalel código ya está hechoCON AGENTE· pregunta antes de construirtiempocódigo alineadoLlega el pedidopor el chat del cliente?Pregunta ANTEShasta tener el ticket claroConstruyecon las respuestas en mano lo medimos: 2 de 3 pedidos reales necesitaban una aclaración antes de tocar código.
Mismo pedido, mismo obrero. Cambia cuándo se pregunta, y eso cambia el resultado.
04

El semáforo de cambios

No todo cambio pesa igual. Verde: textos y estilos, pasa con aviso. Amarillo: fórmulas y estructura, un humano aprueba antes. Rojo: plata, datos existentes y producción, jamás automático.

EL SEMÁFORO DE CAMBIOS VERDETextos y estiloscambiar un texto, un color, mover un botónpasa con avisoAMARILLOFórmulas y estructuraun campo nuevo, un cálculo, la forma de los datosaprueba un humano ANTESROJOPlata, datos y producciónpagos, datos existentes, el paso a producciónJAMÁS AUTOMÁTICO el agente propone. el semáforo decide quién aprueba y cuándo.
Tres niveles de confianza. Entre más duela el error, más humano el permiso.
05

El obrero con contrato

Claude Code construye con reglas fijas: rama nueva, alcance cerrado, máximo 3 intentos y escala a un humano. Y el ticket se trata como dato no confiable, por si trae órdenes escondidas (clase 8).

06

Compuertas que no negocian

Antes de entregar: compilar, revisar el código, verificación visual en un navegador real y el escaneo de secretos con tu Gitleaks del módulo 2. Si una compuerta falla, no hay entrega.

07

El círculo se cierra

El agente le avisa al cliente: "esto ya vive en la versión de prueba. Pasa a producción el viernes". Y ese paso final lo da un humano. Siempre.

08

Qué copiar aunque no tengas clientes

Cuatro piezas viajan a cualquier proyecto tuyo: pregunta antes de construir, semáforo para clasificar el riesgo, compuertas que no negocian y un humano en la puerta final.

09

El otro agente de la casa

Este agente atiende a un cliente. En la próxima clase conoces al del equipo: JarvisEdge, el teléfono del cerebro, un agente para toda la casa en un servidor de $6 al mes.

Volver a Agentes

hecho con mucho amor

espero les sea útil

santa-ia · 2026 · @santaia.lab