lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema intermedio pythondspyevaluacionrag

DSPy: configura y llama modelos desde Python

Conecta un modelo y define entradas y salidas desde Python. La prueba inicial comprueba una respuesta conocida; evaluar y optimizar requiere después datos y métricas propios.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.


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: instala el paquete

Comprueba que tu entorno tiene Python ≥3.10 y <3.16 y pip. Usa el comando del README:

pip install dspy

Paso 2: sigue un ejemplo oficial

Configura OPENAI_API_KEY en tu entorno privado. Guarda como prueba_dspy.py esta combinación de configuración y llamada de la guía oficial de modelos:

import dspy

lm = dspy.LM("openai/gpt-4o-mini")
dspy.configure(lm=lm)
predict = dspy.Predict("question -> answer")
print(predict(question="¿Cuánto es 1 + 52?", config={"rollout_id": 5, "temperature": 1.0}))

Desde esa carpeta, con el mismo entorno Python de la instalación, ejecuta:

python prueba_dspy.py

La respuesta esperada es 53. Esta primera prueba comprueba configuración e inferencia; antes de optimizar prepara respuestas esperadas y una métrica, siguiendo los tutoriales de DSPy.

Comprobación

Comprueba que la salida es una predicción con el campo answer y una respuesta equivalente a 53; conserva esa salida junto a prueba_dspy.py. Revisa las llamadas y el consumo del proveedor. Esto acredita solo configuración e inferencia. No existe un programa optimizado en esta receta: evaluar u optimizar queda como ampliación en los tutoriales oficiales, con datos de entrenamiento y evaluación separados, métrica y optimizador definidos antes de comparar mejoras.

Si algo falla

Si la instalación funciona pero el programa falla, revisa la configuración del modelo del tutorial elegido. Si la puntuación sube y las respuestas empeoran, inspecciona la métrica y los ejemplos.

ver en .md ¿Prefieres el recurso entero?

Qué es

DSPy es un framework de Python para construir sistemas basados en modelos de lenguaje mediante componentes programables. Su enfoque separa la lógica de la tarea de los prompts concretos que usa el modelo. Esta ficha cubre solo configurar y llamar un modelo; no ejecuta una optimización ni demuestra una mejora.

Para qué te sirve

  • Cuando cambias una clasificación y necesitas medir si mejora sobre ejemplos conocidos.
  • Cuando tu aplicación RAG tiene varios pasos y quieres optimizarlos sin mantener un prompt enorme.
  • Cuando comparas modelos y necesitas conservar una definición común de entradas y salidas.

Cómo funciona

El programa se compone de módulos con contratos de entrada y salida. Los algoritmos de optimización ajustan prompts y, en los escenarios que documenta el proyecto, pesos. La evaluación depende de una métrica y de datos representativos: instalar el paquete no produce por sí solo una mejora.

El repositorio remite a dspy.ai para los tutoriales y las APIs. Conviene elegir un ejemplo pequeño, obtener una línea base y separar los datos usados para optimizar de los usados para comprobar el resultado.

Antes de empezar

El manifiesto declara Python ≥3.10 y <3.16; necesitas pip y acceso al modelo que vaya a ejecutar el programa. El framework y el consumo de inferencia son partidas distintas; optimizar implica repetir llamadas. Prepara ejemplos cuya respuesta puedas valorar y evita usar información sensible sin revisar el proveedor elegido.

Límites y alternativas

Una métrica pobre puede premiar respuestas que no sirven al usuario. DSPy no sustituye la revisión del conjunto de evaluación. Para una transformación fija sin ambigüedad suele ser más sencillo código convencional; para una sola consulta exploratoria puede bastar un prompt directo.

Recursos

  • Repositorio y README - 38812 estrellas; licencia detectada por GitHub: MIT.
  • Licencia - Consulta sus condiciones antes de reutilizar el proyecto.