Asistente, conocimientos y vídeos¶

Estas funciones son opcionales. La IA usa tus propias claves, y el proveedor factura cada uso en tu cuenta (salvo con un modelo local, que es gratuito). Los conocimientos que lee el asistente se obtienen sin IA.

Pestaña de ajustes	Para qué sirve	Usa la IA
Asistente	El asistente de juego, la IA que lo hace funcionar y lo que esta IA también puede redactar bajo petición	Sí
Conocimientos	Las páginas de Wikipedia y StrategyWiki de cada juego, que lee el asistente	No
Vídeos	Los tráilers de YouTube	No

Asistente de juego¶

La burbuja Asistente, abajo a la derecha de cada página, responde a tus preguntas:

Biblioteca: encontrar un juego entre los tuyos, comparar dos, preguntar cómo usar la aplicación («¿Un juego para dos en mi biblioteca?», «¿Cómo añado juegos?»);
Un juego: cuando la ficha de un juego está abierta o hay un juego en marcha, propone hablar de ese juego («Estás viendo … ¿Hablamos de este juego?»): controles, objetivos, una parte difícil, un secreto. Para «Estoy atascado, ¿una pista?», primero da una pista y, si la pides, Dame la solución completa.

Responde con la IA configurada en Ajustes → Asistente, la ficha del juego y los conocimientos obtenidos para el juego, y cita sus fuentes. Solo habla de tus juegos y de ROMKADE Manager, nunca ayuda a encontrar juegos, ROM o BIOS para descargar, y se detiene tras 20 preguntas por conversación (Borrar la conversación para empezar de nuevo). Cada respuesta va marcada como «IA, puede equivocarse», con el servicio usado («modelo local: nada sale de este ordenador»).

IA del asistente¶

Ajustes → Asistente → IA del asistente configura la IA. Un indicador muestra el estado: Conectada (verde), aún no conectada, o no se puede conectar, con lo que hay que corregir. La conexión se comprueba automáticamente; Comprobar vuelve a lanzar la comprobación y Desconectar quita la IA.

La misma IA también redacta, solo bajo petición:

las descripciones de los juegos, más abajo en la misma pestaña;
los controles de los juegos, con Preguntar a la IA en la ficha de un juego.

Servicio en línea, con una clave de API¶

¿Aún no tienes clave? Crear una clave de API explica, servicio por servicio, cómo obtenerla.

Servicio	Notas
Claude (Anthropic)	Las descripciones van por lotes, a mitad de precio, con el coste estimado mostrado antes de empezar
ChatGPT (OpenAI), Mistral AI, Gemini (Google)	Se factura por uso

Elige Servicio en línea, con una clave de API y, después, el servicio.
Pega tu clave de API (Crear una clave de … enlaza con la página del proveedor). El modelo se propone y la conexión se comprueba automáticamente; Cambiar elige otro modelo de la lista que devuelve el proveedor.

Las claves se guardan en el llavero del sistema (instalación desde el código fuente) o en el volumen de datos (Docker): consulta Datos y privacidad. Desde el código fuente, si no hay ninguna clave guardada, ROMKADE Manager usa la variable de entorno del proveedor si existe (ANTHROPIC_API_KEY, OPENAI_API_KEY, MISTRAL_API_KEY, GEMINI_API_KEY).

Modelo local o servicio compatible con OpenAI¶

¿Primera vez? Instalar una IA local lo explica todo, paso a paso, en Mac, Windows y Linux.

Un modelo de pesos abiertos en tu ordenador o en tu red, con Ollama o LM Studio: gratis y privado, pero más lento y algo menos preciso que un gran modelo en línea.

Instala Ollama o LM Studio e inicia su servidor. Descarga un modelo que maneje bien el francés y el español, por ejemplo:
```
ollama pull qwen2.5:7b
```

En Ajustes → Asistente, elige Modelo local o servicio compatible con OpenAI y, después, la dirección del servicio:

ROMKADE Manager se ejecuta…	Ollama	LM Studio
con Docker	`http://host.docker.internal:11434/v1`	`http://host.docker.internal:1234/v1`
desde el código fuente	`http://localhost:11434/v1`	`http://localhost:1234/v1`

Elige el modelo en la lista.

Docker en Linux

El compose.yaml proporcionado declara host.docker.internal, pero Ollama solo escucha por defecto en el propio ordenador. Haz que escuche también a los contenedores y reinícialo:

sudo systemctl edit ollama      # add:  [Service]  Environment="OLLAMA_HOST=0.0.0.0:11434"
sudo systemctl restart ollama

Cualquier otro servicio que hable el protocolo de OpenAI también funciona: indica su dirección (normalmente terminada en /v1) y, si la pide, su clave de API en ¿El servicio pide una clave de API?. Si el modelo responde, pero no en el formato esperado, prueba un modelo más grande.

Descripciones de los juegos, redactadas por la IA¶

Al final de Ajustes → Asistente, la IA redacta una descripción de cada juego en los tres idiomas: traduce los resúmenes conocidos y redacta los demás. Para un juego que apenas conoce, solo escribe lo que es seguro. Los textos aparecen marcados como «por IA» en la ficha del juego.

Con Claude, las descripciones van por lotes (a mitad de precio); el coste estimado aparece en el botón. Los resultados suelen llegar en menos de una hora.
Con otro proveedor o un modelo local, los juegos se describen uno a uno en segundo plano. El proceso se detiene tras 5 fallos seguidos y se puede reanudar; los juegos ya descritos se conservan.

Mientras tanto puedes seguir usando la aplicación; la página se actualiza sola.

Controles de los juegos¶

En la ficha de un juego, Controles muestra qué botón de la consola hace qué. Preguntar a la IA rellena la lista en los tres idiomas, usando la correspondencia por defecto entre el mando original y los botones de la consola. Corregir o Escribirlos yo la sustituye por tu propio texto. Las respuestas se guardan y las comparten las ediciones del mismo juego.

Conocimientos¶

Ajustes → Conocimientos obtiene, para cada juego, su página de Wikipedia (inglés, francés, español) y su guía de StrategyWiki cuando existen. No interviene ninguna IA: el juego se identifica con Wikidata (título y consola), las páginas se dividen en pasajes y se indexan en el motor de búsqueda. El asistente lee estos pasajes para responder, y los cita.

Obtener para los N juegos restantes se ejecuta en segundo plano, una petición a la vez; Detener lo pausa.
Obtener automáticamente para los juegos nuevos tras cada sincronización mantiene los conocimientos al día.
Un solo juego: elige un juego y, después, Obtener. Guarda de verdad sus páginas, como el lote completo: no es una simple prueba. Ver los pasajes encontrados solo lee: muestra lo que recibiría el asistente para una pregunta de prueba.

Fuentes: Wikipedia y StrategyWiki (CC BY-SA 4.0), citadas en las respuestas del asistente.

Tráilers de YouTube¶

Ajustes → Vídeos configura la clave de API de YouTube que usa ▶ en las carátulas.

En la consola de Google Cloud, crea un proyecto y activa YouTube Data API v3.
Crea una clave de API en Credenciales (suele empezar por AIza).
Pégala en Clave de API de YouTube y guarda.

La cuota gratuita permite unas 100 búsquedas nuevas al día. Un tráiler se busca con el primer clic y después se guarda en caché. Sin clave, ▶ abre la búsqueda en youtube.com.