Configurazione dell'API di Droid: come collegare modelli di IA personalizzati

Vuoi usare il tuo modello di IA per programmare senza una configurazione complicata? Droid semplifica l'operazione supportando API esterne nella sua CLI, così puoi collegare un modello personalizzato adatto al tuo flusso di lavoro. Questa guida mostra come configurare l'API, risolvere i problemi più comuni e usare Kimi in Droid. Continua a leggere per iniziare.

Droid è uno strumento di programmazione basato sull'IA che aiuta gli sviluppatori a scrivere codice, risolvere errori e gestire le attività di sviluppo in modo più efficiente. Supporta modelli di IA integrati e consente anche agli utenti di collegare modelli personalizzati tramite la sua CLI per una maggiore flessibilità. Risulta quindi utile per diversi flussi di lavoro di programmazione, sia che serva un aiuto rapido sia una configurazione più personalizzata.

I modelli di IA integrati rendono semplice iniziare a programmare con Droid perché non è necessario collegarsi prima a un'API esterna. Dopo aver installato l'app, puoi scegliere un modello nella piattaforma e iniziare a usare l'assistenza dell'IA per l'analisi del codice, lo sviluppo di funzionalità, la correzione di bug e le revisioni. Ecco come iniziare con Droid:

Passaggio 1: installa e apri Droid

Per prima cosa, scarica Factory App sul tuo dispositivo e completa l'installazione. Quindi apri l'app e accedi al tuo account. In questo modo puoi accedere a Droid e alle sue funzionalità di IA integrate nell'app.

Passaggio 2: collega Droid alla cartella del progetto

Imposta come directory di lavoro la base di codice su cui vuoi lavorare. In questo modo Droid viene collegato al tuo progetto locale e può leggere i file, comprendere la struttura del codice e supportare le attività di sviluppo con un contesto migliore.

Passaggio 3: scegli un modello integrato e inizia a inviare prompt

Apri il selettore dei modelli e scegli uno dei modelli di IA integrati disponibili in Droid. Dopo aver selezionato il modello, puoi iniziare a inviargli prompt, ad esempio chiedendogli di analizzare la base di codice, correggere un bug, revisionare il codice o sviluppare una funzionalità.

Collegare Droid a un'API esterna ti offre più libertà di lavorare con il modello che preferisci, anziché limitarti alle opzioni integrate. La configurazione avviene nella CLI di Droid aggiungendo un modello personalizzato al file delle impostazioni e, una volta salvato, il modello diventa disponibile dal menu /model. I passaggi seguenti usano Kimi come semplice esempio, così puoi vedere come funziona l'intera configurazione, dalla chiave API alla selezione del modello:

Passaggio 1: ottieni una chiave Kimi API da Moonshot AI

Per prima cosa, crea o copia la tuachiave Kimi API da Moonshot AI. Questa chiave è necessaria perché Droid la usa per collegarsi a Kimi API e inviare richieste tramite il tuo account. È consigliabile salvare la chiave come variabile d'ambiente, ad esempio MOONSHOT_API_KEY, in modo da poterla usare in sicurezza nel file delle impostazioni.

Passaggio 2: apri il file delle impostazioni di Droid

Successivamente, apri il file delle impostazioni in cui vengono aggiunti i modelli personalizzati nella CLI di Droid. Su macOS, il percorso del file è ~/.factory/settings.json. In Windows PowerShell, usa %USERPROFILE%\.factory\settings.json. Questo è il file principale da cui Droid legge la configurazione del modello personalizzato.

Passaggio 3: aggiungi Kimi come modello personalizzato

All'interno di settings.json, aggiungi Kimi nell'array customModels. In questo modo Droid sa quale modello usare, quale endpoint API deve chiamare, quale formato di provider segue e quale chiave API usare per l'autenticazione. Se il file contiene già altre impostazioni, non sostituire tutto: aggiungi semplicemente questo oggetto modello nell'array customModels esistente.

Passaggio 4: salva il file e riavvia Droid

Dopo aver aggiunto la configurazione, salva il file e riavvia la CLI di Droid. In questo modo Droid ricarica le impostazioni aggiornate e riconosce correttamente il nuovo modello personalizzato.

Passaggio 5: seleziona il modello Kimi tramite /model in Droid

