Configuración del Modelo de IA

mindzieStudio ahora ofrece una integración dramáticamente mejorada de modelos de lenguaje grande (LLM), brindándote opciones flexibles para impulsar tus copilotos y asistentes de IA. Puedes usar los modelos proxy incorporados de mindzie, conectarte a proveedores en la nube populares con tus propias claves API o desplegar modelos locales para un control completo.

Descripción General

El sistema de configuración de modelos de IA te permite:

  • Usar Modelos Proxy de mindzie: Accede a modelos rápidos y de análisis proporcionados por mindzieStudio desde el inicio
  • Traer Tus Propios Modelos: Conéctate a cualquier API compatible con OpenAI con tus propias credenciales
  • Proveedores en la Nube: Usa OpenAI, OpenRouter, Grok, Gemini y otros proveedores principales de IA
  • Despliegue Local: Implementa modelos locales usando LM Studio, Ollama o plataformas similares
  • Detección Automática: Deja que mindzieStudio detecte automáticamente las capacidades del modelo, límites de tokens y funciones
  • Múltiples Modelos: Configura todos los modelos que necesites para diferentes casos de uso

Cuándo Usar la Configuración del Modelo de IA

Configura modelos de IA cuando necesites:

  • Configurar asistentes copilot por primera vez
  • Cambiar entre diferentes proveedores de IA según costo o rendimiento
  • Desplegar modelos locales para privacidad y seguridad de datos
  • Usar modelos especializados para tareas específicas (modelos rápidos para respuestas rápidas, modelos de análisis para análisis complejos)
  • Rotar claves API para cumplimiento de seguridad
  • Probar modelos nuevos antes de hacerlos predeterminados

Requisitos Previos

Antes de configurar modelos de IA:

  • Acceso de Administrador: Debes tener acceso administrativo a la configuración de mindzieStudio
  • Claves API: Obtén claves API de tu proveedor elegido (OpenAI, OpenRouter, etc.)
  • Cuenta de Proveedor: Crea una cuenta con tu proveedor de IA si usas servicios externos
  • Configuración Local: Si usas modelos locales, instala y configura LM Studio, Ollama o software equivalente

Accediendo a la Configuración de Copilot

Navega a la configuración de copilot a través del panel de administración.

Navegación en configuración mostrando la opción Copilot de mindzie en la barra lateral izquierda

  1. Haz clic en el ícono de tu perfil en la esquina superior derecha
  2. Selecciona Configuración en el menú desplegable
  3. En la barra lateral izquierda, haz clic en mindzie Copilot

Verás la página de Configuración de mindzie Copilot con dos secciones principales:

  • Proveedores LLM: Gestiona tus proveedores de servicios de IA
  • Modelos LLM: Configura modelos específicos de tus proveedores

Página de Configuración de Copilot mostrando las secciones Proveedores LLM y Modelos LLM

Añadiendo un Proveedor de IA

Los proveedores son los servicios de IA que alojan los modelos. Puedes añadir múltiples proveedores y cambiar entre ellos.

Paso 1: Abrir el Diálogo para Añadir Proveedor

  1. Haz clic en el botón Añadir Proveedor en la sección Proveedores LLM
  2. Se abrirá el diálogo Añadir Proveedor

Diálogo Añadir Proveedor con campos para configuración del proveedor

Paso 2: Seleccionar Tipo de Proveedor

Elige en el menú desplegable Tipo de Proveedor:

  • OpenAI: API oficial de OpenAI (GPT-4, GPT-3.5, etc.)
  • OpenRouter: Acceso a múltiples modelos a través de OpenRouter
  • Grok: Modelos Grok de xAI
  • Gemini: Modelos Gemini de Google
  • LM Studio: Despliegue local usando LM Studio
  • Ollama: Despliegue local usando Ollama
  • Otro: Cualquier otra API compatible con OpenAI

Nota: Para proveedores conocidos, mindzieStudio conoce automáticamente la URL base. Para despliegues locales o proveedores personalizados, deberás proporcionar la URL base.

Paso 3: Configurar Detalles del Proveedor

Nombre del Proveedor: Ingresa un nombre descriptivo para este proveedor (por ejemplo, "OpenAI Producción", "LM Studio Local")

Clave API: Introduce tu clave API del proveedor

  • Para proveedores en la nube, obtén esta clave desde el panel de tu proveedor
  • Para despliegues locales, puede que no sea necesaria o puede quedar vacía

