Saltar al contenido
ES
Añadir a Chrome

Una app de modelos o un agente necesita una clave o un ajuste

SoluciónNuevo
Síntoma

Una tarjeta de Riff Home › Modelos dice Needs an API key (Falta una clave de API), Key not accepted (Clave no aceptada) o Needs one setting (Falta un ajuste), o una respuesta, una publicación o un chat se detiene con un mensaje sobre una clave, un ajuste o el razonamiento.

Para quien tiene una app de modelos en otro equipo, o un agente, que no se conecta o no responde. Para LM Studio u Ollama en este equipo, consulta también LM Studio u Ollama no se conecta.

Falta una clave de API: pégala en la tarjeta, Guardar clave y se conecta.

La tarjeta dice

La tarjeta diceQué hacer
Needs an API key (Falta una clave de API)La app quiere una clave. La tarjeta muestra un cuadro: pega la clave y haz clic en Save key (Guardar clave). En LM Studio, las claves están en Developer › Server settings › API tokens. Para Hermes es API_SERVER_KEY en el .env del agente
Key not accepted (Clave no aceptada)La clave es incorrecta o se cambió en la app. Pega la correcta y haz clic en Save key (Guardar clave)
Needs one setting (Falta un ajuste)La app o el agente responde, pero rechaza a Riff. Más abajo
Not found (No encontrado)Riff no llega a la dirección. La tarjeta dice qué comprobar: que la app esté en marcha, que escuche en la red o que el túnel funcione Apps de modelos en tu red o en una dirección https

Falta un ajuste

  • LM Studio: activa la opción Enable CORS del servidor y haz clic en Connect (Conectar).
  • Ollama: permite Riff con OLLAMA_ORIGINS; la tarjeta muestra el comando LM Studio u Ollama no se conecta.
  • Agente Hermes: Hermes rechaza esta copia de Riff hasta que se permita su ID. Añade la línea que muestra la tarjeta a ~/.hermes/.env (después de una coma si la línea ya existe), ejecuta hermes gateway restart y haz clic en Connect (Conectar) Conecta un agente Hermes.
  • Otra (compatible con OpenAI): revisa su clave de API, y que acepte peticiones de extensiones del navegador (CORS).

Un mensaje en lugar de una respuesta

MensajeQué hacer
LM Studio wants an API key. Add it in Home › Models. (LM Studio quiere una clave de API. Añádela en Home › Modelos.)Como Needs an API key (Falta una clave de API), arriba
… refused Riff. Check its API key and settings in Home › Models. (… rechazó a Riff. Revisa su clave de API y sus ajustes en Home › Modelos.)Como Key not accepted (Clave no aceptada) o Needs one setting (Falta un ajuste), arriba
… isn't answering. Is it running? (… no responde. ¿Está en marcha?)Inicia la app, o el túnel, y vuelve a intentarlo
… used its whole answer on thinking and wrote nothing. (… gastó toda su respuesta en razonar y no escribió nada.)Consulta la sección siguiente
Hermes refuses this copy of Riff … (Hermes rechaza esta copia de Riff…)Añade la línea del ID de la extensión que muestra, como arriba
Hermes can't use that session from here … (Hermes no puede usar esa sesión desde aquí…)La sesión empezó en la CLI de Hermes o en una app de mensajería. Empieza un chat nuevo Chatea con tu agente
Hermes is busy with other runs. (Hermes está ocupado con otras tareas.)Espera un momento y vuelve a enviarlo

«Gastó toda su respuesta en razonar»

Algunos modelos (Qwen y otros) razonan antes de responder, y el razonamiento puede consumir todo lo que se les permite escribir. Riff ya pide sin razonamiento las respuestas, las publicaciones y la lectura de la publicación, y el chat lo intenta una vez más sin él. Si el mensaje sigue apareciendo:

  1. En la app de modelos, desactiva el razonamiento para ese modelo, o elige un modelo que no razone primero.
  2. Vuelve a intentarlo.

Si la lectura de la publicación falla con Some models answer the "read the post" step with thinking or tool calls instead. (Algunos modelos responden al paso de «leer la publicación» con razonamiento o llamadas a herramientas.), sirve la misma solución, o elige otro modelo para las respuestas en Modelos.

¿Sigues atascado con un agente? Bajo la respuesta fallida, Copy agent log (Copiar el registro del agente) copia lo que Riff y el agente se dijeron, sin tu clave, para enviarlo con un informe de errores.