Apri Droid CLI ed esegui il comando /model. La configurazione di Kimi dovrebbe ora comparire nella sezione dei modelli personalizzati. Selezionala dall'elenco per impostare Kimi come modello attivo per la sessione di coding.

Passaggio 6: esegui un'attività

Dopo aver selezionato Kimi, puoi iniziare a usarlo per il lavoro effettivo in Droid. Prova un prompt, ad esempio per rivedere il codice, correggere un bug o spiegare una codebase. Droid invierà la richiesta tramite Kimi API e userà quel modello per l'attività.

Dopo aver collegato Kimi a Droid, diventa molto più di un semplice modello esterno nella CLI. Si trasforma in un pratico assistente di coding che si integra nel flusso di sviluppo quotidiano e aiuta sia nelle piccole attività di programmazione sia nei compiti di ingegneria più ampi. Ecco alcuni vantaggi dell'uso di Kimi API:

• Aumenta l'efficienza dello sviluppo

Kimi può aiutarti a svolgere più rapidamente le attività di coding quotidiane generando codice, spiegando la logica e suggerendo correzioni mentre lavori. In questo modo, non devi passare da uno strumento all'altro per ricevere supporto nelle attività di sviluppo più semplici. Con Kimi in Droid, il lavoro di programmazione di routine diventa più rapido da gestire.

• Scrivi codice più affidabile

Kimi può rivedere il tuo codice, segnalare possibili problemi e contribuire a migliorarne la struttura prima che piccoli errori diventino problemi più grandi. Questo tipo di feedback tempestivo è utile quando desideri una logica più pulita e una migliore manutenibilità. Nel tempo, può aiutarti a creare codice più facile da testare, aggiornare e comprendere.

• Gestisci diverse attività di sviluppo

Kimi non si limita a scrivere codice da zero. Può anche aiutare con il refactoring, la documentazione del codice, la comprensione di progetti non familiari e lo sviluppo di funzionalità in attività diverse. Questo lo rende un'opzione flessibile per gli sviluppatori che desiderano un unico modello IA per ricevere assistenza in molte fasi del flusso di lavoro.

Collegare una chiave API esterna in Droid è solitamente semplice, ma piccoli errori di configurazione possono comunque causare problemi. La maggior parte dei problemi riguarda il file delle impostazioni, il nome del provider, la chiave API o la configurazione del server del modello, piuttosto che Droid stesso. La buona notizia è che spesso questi errori sono facili da risolvere, una volta capito dove cercare.

• Controlla la sintassi JSON in ~/.factory/settings.json o in config.json se usi il formato legacy

• Le modifiche alle impostazioni vengono rilevate automaticamente tramite il monitoraggio dei file

• Verifica che nella configurazione del modello personalizzato siano presenti tutti i campi obbligatori

• Assicurati che il valore del provider sia esattamente anthropic, openai o generic-chat-completion-api

• Controlla eventuali errori di ortografia e la corretta capitalizzazione nel campo del provider

• Verifica che la chiave API sia valida e disponga di crediti disponibili

• Controlla che la chiave API disponga delle autorizzazioni corrette per il provider

• Verifica che l'URL di base corrisponda all'endpoint API indicato nella documentazione del provider

• Assicurati che il server del modello locale sia in esecuzione, ad esempio ollama serve

• Verifica che l'URL di base sia corretto e includa /v1/ se il provider lo richiede

• Controlla che il modello sia già stato scaricato o sia disponibile localmente

• Controlla i limiti di frequenza delle API e le quote di utilizzo del provider

• Monitora l'utilizzo dalla dashboard del provider per verificare se sono stati raggiunti i limiti

L'uso di API personalizzate in Droid offre maggiore controllo sul modo in cui sviluppi, testi e migliori il codice con l'IA. Una volta completata la configurazione, diventa più facile adattare il flusso di coding al modello più adatto alle tue esigenze. Che tu scelga le opzioni integrate o colleghi un modello esterno, Droid offre un modo flessibile per integrare l'IA nello sviluppo. Se cerchi un punto di partenza semplice per una configurazione personalizzata, vale la pena provare Kimi in Droid. Può essere una scelta pratica per rendere il lavoro di coding quotidiano più fluido e rapido.