Construye tu propio arnés de agente que funcione con cualquier modelo

Quiero automatizar este proceso de mi empresa: [descríbelo paso a paso, quién interviene y qué herramientas se usan hoy]. Antes de escribir código, diseña el arnés: qué herramientas necesita el agente (nombre, qué hace, parámetros y si lee o escribe), qué debe decir su prompt de sistema, qué información debe recordar entre ejecuciones, en qué puntos debe pedir confirmación humana y cuál es la condición de terminado. Recomiéndame uno de estos caminos: Proyecto de Claude, Claude Agent SDK o bucle propio con LiteLLM, y justifica la elección.

pip install claude-agent-sdk

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

opciones = ClaudeAgentOptions(
    system_prompt="Eres un asistente que ordena y resume documentos.",
    allowed_tools=["Read", "Glob"],
    disallowed_tools=["Bash"],
    max_turns=10,
)

async def main():
    async for mensaje in query(
        prompt="Resume en una tabla los archivos .md de esta carpeta.",
        options=opciones,
    ):
        print(mensaje)

anyio.run(main)

pip install litellm
export ANTHROPIC_API_KEY=tu-clave
export MODELO=anthropic/claude-sonnet-5-5

import json, os
from litellm import completion

MODELO = os.getenv("MODELO", "anthropic/claude-sonnet-5-5")
MAX_VUELTAS = 15

def leer_archivo(ruta):
    with open(ruta, encoding="utf-8") as f:
        return f.read()[:20000]

def listar_carpeta(ruta="."):
    return "\n".join(sorted(os.listdir(ruta)))

HERRAMIENTAS = {"leer_archivo": leer_archivo, "listar_carpeta": listar_carpeta}
ESQUEMAS = [
    {"type": "function", "function": {
        "name": "leer_archivo", "description": "Lee un archivo de texto",
        "parameters": {"type": "object", "properties": {"ruta": {"type": "string"}}, "required": ["ruta"]}}},
    {"type": "function", "function": {
        "name": "listar_carpeta", "description": "Lista los archivos de una carpeta",
        "parameters": {"type": "object", "properties": {"ruta": {"type": "string"}}}}},
]

mensajes = [
    {"role": "system", "content": "Analizas documentos de la carpeta actual. Al terminar, responde con el resultado final."},
    {"role": "user", "content": "Resume en una tabla los archivos .md de esta carpeta."},
]

for _ in range(MAX_VUELTAS):
    msg = completion(model=MODELO, messages=mensajes, tools=ESQUEMAS).choices[0].message
    mensajes.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for llamada in msg.tool_calls:
        try:
            args = json.loads(llamada.function.arguments or "{}")
            resultado = HERRAMIENTAS[llamada.function.name](**args)
        except Exception as error:
            resultado = f"Error: {error}"
        mensajes.append({"role": "tool", "tool_call_id": llamada.id, "content": str(resultado)})
else:
    print("Límite de vueltas alcanzado sin terminar.")

Tengo un arnés mínimo en arnes.py que usa LiteLLM. Amplíalo así: mueve las herramientas a un módulo herramientas.py con su esquema junto a cada función; añade una herramienta escribir_archivo que solo pueda escribir dentro de la carpeta ./salida y que pida confirmación por consola antes de guardar; guarda un registro de cada vuelta (herramienta, argumentos, duración) en registro.jsonl; y añade un tope de coste usando la información de uso que devuelve LiteLLM. No cambies la forma de elegir el modelo por variable de entorno.

curl -fsSL https://ollama.com/install.sh | sh
ollama run gemma4