ID de Organización (Opcional): Algunos proveedores como OpenAI soportan IDs de organización para facturación y control de acceso

URL Base (Opcional): Para despliegues personalizados o locales

  • Ejemplo LM Studio: http://localhost:1234/v1
  • Ejemplo Ollama: http://localhost:11434/v1
  • API personalizada: El endpoint API de tu servidor

Paso 4: Establecer el Estado del Proveedor

Activo: Marca esta casilla para habilitar el proveedor

  • Desmarca para deshabilitar temporalmente sin borrar la configuración
  • Útil si quieres pausar el uso pero mantener las claves API almacenadas

Establecer como Proveedor Predeterminado: Marca para hacer este proveedor el predeterminado

  • El proveedor predeterminado se usa al agregar nuevos modelos
  • Simplifica la configuración si usas principalmente un proveedor

Paso 5: Probar la Conexión

Antes de guardar, prueba que tu proveedor esté configurado correctamente.

  1. Haz clic en el botón Probar Conexión
  2. mindzieStudio intentará conectarse al proveedor usando tus credenciales
  3. Aparecerá un mensaje de éxito o error

Diálogo Editar Proveedor mostrando resultado de prueba de conexión fallida

Nota: Si ves "Authentication failed: Invalid API key", verifica que tu clave API sea correcta y no haya expirado.

Paso 6: Guardar el Proveedor

Haz clic en Crear para guardar la configuración del proveedor.

Tu proveedor aparecerá ahora en la tabla de Proveedores LLM.

Configuración de Copilot mostrando el proveedor OpenAI en la tabla de proveedores

Administrar Proveedores Existentes

Editar un Proveedor

Para actualizar la configuración del proveedor (como rotar una clave API):

  1. Haz clic en el ícono de editar (lápiz) en la columna Acciones
  2. Se abrirá el diálogo Editar Proveedor con las configuraciones actuales
  3. Realiza tus cambios (por ejemplo, actualizar la clave API)
  4. Haz clic en Probar Conexión para verificar las nuevas credenciales
  5. Haz clic en Actualizar para guardar los cambios

Diálogo Editar Proveedor con clave API enmascarada y botón para probar conexión

Caso Común: Las claves API pueden necesitar rotación según las políticas de seguridad de tu departamento de TI. Usa la función Editar Proveedor para actualizar claves sin recrear toda la configuración.

Eliminar un Proveedor

Para eliminar un proveedor:

  1. Haz clic en el ícono de eliminar (basura) en la columna Acciones
  2. Confirma la eliminación

Advertencia: Eliminar un proveedor no eliminará los modelos asociados, pero esos modelos dejarán de funcionar sin un proveedor válido.

Añadiendo un Modelo

Una vez que has configurado al menos un proveedor, puedes agregar modelos de IA.

Paso 1: Abrir el Diálogo para Añadir Modelo

  1. Haz clic en el botón Añadir Modelo en la sección Modelos LLM
  2. Se abrirá el diálogo Añadir Modelo

Diálogo Añadir Modelo con secciones Configuración del Modelo y Pruebas y Validación

El diálogo tiene dos secciones principales:

  • Configuración del Modelo (izquierda): Configuración básica del modelo
  • Pruebas y Validación (derecha): Detección automática de capacidades

Paso 2: Seleccionar Proveedor

Elige el Proveedor del menú desplegable.

Este menú lista todos los proveedores activos que has configurado.

Paso 3: Seleccionar o Ingresar Nombre del Modelo

Tienes dos opciones para especificar el modelo:

Opción A: Seleccionar de la Lista (Recomendado)

  1. Haz clic en el botón Seleccionar Modelo junto al campo Nombre del Modelo del Proveedor
  2. Aparecerá un diálogo Seleccionar Modelo con una barra de búsqueda
  3. mindzieStudio consultará la API del proveedor para obtener modelos disponibles

Diálogo Seleccionar Modelo cargando los modelos disponibles del proveedor

  1. Una vez cargados, verás una lista de modelos disponibles

Lista Seleccionar Modelo mostrando modelos OpenAI disponibles como o4-mini, o3-pro, etc.

  1. Haz clic en un modelo para seleccionarlo (por ejemplo, gpt-5-search-api-2025-10-14)

