CubeLabs

1. Introducción a Dify y su Ecosistema

Dify (langgenius/dify) nace con una visión clara: democratizar la creación de aplicaciones basadas en grandes modelos de lenguaje (LLMs). No es solo un playground de prompts: es una plataforma completa que cubre todo el ciclo de vida de una aplicación de IA.

¿Qué problema resuelve Dify?

Construir una aplicación con LLMs implica concatenar múltiples capas técnicas: elegir modelo, diseñar prompts, implementar RAG, conectar herramientas, gestionar memoria, monitorizar en producción y exponer APIs. Dify unifica todo esto en una interfaz visual que elimina la fricción entre equipos.

2. Instalación con Docker Compose

La forma más rápida de tener Dify funcionando es con Docker Compose. Los requisitos mínimos del sistema son CPU de 2 núcleos y 4 GB de RAM.

git clone https://github.com/langgenius/dify.git
cd dify/docker

cp .env.example .env

docker compose up -d

$ docker compose ps
NAME                STATUS   PORTS
dify-api            Up       5001/tcp
dify-web            Up       3000/tcp
dify-db             Up       5432/tcp
dify-redis          Up       6379/tcp
dify-nginx          Up       0.0.0.0:80->80/tcp

3. Interfaz y Workflow Visual

El corazón de Dify es su Workflow Visual Builder. Es un canvas donde arrastras y conectas nodos para construir aplicaciones complejas sin escribir código de orquestación.

Tipos de nodos disponibles

El workflow se ejecuta en dos modos: Chatflow (conversacional, con memoria) y Workflow (batch, sin estado). Puedes probar cada nodo individualmente antes de encadenarlos.

4. Integración de Modelos de IA

Dify ofrece soporte para cientos de modelos de docenas de proveedores diferentes. Puedes conectar tanto modelos propietarios (OpenAI, Anthropic, Google) como open-source (Llama 3, Mistral) alojados localmente o en la nube.

Proveedores soportados (parcial)

Para añadir un modelo, ve a Settings → Model Provider y configura las credenciales. Dify unifica todos los modelos bajo una interfaz común compatible con la API de OpenAI, facilitando el cambio entre proveedores sin modificar el código de la aplicación.

5. Prompt IDE — Diseño y Comparación

El Prompt IDE de Dify es un entorno completo para diseñar, probar y optimizar prompts. A diferencia de editar prompts en código, aquí puedes experimentar visualmente con variables, contexto y formato.

Características del Prompt IDE

• Editor con variables: usa {{variable}} para inyectar contexto dinámico
• Comparación lado a lado: prueba el mismo prompt con 2-3 modelos diferentes simultáneamente
• Historial de versiones: cada cambio queda registrado para volver atrás
• Configuración de parámetros: temperatura, top-p, max tokens, frecuencia y penalización de presencia
• Memoria conversacional: define cuántos mensajes anteriores mantener en contexto
• Text-to-speech: añade voz sintetizada a las respuestas de tu chat

Un flujo típico: diseñas un prompt en el IDE, seleccionas dos modelos (ej: GPT-4o y Claude 3.5), los ejecutas en paralelo, comparas las respuestas, y promocionas la mejor combinación a producción.

6. Pipeline RAG — Ingesta y Recuperación

El pipeline RAG (Retrieval-Augmented Generation) de Dify permite conectar tus propios documentos a las aplicaciones de IA. Es uno de los diferenciadores clave frente a soluciones puramente basadas en prompts.

Flujo completo de RAG en Dify

Dify soporta múltiples estrategias de recuperación: búsqueda por similitud, búsqueda híbrida (similitud + palabras clave) y reranking con modelos especializados.

7. Agentes con Herramientas — Function Calling y ReAct

Dify permite definir agentes autónomos que pueden planificar y ejecutar tareas utilizando herramientas. Soporta dos paradigmas principales: Function Calling (modelos que declaran funciones nativamente) y ReAct (razonamiento + acción para modelos que no soportan function calling).

Arquitectura de un agente en Dify

Usuario
  ┣┃
  ┗── Dify Agent
      ┣┃ Instrucciones del sistema
      ┣┃ Memoria conversacional
      ┣┃ Prompt de razonamiento
      ┗── Herramientas
          ┣┃ Google Search
          ┣┃ DALL·E
          ┣┃ WolframAlpha
          ┣┃ Stable Diffusion
          ┗── APIs personalizadas

Para crear un agente: selecciona Agent como tipo de aplicación, escribe las instrucciones del sistema, añade las herramientas que necesite y elige el modo de ejecución (Function Calling o ReAct).

8. 50+ Herramientas Integradas

Dify incluye más de 50 herramientas pre-construidas listas para usar. Estas herramientas se conectan a servicios externos y amplían las capacidades de tus agentes.

Herramientas destacadas por categoría

Añadir herramientas personalizadas

Además de las herramientas integradas, puedes crear herramientas personalizadas definiendo endpoints HTTP con especificación OpenAPI/Swagger. Dify las descubre automáticamente y las expone como herramientas invocables por el agente.

// Ejemplo: herramienta personalizada para tu API
POST /api/v1/tools/custom
{
  "name": "get_weather",
  "description": "Obtiene el clima actual de una ciudad",
  "parameters": {
    "city": {"type": "string", "description": "Nombre de la ciudad"}
  }
}

9. LLMOps — Monitorización y Análisis

Una vez en producción, necesitas saber cómo se comporta tu aplicación. Dify incluye capacidades de LLMOps para monitorizar, analizar y mejorar continuamente el rendimiento de tus aplicaciones.

Qué puedes monitorizar

• Logs de conversaciones: cada interacción queda registrada con inputs, outputs, tokens usados y latencia
• Análisis de rendimiento: coste por consulta, tokens por sesión, tiempo de respuesta promedio
• Anotaciones: marca respuestas como correctas/incorrectas para mejorar el dataset de fine-tuning
• Dashboard de métricas: visualización de uso por app, por modelo, por día

Integraciones de observabilidad

Dify se integra con plataformas de observabilidad externas:

• Opik (Comet) — trazabilidad completa de llamadas LLM
• Langfuse — plataforma open-source de observabilidad LLM
• Arize Phoenix — monitorización de embeddings y deriva de datos
• Grafana — dashboards personalizados usando PostgreSQL de Dify como fuente de datos

10. APIs y Despliegue a Producción

Todas las aplicaciones creadas en Dify exponen APIs REST automáticas. Esto significa que cualquier aplicación externa puede consumir tus flujos de IA sin necesidad de integración adicional.

Tipos de API

Ejemplo: llamada a API de chat

curl -X POST "https://tu-dify.app/chat-messages" \
  -H "Authorization: Bearer app-xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "¿Cuáles son las últimas tendencias en IA?",
    "user": "usuario-123",
    "conversation_id": ""
  }'

Despliegue en producción

Para entornos productivos, Dify recomienda:

• Kubernetes con Helm Charts comunitarios para alta disponibilidad
• Base de datos externa (PostgreSQL gestionado) en vez de la integrada
• Redis externo para caché y colas de trabajo
• Almacenamiento S3 para documentos y archivos subidos
• Proxy inverso (nginx, Traefik) con SSL y rate limiting