Patrones de diseño de herramientas: síntesis del Módulo 2 y adelanto del Módulo 3

Hola otra vez, y bienvenidos y bienvenidas a la cápsula seis del Módulo dos.

Hoy hacemos la síntesis del dominio dos: los patrones de diseño de herramientas. Una herramienta es una función que el agente puede llamar, como consultar una agenda. Todo el dominio comparte una idea: el agente decide con la información que le das. Anthropic lo resume así: cuida la interfaz del agente con el mismo esmero que la de una persona.

Son seis patrones, cada uno con su condición. Si el agente confunde dos herramientas, entonces mejora primero nombres y descripciones, antes de sumar una capa de enrutamiento, es decir, un programa que clasifica cada solicitud antes. Por su parte, si una herramienta hace de todo, entonces conviene un contrato claro: un propósito, una entrada definida y una salida predecible, que devuelva solo lo relevante, porque el contexto del agente, su memoria de trabajo, es limitado.

Además, si una herramienta falla, entonces devuelve información: una categoría, una señal que indica si conviene reintentar y una descripción legible. Nunca un mensaje genérico, ni una falla disfrazada de resultado vacío. Por otro lado, si falla algo dentro de un subagente, entonces se recupera cerca y se propaga con contexto. Un orquestador reparte el trabajo y cada subagente hace una parte. Lo transitorio, como un tiempo de espera agotado, lo reintenta el subagente con un tope, y lo demás sube al orquestador con lo intentado y los resultados parciales.

Si un agente necesita herramientas, entonces rige el mínimo privilegio: recibe las de su rol, y si necesita algo de otro rol con frecuencia, una herramienta acotada. Y si el equipo comparte configuración, entonces va sin secretos: el archivo punto mcp punto json, con las claves como variables de entorno, y lo personal en la carpeta personal.

Cuando dudes entre dos opciones, elige la que da al modelo mejor información con el menor cambio. Los distractores típicos son las opciones que esconden información, o que agregan maquinaria antes de arreglar la causa.

Una pregunta. Una universidad tiene un agente de apoyo a estudiantes que confunde consultar notas con consultar asistencia, ambas con descripciones de una línea. Alguien propone un clasificador que elija la herramienta antes de cada turno. ¿Qué haces primero?

Mejoras las descripciones, con ejemplos y límites de cuándo usar cada una.

Dos preguntas de práctica. Pregunta uno. Una cadena de farmacias da a su agente de inventario una herramienta que lista todos los productos de una sucursal. Cada llamada devuelve miles de filas con códigos internos, y el contexto del agente se llena y empieza a equivocarse. ¿Qué conviene hacer? Opción A: cargar el listado completo una vez al inicio de la conversación. Opción B: pedirle al agente que lea las filas con más cuidado. Opción C: reemplazarla por una búsqueda que devuelva solo lo relevante, con nombres legibles. Opción D: agregar una capa que clasifique cada solicitud.

La correcta es C. Una búsqueda con nombres legibles cuida el contexto del agente, y es lo que Anthropic recomienda frente a un listado completo. La A sigue llenando el contexto. La B depende de que el agente se esfuerce más, y el problema es la información que recibe. La D agrega maquinaria sin arreglar la causa.

Pregunta dos, de respuesta múltiple. Elige dos. Una clínica dental tiene un agente de citas que confunde reservar cita con reprogramar cita, ambas con descripciones de una línea. Además, cuando el calendario no responde, la herramienta devuelve solo la palabra error, y el agente insiste sin parar. ¿Qué dos cambios dan más información con menos esfuerzo? Opción A: devolver errores con categoría, indicación de si conviene reintentar y descripción legible. Opción B: devolver una lista vacía cuando el calendario no responde. Opción C: agregar un clasificador que decida la herramienta antes de cada turno. Opción D: ampliar las descripciones, con ejemplos y límites de cuándo usar cada una. Opción E: darle también las herramientas de facturación y de inventario. ¿Cuáles dos?

Las correctas son A y D. La A le dice al agente qué pasó y si vale la pena reintentar. La B disfraza la falla de resultado vacío. La C agrega maquinaria antes de arreglar la causa. La D ataca la confusión en su causa, con poco cambio. La E rompe el mínimo privilegio.

Con esto cerramos el Módulo dos. Si te sirvió, sigue el podcast, dale cinco estrellas y activa las notificaciones. En el Módulo tres pasamos a la arquitectura de agentes: cómo un agente sabe cuándo seguir y cuándo parar, y cómo se reparte el trabajo entre un orquestador y sus subagentes. Nos escuchamos en la próxima cápsula de EvoAcademy.