🚀 Conectando modelos personalizados de CodingPlanX a Dify
Este tutorial te guiará en la integración de las API y modelos de CodingPlanX en tu plataforma Dify para aprovechar las capacidades de IA personalizadas.
📋 Requisitos previos
Antes de comenzar, asegúrate de tener:
- Acceso a Dify: Una instancia de Dify autoalojada o una cuenta de Dify Cloud.
- Clave API: Una Clave API válida de la plataforma CodingPlanX.
⚙️ Pasos de configuración
Paso 1: Acceder a la configuración del proveedor del modelo
- Inicia sesión en la consola de Dify.
- Haz clic en tu Ícono de perfil en la parte superior derecha y selecciona Settings (Configuración).
- En la barra lateral izquierda, haz clic en Model Providers (Proveedores de modelos).
Paso 2: Agregar un modelo personalizado
Dado que CodingPlanX es compatible con OpenAI, utilizamos el proveedor OpenAI-API-compatible.
- Desplázate hacia abajo en la página de Proveedores de modelos para encontrar OpenAI-API-compatible.
- Haz clic en el botón Add Model (Agregar modelo) en la tarjeta.
Paso 3: Completar los parámetros de configuración
Completa la ventana emergente exactamente de la siguiente manera:
| Parámetro | Valor / Ejemplo | Descripción |
|---|---|---|
| Model Type (Tipo de modelo) | LLM | Selecciona el tipo de modelo (Modelo de lenguaje grande). |
| Model Name (Nombre del modelo) | ej., gpt-4-turbo o claude-3-opus | Requerido. Usa el ID exacto del modelo proporcionado por CodingPlanX. |
| API Key (Clave API) | sk-xxxxxxxxxxxxxxxxxxx | Requerido. Tu Clave API de CodingPlanX. |
| API endpoint URL | https://api.codingplanx.ai/v1 | Requerido. (⚠️ Nota: Debe incluir el sufijo /v1). |
| Context Length (Longitud del contexto) | 8192 | Recuento máximo de tokens admitido por el modelo. |
| Max Token Limit (Límite máximo de tokens) | 4096 | Máximo de tokens permitidos para una sola respuesta. |
> 💡 Consejos profesionales:
> * Con respecto a la URL de la API: Aunque el dominio base es https://api.codingplanx.ai, Dify requiere la ruta completa: https://api.codingplanx.ai/v1.
> * Con respecto al nombre del modelo: Si no estás seguro del ID, consulta la documentación oficial de CodingPlanX para obtener la cadena exacta del ID del modelo.
Paso 4: Guardar y verificar
- Haz clic en Save (Guardar) después de verificar todos los detalles.
- Si tiene éxito, el modelo aparecerá en tu lista de proveedores.
🧪 Probando la configuración
- Ve al Studio de Dify y crea o abre una aplicación (por ejemplo, un Asistente de chat).
- En el área de Model Selection (Selección de modelo) en la parte superior derecha, haz clic en el menú desplegable.
- Encuentra el grupo
OpenAI-API-compatibley selecciona tu modelo de CodingPlanX. - Envía un mensaje en la ventana de depuración. Si la IA responde, ¡ya está todo listo! 🎉
❓ Resolución de problemas (Preguntas frecuentes)
P1: ¿"Connection failed" (Error de conexión) o "Invalid API Key" (Clave API no válida) durante el guardado?
- Verifica si hay espacios adicionales en la Clave API.
- Asegúrate de que la URL termine en
/v1. - Verifica que tu servidor pueda acceder a
https://api.codingplanx.ai.
P2: ¿"Model not found" (Modelo no encontrado) durante el chat?
- El Nombre del modelo ingresado no existe o no tienes acceso a él. Vuelve a revisar la ortografía (distingue entre mayúsculas y minúsculas).
P3: ¿Las respuestas se cortan?
- Comprueba si el Max Token Limit (Límite máximo de tokens) está configurado demasiado bajo. Intenta aumentarlo a 2048 o 4096.