Aggiungere un provider personalizzato

Usa Models.dev o Local Servers nelle Impostazioni per aggiungere un provider che non è incluso tra le voci integrate di Kora.

Aggiungere un provider

1. Apri Impostazioni.

2. Scegli un metodo e compila il modulo:

   Catalog

   Apri Models.dev e inizia a digitare il nome del provider. Seleziona un risultato, inserisci la sua chiave API e salva. Kora compila base URL, modelli e capacità dal catalogo.

   Manual

   Apri Models.dev, scegli l’azione di aggiunta manuale e inserisci nome visualizzato, base URL OpenAI-compatibile, chiave API e definizioni dei modelli.

   Local

   Apri Local Servers, scegli una configurazione predefinita o manuale e inserisci la base URL del server. Clicca Discover from server per caricare GET /v1/models, poi salva.

3. Chiudi le Impostazioni e seleziona uno dei nuovi modelli nel compositore della chat.

Capacità per-modello

Dopo aver aggiunto un provider, modifica le capacità di ogni modello in qualsiasi momento dalla vista dettaglio del provider:

Capacità	Effetto
Tools	Abilita la chiamata a funzioni/tool
Streaming	Abilita lo streaming token-per-token
Vision	Abilita l’input di immagini
Reasoning	Abilita l’output di ragionamento/thinking

Temperatura per-modello

Ogni modello può avere il proprio override di temperatura. Vedi Temperatura per modello per il range e le regole di precedenza.

Risoluzione problemi

• Il provider non compare dopo il salvataggio → ricarica il menu a tendina dei modelli; la lista viene recuperata in modo asincrono dopo il salvataggio.
• Discover from server va in errore → il server locale deve essere raggiungibile dalla tua macchina ed esporre GET /v1/models. Prova curl http://localhost:11434/v1/models per Ollama.
• API key rifiutata → alcuni provider si aspettano il prefisso Bearer, altri no. Incolla solo il token; Kora formatta l’header.
• Il provider è salvato ma non ha modelli → riapri la pagina di dettaglio e aggiungi un modello oppure aggiorna la voce models.dev.