Nota: No todos los modelos de un proveedor pueden ser adecuados para chat. Por ejemplo, OpenAI ofrece modelos de audio y de incrustaciones que no funcionarán con los copilotos de mindzieStudio. Seleccionar un modelo incompatible resultará en errores durante el uso.

Opción B: Entrada Manual

Si conoces el nombre exacto del modelo, escríbelo directamente en el campo Nombre del Modelo del Proveedor.

Ejemplos:

  • gpt-4-turbo
  • gpt-4o-mini
  • claude-3-opus-20240229

Paso 4: Configurar el Nombre para Mostrar del Modelo

Nombre para Mostrar del Modelo: Ingresa un nombre amigable que los usuarios verán

  • Ejemplo: GPT-4 Turbo (rápido, económico)
  • Este nombre aparece en la interfaz del copilot al seleccionar modelos

Paso 5: Establecer Temperatura Predeterminada

Temperatura Predeterminada: Ajusta entre 0 y 2

  • Valores bajos (0-0.3): Respuestas más deterministas y enfocadas
  • Valores medios (0.7-1.0): Equilibrio entre creatividad y consistencia
  • Valores altos (1.0-2.0): Respuestas más creativas y variadas

Predeterminado: 1 es un buen punto de inicio para la mayoría de casos

Paso 6: Detección Automática de Capacidades

mindzieStudio puede detectar automáticamente qué funciones soporta el modelo.

  1. Haz clic en el botón Autoconfigurar Capacidades en la sección Pruebas y Validación
  2. mindzieStudio se conectará al proveedor y probará el modelo

Detección automática de capacidades en progreso, mostrando estado "Detección de Capacidades..."

  1. En segundos, el sistema detectará y configurará:
    • Límites de Tokens: Máximo contexto y tokens de salida
    • Capacidades del Modelo: Funciones soportadas
    • Soporte de Temperatura: Si el parámetro temperatura está disponible
    • Mensajes del Sistema: Si el modelo soporta mensajes del sistema
    • Llamado a Herramientas: Si el modelo puede llamar herramientas externas

Diálogo de éxito mostrando modelo configurado con 128,000 tokens de contexto y 16,000 tokens de salida

  1. Haz clic en Cerrar en el diálogo de éxito
  2. Las capacidades se autocompletarán en el formulario

Diálogo Añadir Modelo con capacidades autocompletadas incluyendo límites de tokens y funciones soportadas

Información Autocompletada:

  • Máx. Tokens de Contexto: 128,000 (en este ejemplo)
  • Máx. Tokens de Salida: 16,000 (en este ejemplo)
  • Capacidades del Modelo: Mensajes de Sistema (marcado), Temperatura (no marcada en este ejemplo)

Paso 7: Sobrescritura Manual (Opcional)

Puedes editar manualmente las capacidades detectadas si es necesario.

Advertencia: Solo sobrescribe si estás seguro que la detección automática es incorrecta. Configuraciones incorrectas causarán errores al usar el modelo.

Por ejemplo:

  • Si activas incorrectamente Temperatura para un modelo que no la soporta, las llamadas API fallarán
  • Si estableces límites de tokens demasiado altos, las solicitudes pueden ser rechazadas

Paso 8: Establecer Estado del Modelo

Activo: Marca para habilitar el modelo para su uso

  • Desmarca para deshabilitar temporalmente sin borrar

Establecer como Modelo Predeterminado de Inquilino: Marca para hacer este modelo el predeterminado para todos los asistentes copilot

  • Solo un modelo puede ser el predeterminado del inquilino
  • Establecer un nuevo predeterminado también establecerá el proveedor de ese modelo como proveedor predeterminado

Paso 9: Crear el Modelo

  1. Haz clic en el botón Crear
  2. Un diálogo de Información confirmará que el modelo fue agregado exitosamente

Diálogo de Información mostrando "Modelo agregado exitosamente"

  1. Haz clic en Cerrar
  2. El modelo aparecerá ahora en la tabla Modelos LLM

Tabla actualizada Modelos LLM mostrando el modelo recién agregado en la lista

Entendiendo la Tabla de Modelos

La tabla Modelos LLM muestra:

