Python Code como herramienta de un agente

Un agente es bueno decidiendo qué hacer, pero no conviene que haga a mano cálculos o reglas que deben salir siempre igual. Dale esa parte como herramienta escrita en Python: el agente decide cuándo usarla y con qué datos, y tu código hace el cálculo.

1. Conéctalo al agente

Conecta la salida Tool de Python Code a la entrada Tools del agente. Al conectarla, la salida Processed Data se oculta.

2. Descríbelo en la pestaña Tool

Campo	Qué escribir
Tool Name	El nombre con el que el agente ve la herramienta, por ejemplo calcular_presupuesto.
Tool Description	Para qué sirve y cuándo usarla. El agente decide a partir de este texto.
Tool Input Schema	Los datos que el agente debe enviar. Pulsa Editar Esquema de Argumentos: por cada dato, su nombre, su tipo, una descripción y si es obligatorio.

3. Lee los datos en args

Los datos que envía el agente llegan en args, con los nombres que definiste. Lo que devuelvas es la respuesta que recibe el agente.

tarifa = {"taladro": 85.0, "escalera": 140.0}
precio = tarifa[args["producto"]]
unidades = int(args["unidades"])
descuento = 0.10 if unidades >= 100 else 0.0
return {"total_eur": round(unidades * precio * (1 - descuento), 2), "descuento": descuento}

Si tu código falla, el agente recibe el error en lugar del resultado y puede contárselo al usuario o volver a intentarlo.

Ejemplo

El asistente comercial de Ferretería Central calcula presupuestos con la herramienta calcular_presupuesto, que aplica la tarifa y el descuento por volumen. Sus instrucciones dicen: «Para calcular un presupuesto usa siempre la herramienta, nunca calcules tú». Cuando un cliente pregunta cuánto le costarían 120 taladros, el agente llama a la herramienta con el producto y las unidades, y responde con el total que ha calculado el código.

La misma herramienta sirve para un agente de voz o para publicarla a otros asistentes con MCP.