Un agente de un solo ciclo con herramientas

Capítulo 20 · meta + tools + loop

La hora

• Un agent = meta + tools + loop acotado
• Cada framework son capas sobre estas tres
• Seguridad de tools + un tope duro de pasos
• La memoria es solo estado que tus tools mutan

Las tres piezas

• Meta — el system prompt: para qué sirve, cómo comportarse
• Tools — lo que puede llamar
• Loop — corre tool calls hasta que el modelo responda

Constrúyelas una vez; los frameworks dejan de ser magia.

Tools: capaces Y seguras

# whitelist operators via the AST — never eval()
_OPS = {ast.Add: operator.add, ast.Mult: operator.mul, ...}

Un agent es tan seguro como su peor tool.

El loop

for _ in range(max_steps):        # the safety rail
    response = complete(goal, history, tools)
    calls = tool_calls(response)
    if not calls: break            # no calls = the answer
    for c in calls:
        history += run_tool(c)

El tope de pasos convierte "se confundió" en "se confundió, barato".

La meta hace trabajo real

"Never do math in your head — use the tool."

Los modelos calculan con confianza y mal. Un buen diseño de agent es un buen diseño de instrucciones.

Ponlo a trabajar — tres apps

• Agente de cálculo — calculadora + conversor, encadenados
• Agente de KB — search manejado por el modelo (RAG agentic)
• Agente planeador — una lista de tareas que muta (memoria)

Mismo loop; distintas tools + meta.

Dos modos de falla

• Loops de tool-call — misma llamada repetida → el tope de pasos te salva
• Tool equivocada silenciosa — loguea cada llamada en dev

El loop hace poderosos a los agents; los logs los hacen debuggeables.

Lo que te llevas

Meta, tools, loop — escríbelas a mano y los frameworks se leen como comodidad. La confianza viene de tools seguras, un tope de pasos, forzar las tools, y loguear. Próximo: agents hablando con agents.