Columna Descripción
Nombre del Modelo Nombre para mostrar configurado
Proveedor Qué proveedor aloja este modelo
Nombre del Modelo del Proveedor Identificador técnico del modelo usado por la API
Familia Familia del modelo (por ejemplo, GPT4o, GPT5) si aplica
Estado Activo o Inactivo
Predeterminado de Inquilino Muestra "DEFAULT" si es el modelo predeterminado de todo el inquilino
Acciones Editar o eliminar el modelo

Administración de Modelos

Editar un Modelo

Para modificar la configuración de un modelo:

  1. Haz clic en el ícono de editar en la columna Acciones
  2. Actualiza las configuraciones en el diálogo Editar Modelo
  3. Haz clic en Actualizar para guardar cambios

Establecer un Modelo Predeterminado Diferente

Para cambiar qué modelo se usa por defecto:

  1. Edita el modelo que quieres establecer como predeterminado
  2. Marca Establecer como Modelo Predeterminado de Inquilino
  3. Haz clic en Actualizar

El predeterminado anterior se desmarcará automáticamente.

Eliminar un Modelo

Para eliminar un modelo:

  1. Haz clic en el ícono de eliminar en la columna Acciones
  2. Confirma la eliminación

Nota: No puedes eliminar un modelo que esté configurado actualmente como predeterminado de inquilino. Primero establece otro modelo como predeterminado.

Probar Tu Configuración

Después de configurar proveedores y modelos, prueba tu configuración:

  1. Navega a una función habilitada para copilot (p. ej., Investigaciones, Compañero de IA)
  2. Abre la interfaz del copilot
  3. Verifica que tu modelo predeterminado aparezca en el selector de modelos
  4. Envía una consulta de prueba para confirmar que el modelo responde correctamente

Proveedores Soportados

Proveedores en la Nube

mindzieStudio soporta cualquier API compatible con OpenAI, incluyendo:

  • OpenAI: GPT-4, GPT-4 Turbo, GPT-3.5, GPT-5 (cuando esté disponible)
  • OpenRouter: Acceso multi-proveedor a cientos de modelos
  • Anthropic Claude (via OpenRouter o proxy compatible)
  • Grok (xAI)
  • Google Gemini (via API compatible)
  • Azure OpenAI Service
  • APIs Personalizadas: Cualquier servicio que implemente la especificación API de OpenAI

Soluciones Locales (On-Premise)

Para privacidad y seguridad de datos, puedes desplegar modelos localmente:

  • LM Studio: Despliegue local fácil de usar de modelos
  • Ollama: Servicio local ligero de modelos
  • vLLM: Servidor de inferencia de alto rendimiento
  • Text Generation Inference: Servidor de inferencia de Hugging Face
  • LocalAI: Inferencia local compatible con OpenAI

Requisitos para Despliegue Local:

  1. Instala el software local de inferencia elegido
  2. Descarga y carga tu modelo preferido
  3. Inicia el servidor local (típicamente en localhost:1234 o localhost:11434)
  4. En mindzieStudio, añade un proveedor con la URL base local
  5. Añade modelos usando el proveedor local

Buenas Prácticas

Seguridad de Claves API

  • Rota las Claves Regularmente: Cambia las claves API periódicamente según tus políticas de seguridad
  • Usa IDs de Organización: Cuando estén disponibles, para controlar uso y costos
  • Limita Permisos de las Claves: Usa claves API con permisos mínimos necesarios
  • No Compartas Claves: Cada usuario o equipo debe tener sus propias credenciales API

Selección de Modelos

  • Modelos Rápidos para Tiempo Real: Usa modelos como gpt-4o-mini para respuestas rápidas de copilots
  • Modelos de Análisis para Pensar: Usa modelos más grandes como gpt-5-search-api para tareas complejas de análisis
  • Prueba Antes de Predeterminar: Testea cuidadosamente modelos nuevos antes de establecerlos como predeterminados
  • Monitorea Costos: Controla uso y costos por modelo, especialmente modelos costosos

Gestión de Proveedores

  • Mantén Proveedores Activos: Solo deshabilita proveedores cuando sea necesario para evitar confusión
  • Nombres Descriptivos: Usa nombres claros como "OpenAI Producción" o "LM Studio Local Dev"
  • Prueba Conexiones: Siempre prueba conexiones tras añadir o editar proveedores
  • Múltiples Proveedores: Configura proveedores de respaldo por si el principal falla

