Vuoi usare il tuo modello AI per il coding senza una configurazione complicata? Droid rende tutto più semplice supportando le API esterne nella sua CLI, così puoi collegare un modello personalizzato adatto al tuo flusso di lavoro. Questa guida ti mostra come configurare l'API, risolvere i problemi più comuni e usare Kimi in Droid. Continua a leggere per iniziare.
Cos'è Droid?
Droid è uno strumento di coding basato sull'AI che aiuta gli sviluppatori a scrivere codice, risolvere errori e gestire le attività di sviluppo in modo più efficiente. Supporta modelli AI integrati e permette anche di collegare modelli personalizzati tramite la sua CLI per maggiore flessibilità. Questo lo rende utile per diversi flussi di lavoro di coding, sia che tu abbia bisogno di un aiuto rapido sia di una configurazione più personalizzata.
Come usare i modelli AI integrati in Droid?
I modelli AI integrati rendono facile iniziare a programmare con Droid perché non è necessario collegarsi prima a nessuna API esterna. Una volta installata l'app, puoi scegliere un modello all'interno della piattaforma e iniziare a usare l'assistenza AI 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
Inizia scaricando la Factory App sul tuo dispositivo e completando l'installazione. Dopo, apri l'app e accedi al tuo account. Questo ti dà accesso a Droid e alle sue funzionalità AI integrate all'interno dell'app.
Passaggio 2: collega Droid alla cartella del tuo progetto
Imposta la directory di lavoro sul codice su cui vuoi lavorare. Questo collega Droid al tuo progetto locale così può leggere i file, capire la struttura del codice e supportare le tue attività di sviluppo con un contesto migliore.
Passaggio 3: scegli un modello integrato e inizia a inviare prompt
Apri il selettore di modelli e scegli uno dei modelli AI integrati disponibili in Droid. Una volta selezionato il modello, puoi iniziare a inviare prompt, ad esempio chiedendo di analizzare il codice, correggere un bug, revisionare il codice o creare una funzionalità.
Come collegare Droid a un'API esterna?
Collegare Droid a un'API esterna ti dà maggiore libertà di lavorare con il modello che preferisci, invece di restare limitato alle opzioni integrate. La configurazione avviene all'interno della 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 API Kimi da Moonshot AI
Inizia creando o copiando la tuachiave API Kimi da Moonshot AI. Ti servirà questa chiave perché Droid la usa per collegarsi all'API Kimi e inviare richieste tramite il tuo account. È consigliabile salvare la chiave come variabile d'ambiente, ad esempio MOONSHOT_API_KEY, così può essere usata in modo sicuro all'interno del 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. Su Windows PowerShell, usa %USERPROFILE%\.factory\settings.json. Questo è il file principale da cui Droid legge la configurazione del tuo modello personalizzato.
Passaggio 3: aggiungi Kimi come modello personalizzato
All'interno di settings.json, aggiungi Kimi nell'array customModels. Questo indica a Droid quale modello usare, quale endpoint API chiamare, quale formato di provider seguire e quale chiave API usare per l'autenticazione. Se il file contiene già altre impostazioni, non sostituire tutto: aggiungi semplicemente questo oggetto modello all'interno dell'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. Questo garantisce che Droid ricarichi le impostazioni aggiornate e riconosca correttamente il nuovo modello personalizzato aggiunto.
Passaggio 5: seleziona il modello Kimi usando /model all'interno di Droid
Apri Droid CLI ed esegui il comando /model. La tua configurazione Kimi dovrebbe ora apparire nella sezione dei modelli personalizzati. Selezionala dall'elenco per rendere Kimi il modello attivo per la tua sessione di coding.
Passo 6: Esegui un'attività
Una volta selezionato Kimi, puoi iniziare a usarlo per il lavoro vero e proprio in Droid. Prova un prompt come revisionare il codice, correggere un bug o spiegare una codebase. Droid invierà la richiesta tramite la Kimi API e userà quel modello per l'attività.
Vantaggi dell'uso della Kimi API
Dopo aver collegato Kimi a Droid, diventa molto più di un semplice modello esterno nella CLI. Si trasforma in un assistente di coding pratico che si integra nel tuo flusso di lavoro quotidiano e aiuta sia con piccoli compiti di codifica sia con attività di ingegneria più ampie. Ecco alcuni vantaggi nell'uso della Kimi API:
Aumenta l'efficienza dello sviluppo
Kimi può aiutarti a portare avanti le attività di coding quotidiane più rapidamente generando codice, spiegando la logica e suggerendo correzioni mentre lavori. Questo significa che non devi passare da uno strumento all'altro per un semplice supporto allo sviluppo. Con Kimi integrato in Droid, il lavoro di programmazione di routine diventa più veloce da gestire.
Scrivi codice più affidabile
Kimi può revisionare il tuo codice, segnalare possibili problemi e aiutare a migliorare la struttura prima che piccoli errori si trasformino in problemi più grandi. Questo tipo di feedback anticipato è utile quando vuoi una logica più pulita e una migliore manutenibilità. Nel tempo, può aiutarti a costruire 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 il supporto allo sviluppo di funzionalità in diverse attività. Questo lo rende un'opzione flessibile per gli sviluppatori che vogliono un unico modello AI per assistere in molte parti del flusso di lavoro.
Risoluzione degli errori comuni nel collegamento delle API
Collegare una chiave API esterna in Droid è di solito semplice, ma piccoli errori di configurazione possono comunque causare problemi. La maggior parte dei problemi deriva dal file delle impostazioni, dal nome del provider, dalla chiave API o dalla configurazione del server del modello, piuttosto che da Droid stesso. Il lato positivo è che questi errori sono spesso facili da risolvere una volta che sai dove guardare.
Il modello non appare nel selettore
Controlla la sintassi JSON in
~/.factory/settings.jsonoconfig.jsonse stai usando il formato legacyLe modifiche alle impostazioni vengono rilevate automaticamente tramite il monitoraggio dei file
Verifica che tutti i campi richiesti siano presenti nella configurazione del modello personalizzato
Errore "Invalid provider"
Assicurati che il valore del provider sia esattamente
anthropic,openaiogeneric-chat-completion-apiControlla eventuali errori di battitura e la corretta maiuscola/minuscola nel campo del provider
Errori di autenticazione
Verifica che la tua chiave API sia valida e abbia credito disponibile
Controlla che la chiave API abbia i permessi corretti per il provider
Conferma che l'URL di base corrisponda all'endpoint API nella documentazione del provider
Il modello locale non si connette
Assicurati che il server del modello locale sia in esecuzione, ad esempio
ollama serveVerifica che l'URL di base sia corretto e includa
/v1/se il provider lo richiedeControlla che il modello sia già stato scaricato o sia disponibile localmente
Errori di limitazione della frequenza o di quota
Controlla i limiti di frequenza delle API e le quote di utilizzo del tuo provider
Monitora il tuo utilizzo dalla dashboard del provider per verificare se sono stati raggiunti dei limiti
Conclusione
Usare API personalizzate in Droid ti dà maggiore controllo su come costruisci, testi e migliori il codice con l'AI. Una volta impostata la configurazione, diventa più facile modellare il tuo flusso di lavoro di coding attorno al modello più adatto alle tue esigenze. Che tu resti con le opzioni integrate o colleghi un modello esterno, Droid ti offre un modo flessibile per integrare l'AI nello sviluppo. Se vuoi 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 veloce.