# Instrucciones para el agente: LiteLLM: unifica llamadas a modelos y una pasarela de inferencia

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/BerriAI/litellm (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/litellm-agent-platform

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: añade la biblioteca

Comprueba que tu proyecto uv usa Python ≥3.10 y <3.16, según el [pyproject.toml oficial](https://github.com/BerriAI/litellm/blob/main/pyproject.toml). Ejecuta desde su raíz:

```shell
uv add litellm
```

### Paso 2: elige una integración

En ese mismo proyecto, carga `OPENAI_API_KEY` desde tu entorno privado con acceso al modelo del ejemplo. Guarda esta adaptación del [README](https://github.com/BerriAI/litellm#python-sdk) en `prueba.py`:

```python
from litellm import completion

response = completion(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Di hola en español."}],
)
print(response.choices[0].message.content)
```

Ejecuta desde la misma raíz:

```shell
uv run python prueba.py
```

La biblioteca lee la clave del entorno y dirige esta llamada a OpenAI. Debe imprimir el saludo; esta prueba tiene el coste de inferencia de tu cuenta. Si necesitas un servidor, sigue la ruta Proxy Server en lugar de mezclarla con la biblioteca.

## Comprobación

Haz una consulta sencilla y contrasta el proveedor y modelo que la procesaron. Prueba también un error de credenciales y verifica que tu aplicación lo maneja.

## Si algo falla

Si un modelo no acepta herramientas o parámetros, revisa su matriz de soporte. No asumas que compatibilidad de formato implica igualdad de funciones.