Tier 3 · Guard & build3.322 min

Crea con Claude Code: dos agentes

A country road curving past an old woolshed under a green hillside at golden hourAgents at Work — CC BY 4.0

Todo lo que has aprendido hasta ahora te ha preparado para crear uno de estos sin hacer daño a nadie, ni siquiera a ti mismo. Ahora vamos a crearlo. Dos agentes, y el segundo no es lo que te esperarías: creas uno para que funcione y otro para ver cómo falla. El fallo es la lección.

Si has hecho la lección «Trabajar con Claude», allí conociste a Claude Code — la versión de Claude que puede leer tus archivos, ejecutar herramientas y llevar a cabo una tarea de principio a fin en tu propio ordenador. A eso es a lo que nos referimos con un «trabajo». No hace falta que seas programador; lo que necesitas es ser capaz de describir un trabajo con claridad y mantener la disciplina adquirida en las últimas cinco lecciones. Este es el Punto de referencia 1: aprende haciéndolo una vez, a pequeña escala.

Crea A: un buen agente, de principio a fin (el patrón transferible)

Creamos un verificador de conciliación: un agente que lee un lote de facturas y un extracto bancario, y señala aquellas que no coinciden. Se ha elegido deliberadamente: si lo sometes al triaje de Nivel 1, acaba directamente en la categoría de «agente »: una regla que puedes anotar, fácilmente reversible, un error que no afecta mucho a nadie y tus propios números en lugar de los datos de otra persona. No es una coincidencia; así es como debes elegir tu primer proyecto real.

Constrúyelo en el orden que se enseña en el curso, porque ese orden es el patrón transferible:

  1. Define el radio de acción (2.1). Solo lectura. Solo ve una carpeta de facturas y un archivo de extractos. No puede escribir, enviar, pagar ni acceder a nada más. Lo peor que puede pasar es que marque erróneamente una fila, y tú lo detectarás.
  2. Escribe los criterios, no las impresiones (2.3). La regla de coincidencia, de forma explícita: qué se considera una coincidencia, qué tolerancia, qué es una excepción. El agente devuelve las discrepancias que ha encontrado y el motivo — pruebas— y no «los libros parecen estar bien».
  3. Define los límites de seguridad (3.1). Marca aquello de lo que no está seguro en lugar de hacer conjeturas. Nunca adivina una cifra. Se detiene ante cualquier cosa que salga de la máquina: aquí no hay nada que enviar, y ese es el objetivo de una primera versión.
  4. Pruébalas (3.2). Comprueba aleatoriamente una muestra comparándola con la fuente. Introduce una instrucción deliberadamente errónea y confirma que detecta el error. Confía en él porque ha superado la prueba, no porque lo hayas creado tú.

Ese es un agente completo, útil y seguro, y su estructura se traslada directamente al siguiente que construyas. (Si tu cuello de botella es la bandeja de entrada en lugar de los libros, los mismos cuatro pasos te permiten crear un asistentede clasificación de la bandeja de entrada que ordena y redacta borradores, pero nunca envía nada; solo ten en cuenta que ahora maneja datos de otras personas, por lo que la cuestión de los datos del Nivel 1 es prioritaria).

Agente B: el «Reclutador», creado para ver cómo falla

Ahora viene el incómodo. Creamos el reclutador del tipo «ocultar y luego puntuar» —el agente que, según los consejos convenientes, está bien: ocultar los nombres, dejar que puntúe y mantener a un humano al final del proceso. Lo creamos específicamente para que puedas ver cómo ese consejo se desmorona en tus propias manos.

  1. Crea el agente de «censurar y luego puntuar». Toma las solicitudes, censura los campos de identidad obvios —nombre, edad, foto, dirección— y puntúa el resto según unos criterios. Exactamente la «selección segura mediante IA» que te vendería un proveedor.
  2. Ejecuta en él la prueba de intercambio de nombres (3.2). Toma una solicitud. Asigna una puntuación. Ahora cambia solo el nombre —nada más— y vuelve a puntuarla. A continuación, hazlo con un lote: intercambia géneros, intercambia nombres de origen claramente diferente, manteniendo todo lo demás constante.
  3. Observa lo que ocurre. La puntuación varía. Varía porque el modelo reconstruye la identidad a partir de los indicadores que no ocultaste —el colegio, la dirección, los huecos, la redacción— exactamente como advirtió el Nivel 2. Ocultaste el nombre y el sesgo se coló a través del código postal.
  4. Ahora reflexiona sobre la verdadera lección. Hiciste todo lo que te indicaba la versión «cómoda». Ocultaste datos. Mantuviste a una persona al final del proceso. Y tu propia prueba acaba de demostrar que el resultado se sesga por la identidad que creías haber eliminado. Aquí es donde un creador de agentes se gana el sueldo: aprendes a decir que no. Para una decisión de alto riesgo sobre una persona, en la que las correcciones fallan y la prueba arroja resultados sesgados, la respuesta disciplinada es un proceso restringido, sin clasificación y decidido por personas —o no automatizar la decisión en absoluto.

El objetivo de la Versión B nunca fue crear un clasificador de CV que funcionara. Se trata de la capacidad de dar un paso atrás: lo más valioso que este curso puede ofrecerte, y lo único en lo que creerás una vez que hayas visto cómo falla en tu propia pantalla.

Lo que has creado realmente

Dos patrones que puedes reutilizar en toda la galería: la construcción segura (alcance → criterios → límites de seguridad → prueba) para el trabajo que pertenece a un agente, y la parada honesta para el trabajo que no le pertenece, por muy capaz que sea la herramienta. Ambos son la misma disciplina orientada en direcciones opuestas — y de ambos debes responder tú.

¿Qué modelo elegirías primero? Y sé sincero sobre el motivo. Si es el del reclutador porque te ahorraría más tiempo, esa es precisamente la tendencia que esta lección pretende contrarrestar.

Siguiente

Puedes crear una en una herramienta pública. La última lección de este nivel plantea una pregunta más incisiva: ¿en qué ordenador se ejecuta y a qué legislación están sujetos los datos? La opción soberana.

Al marcar esta lección como completada, se guarda tu progreso en este dispositivo: sin cuenta, sin seguimiento.

Compartido libremente, de buena fe. Si te ha resultado útil, se agradece mucho una contribución de koha para sufragar los costes de desarrollo y funcionamiento.

Deja un koha →

¿Te ha resultado útil? Comparte esta lección con un compañero.