🍳 Las tres partes

¿Eres nuevo aquí? WAT es la sigla que da nombre a este curso: Workflow + Agent + Tools. Tres piezas que, juntas, transforman un pedido en portugués en una tarea ejecutada de verdad. Para fijar el modelo mental, piensa en una cocina profesional.

Una buena cocina tiene tres cosas separadas: la receta (el paso a paso escrito), el cocinero (quien lee la receta, decide los ajustes y corrige el sazón) y los ingredientes y electrodomésticos (lo que existe físicamente para convertirse en un plato). Quita cualquiera de las tres y la cocina deja de funcionar — o se convierte en otra cosa.

La analogía sirve para cualquier tarea repetitiva, no solo para la cocina. Tomemos un ejemplo muy distinto al de la newsletter: organizar los recibos del mes para la rendición de cuentas. La receta (workflow) dice "toma los recibos de la carpeta 'financiero', sepáralos por categoría, suma cada una y genera una hoja de cálculo con el resumen". El cocinero (agent) decide en qué categoría entra un recibo ambiguo («¿transporte o comida?») y detecta si un archivo llegó dañado. Los ingredientes (tools) son el lector de PDF/imagen que extrae el valor y la herramienta de hojas de cálculo que guarda el resumen. Ninguna de las tres piezas, por sí sola, organiza recibos.

¿Eres nuevo aquí? Workflow aquí es simplemente la receta escrita: una secuencia de pasos en texto simple (frecuentemente en markdown — una forma de dar formato al texto con títulos y listas, sin código complicado) que indica qué hacer, en qué orden y qué revisar en cada etapa.

Un buen workflow no necesita prever cada excepción: solo necesita ser lo bastante claro para que quien lo lea (el agente) sepa qué hacer en el camino normal y reconozca cuando algo se salga de lo previsto. Es diferente de un programa de computadora tradicional: no son instrucciones rígidas línea por línea, sino orientaciones que alguien capaz de interpretar (el agente) seguirá con criterio.

## Workflow: relatório semanal
1. Ler os números de vendas da planilha "vendas.csv"
2. Somar por categoria
3. Escrever um resumo de 3 parágrafos
4. Salvar como "relatorio-semana.md"
5. Se algum número parecer errado (negativo, vazio), avisar antes de salvar

Otro ejemplo breve, fuera del mundo del correo electrónico: un workflow para programar publicaciones en redes sociales podría decir «lee los textos de la carpeta 'posts-da-semana', genera una imagen de portada para cada uno, publica uno por día a las 9h y avisa si algún texto supera los 280 caracteres». La receta no explica cómo generar la imagen o cómo publicar — ese es el trabajo de las tools. Solo indica el orden, la excepción y cuándo detenerse.

O agent (agente) es Claude Code, el cocinero de nuestra analogía. Lee el workflow, interpreta cada paso, decide qué herramienta usar para ejecutarlo, revisa el resultado y ajusta el rumbo si algo no coincide con lo esperado. Es la pieza que aporta criterio al proceso: sin ella, la receta se queda en el papel.

Esto es diferente de un script tradicional (un programa fijo que solo repite los mismos pasos sin entender lo que está haciendo). El agente entiende la intención del paso "sumar por categoría", aunque la hoja de cálculo venga con una columna más o con un nombre diferente al esperado — se adapta dentro de lo razonable.

Error común: el agente "inventa" una ruta. Imagina un workflow de atención al cliente que dice "responde las consultas sobre pedidos usando los datos del sistema", pero nunca dice dónde ni está el sistema ni qué hacer si no se encuentra el pedido. Sin esta información, el agente puede improvisar —responder con una suposición— porque recibió la instrucción de resolver el problema, y «no sé» rara vez es la primera opción que intenta. No es que el agente «mienta»: está llenando un vacío que la receta dejó abierto. La corrección siempre está en el workflow: di «si no encuentras el pedido, detente y pregunta».

Tools (herramientas) son los ingredientes y electrodomésticos: las cosas que realmente hacen el trabajo cuando el cocinero las acciona: abrir un archivo, ejecutar un comando, enviar un correo electrónico, buscar algo en internet, llamar a una API (una puerta de comunicación que un sitio o servicio deja abierta para que los programas se comuniquen entre sí, sin necesitar una pantalla). Sin ellas, el agente solo tendría opiniones, no capacidad de actuar.

