Distribución de herramientas y tool choice: acceso acotado por rol y control de la elección

Hola otra vez, y bienvenidos y bienvenidas a la cápsula tres del Módulo dos. Recuerda que esta es mi voz, pero el audio fue generado con inteligencia artificial, bajo la supervisión del equipo de EvoAcademy.

Hoy vemos el task statement dos punto tres: distribuir herramientas entre agentes y configurar el tool choice.

Más herramientas no hacen más capaz a un agente. La guía cuenta que pasar de cuatro o cinco herramientas a dieciocho empeora la selección, porque cada decisión tiene más opciones parecidas. Además, un agente con herramientas fuera de su especialidad tiende a usarlas mal. En un sistema con un orquestador, que reparte el trabajo, y subagentes con un rol cada uno, la respuesta es el acceso acotado: cada subagente recibe solo las herramientas de su rol. Si un subagente usa mal herramientas de otro rol, entonces se restringe su conjunto. Por su parte, si necesita con mucha frecuencia algo de otro rol, entonces se le da una sola herramienta acotada para ese caso, y los casos complejos siguen pasando por el orquestador. También conviene cambiar las herramientas genéricas por restringidas: una que descarga cualquier dirección web se reemplaza por otra que solo carga documentos y valida que lo sean.

El parámetro tool choice de la API, la puerta por la que un programa le pide cosas al modelo, controla si el modelo debe llamar una herramienta. Con el valor auto, que es el predeterminado, el modelo decide si llama alguna o responde con texto. Con el valor any, tiene que llamar alguna, pero elige cuál. Y con la selección forzada, que se indica con el tipo tool y el nombre, tiene que llamar exactamente esa.

Por su parte, si una herramienta concreta tiene que correr primero, entonces se la fuerza en el primer turno, que es la primera ida y vuelta con el modelo. Cuando vuelve el resultado, los turnos siguientes pasan a auto. Pedirlo solo en el system prompt, las instrucciones fijas del modelo, funciona casi siempre, pero casi siempre no basta cuando los pasos siguientes dependen de ese resultado. Forzar convierte una preferencia en una garantía. Además, si solo importa que el modelo llame alguna herramienta y no responda con texto, entonces corresponde any.

Una pregunta. Un asistente de reservas de un restaurante debe terminar cada turno llamando alguna herramienta, nunca con charla libre, pero da igual cuál. ¿Conviene auto, any o selección forzada?

Conviene any: garantiza que el modelo llame alguna herramienta en lugar de responder con texto, sin atarlo a una sola. La selección forzada sería demasiado rígida, y auto no garantiza nada.

Dos preguntas de práctica. Pregunta uno. Una empresa de telecomunicaciones tiene un orquestador y subagentes de red, facturación y retención. Facturación necesita a menudo confirmar si el servicio de un cliente está activo, y cada vez vuelve al orquestador, lo que suma esperas. Ocho de cada diez confirmaciones son consultas simples, y las otras dos requieren investigar la red. ¿Qué solución es mejor? Opción A: crear una herramienta genérica que acepte cualquier operación sobre la red. Opción B: darle a facturación todas las herramientas de diagnóstico de red. Opción C: darle a facturación una herramienta acotada, de solo lectura, que consulte el estado del servicio, y dejar que los casos complejos sigan pasando por el orquestador. Opción D: pedir en el system prompt que facturación evite volver al orquestador.

La correcta es C. Resuelve la necesidad frecuente con una herramienta acotada, y los casos complejos conservan su camino por el orquestador. La A es lo contrario de acotar, porque una herramienta genérica permite usos que no corresponden. La B rompe la separación de roles. La D es una preferencia sin ninguna herramienta que la haga posible.

Pregunta dos, de respuesta múltiple. Elige dos. Un laboratorio clínico recibe solicitudes de exámenes en PDF. Su agente debe identificar siempre el tipo de examen antes de usar las herramientas de validación de muestras y de cálculo de tarifa, que dependen de ese dato. Hoy se lo piden en el system prompt, y a veces se lo salta. Opción A: usar any en el primer turno. Opción B: forzar la herramienta de identificación en todos los turnos. Opción C: repetir la instrucción en el system prompt, en mayúsculas. Opción D: forzar la herramienta de identificación en el primer turno. Opción E: volver a auto en los turnos siguientes, una vez devuelto el resultado. ¿Cuáles dos?

Las correctas son D y E. Forzar la identificación en el primer turno convierte la preferencia en garantía, y volver a auto después deja que el modelo siga con la validación y la tarifa. La A garantiza una llamada, pero el modelo elige cuál. La B deja al agente atrapado llamando siempre la misma herramienta. La C sigue siendo una preferencia.

Si te sirvió, sigue el podcast, dale cinco estrellas y activa las notificaciones. En la próxima cápsula vemos cómo integrar servidores MCP en Claude Code: dónde se configura cada servidor y cómo se protegen las claves de acceso. Nos escuchamos en la próxima cápsula de EvoAcademy.