Un’app di modelli o un agente ha bisogno di una chiave o di un’impostazione
Una scheda in Riff Home › Modelli mostra Needs an API key (Serve una chiave API), Key not accepted (Chiave non accettata) o Needs one setting (Serve un’impostazione), oppure una risposta, un post o una chat si ferma con un messaggio su una chiave, un’impostazione o il ragionamento.
Per chi ha un’app di modelli su un altro computer, o un agente, che non si collega o non risponde. Per LM Studio o Ollama su questo computer, vedi anche LM Studio o Ollama non si collegano.
La scheda mostra
| La scheda mostra | Cosa fare |
|---|---|
| Needs an API key (Serve una chiave API) | L’app vuole una chiave. La scheda mostra un campo: incolla la chiave e fai clic su Save key (Salva chiave). In LM Studio le chiavi sono in Developer › Server settings › API tokens. Per Hermes è API_SERVER_KEY nel .env dell’agente |
| Key not accepted (Chiave non accettata) | La chiave è sbagliata o è stata cambiata nell’app. Incolla quella giusta e fai clic su Save key (Salva chiave) |
| Needs one setting (Serve un’impostazione) | L’app o l’agente risponde ma rifiuta Riff. Vedi sotto |
| Not found (Non trovato) | Riff non raggiunge l’indirizzo. La scheda dice cosa controllare: che l’app sia avviata, in ascolto sulla rete, o che il tunnel funzioni App di modelli nella tua rete o a un indirizzo https |
Serve un’impostazione
- LM Studio: attiva l’opzione Enable CORS (Abilita CORS) del server, poi fai clic su Connect (Collega).
- Ollama: consenti Riff con
OLLAMA_ORIGINS; la scheda mostra il comando LM Studio o Ollama non si collegano. - Agente Hermes: Hermes rifiuta questa copia di Riff finché il suo ID non è consentito. Aggiungi la riga mostrata dalla scheda a
~/.hermes/.env(dopo una virgola se la riga c’è già), eseguihermes gateway restart, poi fai clic su Connect (Collega) Collega un agente Hermes. - Altra (compatibile con OpenAI): controlla la sua chiave API, e che accetti richieste dalle estensioni del browser (CORS).
Un messaggio al posto di una risposta
| Messaggio | Cosa fare |
|---|---|
| LM Studio wants an API key. Add it in Home › Models. (LM Studio vuole una chiave API. Aggiungila in Home › Modelli.) | Come Needs an API key (Serve una chiave API) sopra |
| … refused Riff. Check its API key and settings in Home › Models. (… ha rifiutato Riff. Controlla chiave API e impostazioni in Home › Modelli.) | Come Key not accepted (Chiave non accettata) o Needs one setting (Serve un’impostazione) sopra |
| … isn't answering. Is it running? (… non risponde. È avviato?) | Avvia l’app, o il tunnel, poi riprova |
| … used its whole answer on thinking and wrote nothing. (… ha usato tutta la risposta per ragionare e non ha scritto niente.) | Vedi la sezione successiva |
| Hermes refuses this copy of Riff … (Hermes rifiuta questa copia di Riff…) | Aggiungi la riga con l’ID dell’estensione che mostra, come sopra |
| Hermes can't use that session from here … (Hermes non può usare quella sessione da qui…) | La sessione è stata avviata nella CLI di Hermes o in un’app di messaggistica. Inizia una nuova chat Chatta con il tuo agente |
| Hermes is busy with other runs. (Hermes è occupato con altri lavori.) | Aspetta un momento e invia di nuovo |
“Ha usato tutta la risposta per ragionare”
Alcuni modelli (Qwen e altri) ragionano prima di rispondere, e il ragionamento può consumare tutto quello che possono scrivere. Riff chiede già risposte, post e lettura del post senza ragionamento, e la Chat riprova una volta senza. Se il messaggio arriva comunque:
- Nell’app di modelli, disattiva il ragionamento per quel modello, o scegli un modello che non ragiona prima.
- Riprova.
Se la lettura del post non riesce con Some models answer the "read the post" step with thinking or tool calls instead. (Alcuni modelli rispondono al passaggio “leggi il post” con ragionamento o chiamate a strumenti.), vale la stessa soluzione, oppure scegli un altro modello per le risposte in Modelli.
Ancora bloccato con un agente? Sotto la risposta non riuscita, Copy agent log (Copia il registro dell’agente) copia ciò che Riff e l’agente si sono detti, senza la tua chiave, da inviare con una segnalazione di bug.