Una herramienta sin workflow es prácticamente inútil: tener un horno encendido no hace que el pastel se hornee solo: alguien (el agente, siguiendo la receta) tiene que poner la masa ahí en el momento y a la temperatura adecuados. Por eso las Rutas 2 (MCP) y 4 (Deploy) de este curso están dedicadas por completo a proporcionar y conectar herramientas, pero solo cobran sentido junto con un workflow que indique cuándo usarlas.

Error común: falta la clave de la herramienta. Muchas herramientas requieren una clave de API (contraseña larga que te identifica ante el servicio — Gmail, Google Calendar, una base de datos) configurada antes de funcionar. Sin ella, la herramienta queda bloqueada: el agente intenta usarla, recibe un error de acceso denegado y se detiene ahí. Conviene comprobarlo antes de cualquier nueva automatización: ¿existe la clave, está en el lugar correcto y sigue siendo válida? “Herramienta instalada” y “herramienta autorizada para actuar” son cosas diferentes — las Trilhas 2 y 4 muestran cómo guardar las claves de forma segura.

Leyenda: el mismo intento del agente, dos destinos distintos: la herramienta con la clave configurada completa el trabajo; la que no tiene clave bloquea la ejecución hasta que alguien corrija la configuración.

Separar workflow, agente y tools no es un capricho técnico: es lo que hace que el sistema sea lo suficientemente predecible para confiar en él y lo suficientemente flexible para ser útil. El workflow guarda el intención (qué hacer), el agente guarda el criterio (cómo interpretar y ajustar), y las tools guardan la capacidad (lo que es físicamente posible hacer en la computadora o en internet).

Leyenda: la receta entra por la izquierda, el agente interpreta y activa las herramientas a la derecha, y el resultado vuelve en ciclo para que el agente decida el siguiente paso — ese es el bucle que detalla el módulo 1.2.

Para ver las tres piezas en acción de principio a fin, sigue una solicitud real de clasificación de correos electrónicos de clientes: un escenario muy distinto del boletín que aparece más adelante en la ruta:

1. 1. La receta existe

   El workflow dice: «lee los correos nuevos, clasifícalos en consulta/reclamo/felicitación, responde las consultas sencillas y deriva los reclamos a una persona».

2. 2. El agente lee y clasifica

   Abre la bandeja de entrada (mediante una tool), lee cada correo y decide la categoría: ese juicio le corresponde al agente; el workflow solo proporcionó las categorías posibles.

3. 3. Las tools actúan

   Para una consulta sencilla, la tool de correo electrónico envía la respuesta estándar. Para una queja, otra tool se la remite a una persona y la marca como "prioridad".

4. 4. Se observa el resultado

   El agente comprueba que el envío se haya confirmado antes de seguir con el siguiente; si falla, lo intenta de nuevo o registra el error.

5. 5. Fin del ciclo

   Sin nuevos correos, el agente se detiene e informa un resumen: cuántos respondió y cuántos reenvió.

Dos combinaciones fallidas explican por qué las tres piezas deben estar juntas. Un agente sin workflow todavía funciona, pero resulta caro e impredecible: con cada solicitud reinventa el proceso desde cero, sin aprender de la última vez, y puede tomar caminos distintos en ejecuciones similares. Una tool sin workflow es prácticamente inútil por sí sola: una herramienta para enviar correos no decide por su cuenta cuándo ni a quién enviar algo.

Ejemplo de un agente sin workflow: pedir "organiza mi agenda" sin dar detalles. En una ejecución prioriza las reuniones de trabajo; en otra, los compromisos personales: no hay una receta que fije el criterio. Por otro lado, una tool sin workflow sería una herramienta de programación de publicaciones perfectamente configurada, con una clave válida, pero sin instrucciones sobre qué publicar y cuándo: está disponible, pero inactiva. Ambas situaciones refuerzan la misma lección: el workflow es lo que convierte la capacidad aislada en un resultado confiable.