Une application de modèles ou un agent a besoin d’une clé ou d’un réglage
Une carte de Riff Home › Modèles indique Needs an API key (Clé d’API requise), Key not accepted (Clé refusée) ou Needs one setting (Un réglage requis), ou une réponse, un post ou un chat s’arrête avec un message sur une clé, un réglage ou la réflexion.
Pour qui a une application de modèles sur un autre ordinateur, ou un agent, qui ne se connecte pas ou ne répond pas. Pour LM Studio ou Ollama sur cet ordinateur, voir aussi LM Studio ou Ollama ne se connecte pas.
La carte indique
| La carte indique | Que faire |
|---|---|
| Needs an API key (Clé d’API requise) | L’application veut une clé. La carte affiche un champ : collez la clé et cliquez sur Save key (Enregistrer la clé). Dans LM Studio, les clés sont dans Developer › Server settings › API tokens. Pour Hermes, c’est API_SERVER_KEY dans le .env de l’agent |
| Key not accepted (Clé refusée) | La clé est fausse ou a été changée dans l’application. Collez la bonne et cliquez sur Save key (Enregistrer la clé) |
| Needs one setting (Un réglage requis) | L’application ou l’agent répond mais refuse Riff. Voir ci-dessous |
| Not found (Introuvable) | Riff n’atteint pas l’adresse. La carte dit quoi vérifier : l’application lancée, à l’écoute sur le réseau, ou le tunnel actif Applications de modèles sur votre réseau ou à une adresse https |
Un réglage requis
- LM Studio : activez l’option Enable CORS du serveur, puis cliquez sur Connect (Connecter).
- Ollama : autorisez Riff avec
OLLAMA_ORIGINS; la carte affiche la commande LM Studio ou Ollama ne se connecte pas. - Agent Hermes : Hermes refuse cette copie de Riff tant que son ID n’est pas autorisé. Ajoutez la ligne affichée par la carte à
~/.hermes/.env(après une virgule si la ligne existe déjà), lancezhermes gateway restart, puis cliquez sur Connect (Connecter) Connecter un agent Hermes. - Autre (compatible OpenAI) : vérifiez sa clé d’API, et qu’elle accepte les requêtes des extensions de navigateur (CORS).
Un message au lieu d’une réponse
| Message | Que faire |
|---|---|
| LM Studio wants an API key. Add it in Home › Models. (LM Studio veut une clé d’API. Ajoutez-la dans Home › Modèles.) | Comme Needs an API key (Clé d’API requise) ci-dessus |
| … refused Riff. Check its API key and settings in Home › Models. (… a refusé Riff. Vérifiez sa clé d’API et ses réglages dans Home › Modèles.) | Comme Key not accepted (Clé refusée) ou Needs one setting (Un réglage requis) ci-dessus |
| … isn't answering. Is it running? (… ne répond pas. Est-il lancé ?) | Lancez l’application, ou le tunnel, puis réessayez |
| … used its whole answer on thinking and wrote nothing. (… a passé toute sa réponse à réfléchir et n’a rien écrit.) | Voir la section suivante |
| Hermes refuses this copy of Riff … (Hermes refuse cette copie de Riff…) | Ajoutez la ligne de l’ID de l’extension qu’il affiche, comme ci-dessus |
| Hermes can't use that session from here … (Hermes ne peut pas utiliser cette session d’ici…) | La session a été démarrée dans la CLI de Hermes ou une messagerie. Démarrez un nouveau chat Discuter avec votre agent |
| Hermes is busy with other runs. (Hermes est occupé par d’autres tâches.) | Attendez un instant et renvoyez |
« A passé toute sa réponse à réfléchir »
Certains modèles (Qwen et d’autres) réfléchissent avant de répondre, et la réflexion peut épuiser tout ce qu’ils ont le droit d’écrire. Riff demande déjà les réponses, les posts et la lecture du post sans réflexion, et le chat réessaie une fois sans elle. Si le message revient quand même :
- Dans l’application de modèles, désactivez la réflexion pour ce modèle, ou choisissez un modèle qui ne réfléchit pas d’abord.
- Réessayez.
Si la lecture du post échoue avec Some models answer the "read the post" step with thinking or tool calls instead. (Certains modèles répondent à l’étape « lire le post » par de la réflexion ou des appels d’outils.), la même solution s’applique, ou choisissez un autre modèle pour les réponses dans Modèles.
Toujours bloqué avec un agent ? Sous la réponse en échec, Copy agent log (Copier le journal de l’agent) copie ce que Riff et l’agent se sont dit, sans votre clé, à envoyer avec un rapport de bug.