Configurar Mosce AI
Cómo conectar tu propia cuenta de un proveedor de IA (Anthropic, OpenAI o Gemini), probar la conexión, elegir el modelo y qué hacer cuando el modelo se retira o el proveedor rechaza la llave.
Mosce AI es el asistente de Mosce ERP: responde preguntas sobre los datos de tu empresa. No viene con un proveedor de IA incluido: tú conectas tu propia cuenta con Anthropic, OpenAI o Gemini, pegas su llave de API y eliges el modelo. Este artículo explica esa configuración, que se hace una sola vez por empresa. Para saber cómo se usa, consulta Preguntarle a Mosce AI.
Tiempo de lectura: ~5 min
Cuándo usar esto
- Quieres que tu equipo pueda usar Mosce AI y todavía no está configurado.
- Quieres cambiar de proveedor, pegar una llave nueva o elegir otro modelo.
- Mosce AI dejó de responder y sospechas de la llave, del saldo de tu cuenta con el proveedor o del modelo.
- Apareció un aviso de que el modelo se va a retirar.
Antes de empezar
- Necesitas el permiso
assistant:configure. Lo traen de fábrica el Propietario y el rol Administrador. Ver Usuarios, roles y permisos. - El módulo Mosce AI tiene que estar activo en tu empresa. Viene activado por defecto y está disponible en todos los planes, incluido el Gratis. Si está apagado, la pantalla de integraciones te lo dice con el aviso El módulo de Mosce AI está desactivado en tu empresa. Actívalo en Ajustes > Módulos para configurarlo. Ver Módulos.
- Una cuenta propia con uno de los tres proveedores y una llave de API creada en ella.
El uso lo paga tu empresa, a tu proveedor. Mosce ERP no cobra por el uso del asistente ni lo incluye en tu plan: cada pregunta consume lo que tu proveedor cobre por ella, en tu cuenta con él. Si esa cuenta se queda sin saldo, Mosce AI deja de responder hasta que la recargues.
Paso a paso: configurar Mosce AI
- Ve a Ajustes › Integraciones y abre la pestaña Mosce AI.
- En Proveedor de IA elige Anthropic, OpenAI o Gemini.
- En Llave de API pega la llave de tu proveedor (el campo dice Pega aquí la llave de tu proveedor). Tu llave se guarda cifrada y nunca se vuelve a mostrar completa.
- Pulsa Probar conexión. Mosce ERP comprueba la llave con tu proveedor. Si todo está bien verás Conexión correcta. Elige un modelo para guardar. y se carga la lista de modelos que tu cuenta tiene disponibles en ese momento.
- En Modelo elige uno de la lista. Mientras no elijas uno, Guardar no se activa (Elige un modelo de la lista para poder guardar.).
- Pulsa Guardar. Verás La configuración de Mosce AI se guardó.
A partir de ahí, quien tenga el permiso assistant:use ve el botón del asistente en la cabecera.
Qué recuerda la pantalla después
- Debajo del formulario queda el resultado de la última prueba: Última prueba el {fecha}: correcta. o Última prueba el {fecha}: falló., con el motivo.
- La llave guardada no se muestra. Para conservarla al cambiar solo el modelo, deja el campo vacío (Deja el campo vacío para conservar la llave guardada.).
- La llave es obligatoria la primera vez y cada vez que cambias de proveedor: una llave de un proveedor no sirve en otro.
Avisos sobre el modelo
Los proveedores retiran modelos viejos con el tiempo. Mosce ERP revisa tu modelo y te lo cuenta:
| Aviso | Qué significa | Qué hacer |
|---|---|---|
| El modelo se va a retirar | Tu proveedor anunció una fecha de retiro (El modelo {modelo} se retirará el {fecha}. Elige otro antes de esa fecha.). En la lista, ese modelo aparece como Obsoleto, se retira el {fecha}. | Elige otro modelo y guarda antes de esa fecha. |
| El modelo fue reemplazado | Solo con Anthropic: cuando un modelo se retira, Mosce ERP te cambia solo al sucesor más reciente de la misma familia ({modelo} se retiró y te cambiamos a {sucesor} el {fecha}.). Queda registrado en el registro de auditoría como Modelo del asistente reemplazado. | Nada. Si prefieres otro, elígelo y guarda. |
| El modelo ya no está disponible | Con OpenAI y Gemini Mosce ERP nunca cambia el modelo por ti: si el tuyo desaparece, hay que elegir otro. En la lista aparece como Retirado. | Elige otro modelo de la lista y guarda. |
Las personas con permiso para configurar también reciben una notificación en pantalla, con el botón Abrir ajustes.
Cuando la prueba falla
La pantalla explica la causa en palabras sencillas:
| Mensaje | Qué hacer |
|---|---|
| El proveedor no aceptó la llave. Revisa que la copiaste completa y que no ha sido revocada, o genera una nueva. | Copia la llave de nuevo desde tu cuenta con el proveedor, o crea una nueva. |
| La llave es válida, pero no tiene permiso para usar este servicio. | Revisa los permisos de la llave en tu cuenta con el proveedor. |
| La cuenta de tu proveedor no tiene saldo o llegó a su límite de gasto. | Recarga el saldo o sube el límite de gasto en el proveedor. |
| Tu cuenta con el proveedor agotó su cuota de uso. | Revisa tu plan con el proveedor o espera a que se renueve. |
| El proveedor está recibiendo demasiadas solicitudes de tu cuenta. | Espera un momento y vuelve a intentarlo. |
| El proveedor no está respondiendo en este momento. | Vuelve a intentarlo en unos minutos. |
| Ese modelo ya no está disponible en tu cuenta. | Prueba la conexión de nuevo y elige otro modelo de la lista. |
| La consulta es demasiado grande para este modelo. | Elige un modelo con más capacidad. |
Si tu proveedor rechaza la llave que ya estaba guardada (porque es inválida o la revocaste), aparece el aviso Hay que volver a configurar Mosce AI: pega una llave nueva, prueba la conexión y guarda. Mientras tanto, quienes usan el asistente ven El proveedor de IA no aceptó la llave configurada. y se les pide avisar a un administrador.
Resultado esperado
- La pestaña Mosce AI muestra la última prueba como correcta y el modelo elegido.
- El botón del asistente aparece en la cabecera de quienes tienen el permiso
assistant:use. - Un cambio de proveedor, llave o modelo vale para toda la empresa y se aplica a la siguiente pregunta que alguien haga.
Errores comunes
- No veo la pestaña Mosce AI en Integraciones. Te falta el permiso
assistant:configure, o el módulo Mosce AI está apagado en Ajustes › Módulos. - No puedo pulsar Guardar. Falta elegir un modelo, o falta pegar la llave (primera vez o cambio de proveedor). Prueba la conexión para cargar la lista de modelos.
- El equipo ve que la cuenta del proveedor no tiene saldo. El uso se cobra en tu cuenta con el proveedor: recarga el saldo o sube el límite de gasto allí, y vuelve a probar la conexión.
- Cambié de proveedor y el asistente quedó sin responder. Cada proveedor necesita su propia llave y su propio modelo: pega la llave del nuevo proveedor, prueba y guarda.
Relacionados
- Preguntarle a Mosce AI - cómo se usa, qué puede consultar y sus límites.
- Usuarios, roles y permisos - los permisos
assistant:useyassistant:configure. - Módulos - activar o apagar el módulo.
- Registro de auditoría - donde queda el cambio automático de modelo.
- Preguntas frecuentes - quién paga el uso y si se guardan las conversaciones.