Manual del Asistente IA
Configurá los asistentes de ProfeOS vos solo, sin preguntar.
¿Qué es el Asistente IA?
El Asistente IA de ProfeOS te ayuda a estructurar planificaciones, refinar tablas importadas, leer fotos de planillas, escribir informes, generar preguntas de evaluación y más. La IA solo interpreta documentos y propone: nunca decide por vos. Si no hay IA configurada, ProfeOS sigue funcionando igual con los métodos tradicionales.
Para activarlo solo necesitás una clave gratis de OpenRouter (2 minutos). Con esa única clave, ProfeOS resuelve el modelo concreto para cada tarea según el perfil que elijas. Después, en la Configuración avanzada, podés ajustar los modelos por área y sumar una clave directa de Gemini como respaldo.
Los 4 modos del Asistente
En Ajustes → Asistente IA elegís cuánto invertir. Los tres primeros perfiles usan modelos gratis de OpenRouter: funcionan sin créditos y sin tarjeta.
Automáticogratis
Modelos gratis de OpenRouter, sin créditos en tu cuenta. Recomendado para la mayoría.
Económicogratis
Modelos gratis y livianos. El menor consumo posible. Ideal si importás mucho contenido.
Equilibradogratis
Modelos gratis con mejor calidad. Ideal para planificar y redactar.
Máxima calidadcon saldo
La mejor calidad disponible (Claude, GPT-4o y Gemini Pro). Requiere créditos de OpenRouter. Un poco más lento y más caro.
En resumen: sin cargar saldo podés usar Automático, Económico y Equilibrado. Solo cargá créditos en OpenRouter si querés el perfil Máxima calidad.
¿Qué es OpenRouter y por qué es gratis?
OpenRouter es un puente hacia decenas de modelos de IA (Gemini, Claude, GPT, DeepSeek, Llama y más) con una sola clave. En vez de crearte una cuenta en cada empresa, una clave de OpenRouter te da acceso a todos.
Algunos de esos modelos tienen una versión marcada con
:free, que funciona sin créditos y sin
tarjeta. ProfeOS usa justamente esos modelos gratuitos en los perfiles
Automático, Económico y Equilibrado. Los modelos de pago (los que OpenRouter cobra
por uso) solo se usan en el perfil Máxima calidad, y para eso sí
necesitás saldo en tu cuenta.
Dato: ProfeOS nunca te cobra nada por la IA. La clave es tuya y va a OpenRouter directamente; la app solo la usa para llamar a los modelos.
Configuración paso a paso
- Entrá a openrouter.ai y creá tu cuenta (es gratis). Podés usar tu cuenta de Google.
- Andá a Keys (openrouter.ai/keys) y tocá "Create Key".
- Copiá la clave (empieza con
sk-or-v1-…). OpenRouter solo la muestra una vez al crearla: pegala en un gestor de contraseñas o notas privadas. - En ProfeOS abrí Ajustes → Asistente IA y pegala en el campo "Clave de OpenRouter".
- Tocá Guardar clave y después Probar clave para confirmar que es válida.
Importante: OpenRouter muestra la clave una sola vez, al crearla. ProfeOS no puede recuperarla y no se vuelve a ver en pantalla. Si la perdés, generá una nueva en openrouter.ai/keys y guardala de nuevo en la app.
Cuando veas la tarjeta "Clave de OpenRouter configurada" en verde, el Asistente ya está listo.
Elegir modelos por área
De forma predeterminada no tenés que hacer nada: ProfeOS elige el modelo de cada tarea según el perfil. Pero si querés control total, activá la Configuración avanzada y luego el interruptor "Elegir modelos por tarea". Ahí aparece un cuadro de texto por área.
Qué poner en cada cuadro
En cada cuadro se escribe el identificador del modelo en formato
proveedor/modelo, como aparece en OpenRouter. Por
ejemplo:
openai/gpt-oss-20b:free
google/gemma-4-31b-it:free
anthropic/claude-sonnet-4.5
- Si el modelo es gratis, lleva el sufijo
:freeal final. - Si dejás el cuadro vacío, se usa el modelo por defecto del perfil elegido.
- El texto gris dentro de cada cuadro (hint) te muestra qué modelo usa hoy ese perfil para esa tarea.
- El botón reiniciar que aparece a la derecha del cuadro vuelve al modelo del perfil.
Podés escribir cualquier modelo de OpenRouter, incluso de pago, y en cualquier perfil. Si escribís un identificador inválido, la tarea fallará: revisá que el nombre exista en openrouter.ai/models.
Las áreas que podés configurar
| Área | Para qué se usa |
|---|---|
| Planificaciones | Estructurar y redactar planificaciones didácticas. |
| Refinar tablas | Corregir y ordenar tablas importadas o pegadas. |
| Notas | Ayudar a redactar y completar observaciones y notas. |
| Lectura de fotos | Reconocer texto en fotos de planillas y documentos (OCR). |
| Resumir | Resumir textos largos en versiones cortas. |
| Informes | Redactar informes de estudiantes y del curso. |
| Comunicaciones | Escribir comunicados y mensajes para las familias. |
| Planes de clase | Generar planes de clase a partir de tus datos. |
| Preguntas de evaluación | Crear preguntas y consignas de evaluación. |
| Análisis de asistencia | Analizar los registros de asistencia y detectar tendencias. |
Consejo: en Automático y Equilibrado, "Informes" y "Análisis de asistencia" ya usan modelos distintos y optimizados. Salvo que quieras algo puntual, lo mejor es dejar todo en blanco y elegir solo el perfil.
La clave de Gemini (opcional)
En la Configuración avanzada también hay un campo para una clave directa de Gemini, pensado para quien ya tiene una cuenta de Google. Se usa como respaldo: si OpenRouter no responde, ProfeOS intenta con Gemini automáticamente.
- Es opcional. Con solo la clave de OpenRouter ya funciona todo.
- Sirven solo las claves
AIzaSy…de Google Cloud. - Las claves
AQ.nuevas de AI Studio no funcionan con la conexión directa de ProfeOS. - El nivel gratis de Gemini incluye cuota para su modelo
gemini-2.5-flash, sin tarjeta.
Para obtener una clave de Google Cloud: entrá a Google Cloud Console → API y servicios → Credenciales → Crear credenciales → Clave de API, y habilitá la API de Gemini en el mismo proyecto.
Consejos y solución de problemas
- Las claves se guardan cifradas en tu dispositivo. Nunca se sincronizan a la nube ni se muestran completas en pantalla.
- Sin claves configuradas, ProfeOS funciona igual con los métodos tradicionales. La IA es un extra, no una obligación.
- Si una tarea falla, tocá Probar clave para verificar que tu clave siga vigente (las claves de OpenRouter caducan al regenerarse o eliminarse).
- Los modelos
:freepueden estar saturados en horarios pico: esperá un minuto y reintentá. - Al cambiar de perfil, los cuadros de la configuración avanzada que dejes vacíos se adaptan automáticamente.
- Revisá el modelo exacto en openrouter.ai/models antes de escribirlo: los nombres cambian con el tiempo.