Configuración de Capacidades

  • Confía en la Auto-Detección: Usa la configuración automática siempre que sea posible
  • No Adivines: Si la detección falla, consulta la documentación del modelo
  • Verifica Límites de Tokens: Límites incorrectos pueden causar truncamiento inesperado o errores
  • Actualiza Regularmente: Las capacidades pueden cambiar con actualizaciones de API

Solución de Problemas

Fallo en Prueba de Conexión

Si la prueba de conexión a un proveedor falla:

  1. Verifica la Clave API: Copia la clave directamente del panel del proveedor
  2. Revisa la URL Base: Asegúrate que la URL base es correcta e incluye protocolo (http:// o https://)
  3. Acceso a Red: Confirma que tu red permite conexiones al proveedor
  4. Estado del Proveedor: Revisa si la API del proveedor está caída
  5. ID de Organización: Remueve el ID de organización si no es necesario

Modelo No Aparece en Copilot

Si un modelo no aparece al usar copilots:

  1. Verifica Estado Activo: Asegura que tanto proveedor como modelo estén activos
  2. Confirma Proveedor: Verifica que el proveedor del modelo esté activo
  3. Recarga Interfaz: Actualiza la interfaz copilot
  4. Revisa Permisos: Asegúrate que tienes acceso a funcionalidades de IA

Fallo en Auto-Detección

Si la autoconfiguración de capacidades no funciona:

  1. Prueba el Proveedor Primero: Asegura que la conexión al proveedor es válida
  2. Revisa el Nombre del Modelo: Verifica que el nombre sea correcto
  3. Permisos API: Algunas APIs requieren permisos especiales para consultas de capacidades
  4. Configuración Manual: Como último recurso, configura capacidades manualmente consultando la documentación del modelo

Errores del Modelo Durante Uso

Si un modelo retorna errores al usarse:

  1. Revisa Capacidades: Asegura que las capacidades coincidan con lo que el modelo soporta realmente
  2. Verifica Límites de Tokens: Que el máximo contexto y tokens de salida no estén muy altos
  3. Ajuste de Temperatura: Algunos modelos no soportan temperatura — desactívala si es necesario
  4. Cuota API: Verifica si has excedido los límites o cuotas del proveedor

Configuraciones de Ejemplo

Ejemplo 1: OpenAI con Múltiples Modelos

Configuración del Proveedor:

  • Tipo: OpenAI
  • Nombre: "OpenAI Producción"
  • Clave API: sk-... (tu clave real)
  • Activo: Sí
  • Proveedor Predeterminado: Sí

Modelos:

  1. Modelo Rápido para Respuestas Ágiles

    • Nombre Modelo: "GPT-4o Mini (Rápido y Económico)"
    • Nombre Modelo Proveedor: gpt-4o-mini
    • Temperatura Predeterminada: 0.7
    • Predeterminado de Inquilino: Sí

  2. Modelo de Análisis para Tareas Complejas

    • Nombre Modelo: "GPT-5 Search API (Avanzado)"
    • Nombre Modelo Proveedor: gpt-5-search-api-2025-10-14
    • Temperatura Predeterminada: 1.0
    • Predeterminado de Inquilino: No

Ejemplo 2: Despliegue Local con LM Studio

Configuración del Proveedor:

  • Tipo: LM Studio
  • Nombre: "LM Studio Local"
  • Clave API: (dejar vacío o usar valor ficticio)
  • URL Base: http://localhost:1234/v1
  • Activo: Sí
  • Proveedor Predeterminado: Sí

Modelo:

  • Nombre Modelo: "Llama 3.1 70B (Local)"
  • Nombre Modelo Proveedor: llama-3.1-70b-instruct
  • Temperatura Predeterminada: 0.8
  • Predeterminado de Inquilino: Sí

Ejemplo 3: Mixto Nube y Local

Usa múltiples proveedores para flexibilidad:

Proveedores:

  1. OpenAI (nube) - para cargas de producción
  2. LM Studio (local) - para desarrollo y datos sensibles

Modelos:

  • Predeterminado: OpenAI GPT-4o Mini (producción)
  • Secundario: Llama 3.1 Local (desarrollo/pruebas)

Documentación Relacionada

Soporte

Si tienes problemas configurando modelos de IA:

  • Correo Electrónico: support@mindzie.com
  • Documentación: Consulta la documentación API de tu proveedor IA para nombres y capacidades de modelos
  • Pruebas: Siempre prueba conexiones a proveedores y respuestas de modelos antes de establecer por defecto