Configuration de l'API Droid : comment connecter des modèles d'IA personnalisés

Vous voulez utiliser votre propre modèle d'IA pour coder sans configuration compliquée ? Droid facilite cela en prenant en charge les API externes dans son CLI, ce qui vous permet de connecter un modèle personnalisé adapté à votre flux de travail. Ce guide vous montre comment configurer l'API, résoudre les problèmes courants et utiliser Kimi dans Droid. Continuez votre lecture pour commencer.

Qu'est-ce que Droid ?

Droid est un outil de codage IA qui aide les développeurs à écrire du code, résoudre des erreurs et gérer des tâches de développement plus efficacement. Il prend en charge des modèles d'IA intégrés et permet également aux utilisateurs de connecter des modèles personnalisés via son CLI pour plus de flexibilité. Cela le rend utile pour différents flux de travail de développement, que vous ayez besoin d'une aide rapide ou d'une configuration plus personnalisée.

Comment utiliser les modèles d'IA intégrés dans Droid ?

Les modèles d'IA intégrés facilitent le démarrage du codage avec Droid, car vous n'avez pas besoin de vous connecter à une API externe au préalable. Une fois l'application installée, vous pouvez choisir un modèle dans la plateforme et commencer à utiliser l'aide de l'IA pour l'analyse de code, le développement de fonctionnalités, la correction de bugs et les revues. Voici comment démarrer avec Droid :

Étape 1 : Installer et ouvrir Droid

Commencez par télécharger l'application Factory sur votre appareil et terminer l'installation. Ensuite, ouvrez l'application et connectez-vous à votre compte. Cela vous donne accès à Droid et à ses fonctionnalités d'IA intégrées dans l'application.

Étape 2 : Connecter Droid à votre dossier de projet

Définissez votre répertoire de travail sur la base de code sur laquelle vous souhaitez travailler. Cela relie Droid à votre projet local afin qu'il puisse lire les fichiers, comprendre la structure du code et vous aider dans vos tâches de développement avec un meilleur contexte.

Étape 3 : Choisir un modèle intégré et commencer à formuler des prompts

Ouvrez le sélecteur de modèle et choisissez l'un des modèles d'IA intégrés disponibles dans Droid. Une fois le modèle sélectionné, vous pouvez commencer à formuler des prompts, comme lui demander d'analyser la base de code, corriger un bug, revoir du code ou développer une fonctionnalité.

Comment connecter Droid à une API externe ?

Connecter Droid à une API externe vous donne plus de liberté pour travailler avec le modèle de votre choix, au lieu de rester limité aux options intégrées. La configuration se fait dans le CLI de Droid en ajoutant un modèle personnalisé au fichier de paramètres, et une fois celui-ci enregistré, le modèle devient disponible depuis le menu /model. Les étapes ci-dessous utilisent Kimi comme exemple simple, afin que vous puissiez voir comment fonctionne la configuration complète, de la clé API à la sélection du modèle :

Étape 1 : Obtenir une clé API Kimi auprès de Moonshot AI

Commencez par créer ou copier votre clé API Kimi depuis Moonshot AI. Vous aurez besoin de cette clé car Droid l'utilise pour se connecter à l'API Kimi et envoyer des requêtes via votre propre compte. Il est préférable d'enregistrer la clé en tant que variable d'environnement telle que MOONSHOT_API_KEY afin qu'elle puisse être utilisée en toute sécurité dans le fichier de paramètres.

Étape 2 : Ouvrir le fichier de paramètres de Droid

Ensuite, ouvrez le fichier de paramètres où les modèles personnalisés sont ajoutés dans Droid CLI. Sur macOS, le chemin du fichier est ~/.factory/settings.json. Sur Windows PowerShell, utilisez %USERPROFILE%\.factory\settings.json. C'est le fichier principal dans lequel Droid lit la configuration de votre modèle personnalisé.

Étape 3 : Ajouter Kimi comme modèle personnalisé

Dans settings.json, ajoutez Kimi sous le tableau customModels. Cela indique à Droid quel modèle utiliser, quel point de terminaison API appeler, quel format de fournisseur suivre et quelle clé API utiliser pour l'authentification. Si le fichier contient déjà d'autres paramètres, ne remplacez pas tout : ajoutez simplement cet objet modèle dans le tableau customModels existant.

Étape 4 : Enregistrer le fichier et redémarrer Droid

Après avoir ajouté la configuration, enregistrez le fichier et redémarrez Droid CLI. Cela permet de s'assurer que Droid recharge les paramètres mis à jour et reconnaît correctement le nouveau modèle personnalisé.

Étape 5 : Sélectionner le modèle Kimi via /model dans Droid

Ouvrez Droid CLI et exécutez la commande /model. Votre configuration Kimi devrait maintenant apparaître dans la section des modèles personnalisés. Sélectionnez-la dans la liste pour faire de Kimi le modèle actif pour votre session de codage.

Étape 6 : exécuter une tâche

Une fois Kimi sélectionné, vous pouvez commencer à l'utiliser pour du travail concret dans Droid. Essayez un prompt comme relire du code, corriger un bug ou expliquer une base de code. Droid enverra la requête via l'API Kimi et utilisera ce modèle pour la tâche.

Avantages de l'utilisation de l'API Kimi

Une fois Kimi connecté à Droid, il devient bien plus qu'un simple modèle externe dans la CLI. Il se transforme en un véritable assistant de codage qui s'intègre à votre workflow de développement quotidien et aide aussi bien pour les petites tâches de codage que pour des travaux d'ingénierie plus importants. Voici quelques avantages de l'utilisation de l'API Kimi :

• Améliorer l'efficacité du développement

Kimi peut vous aider à avancer plus rapidement dans vos tâches de codage quotidiennes en générant du code, en expliquant la logique et en suggérant des corrections pendant que vous travaillez. Vous n'avez ainsi plus besoin de basculer entre plusieurs outils pour un simple support de développement. Avec Kimi intégré dans Droid, le travail de programmation courant devient plus rapide à gérer.

• Écrire un code plus fiable

Kimi peut relire votre code, signaler d'éventuels problèmes et vous aider à en améliorer la structure avant que de petites erreurs ne se transforment en problèmes plus importants. Ce type de retour précoce est utile lorsque vous souhaitez une logique plus claire et une meilleure maintenabilité. Avec le temps, cela peut vous aider à produire un code plus facile à tester, mettre à jour et comprendre.

• Gérer des tâches de développement variées

Kimi ne se limite pas à l'écriture de code à partir de zéro. Il peut aussi aider au refactoring, à la documentation du code, à la compréhension de projets inconnus et au développement de fonctionnalités dans différents contextes. Cela en fait une option flexible pour les développeurs qui souhaitent qu'un seul modèle d'IA les assiste sur de nombreux aspects de leur workflow.

Résolution des erreurs courantes de connexion aux API

Connecter une clé API externe dans Droid est généralement simple, mais de petites erreurs de configuration peuvent tout de même poser problème. La plupart des problèmes proviennent du fichier de paramètres, du nom du fournisseur, de la clé API ou de la configuration du serveur de modèle, plutôt que de Droid lui-même. L'avantage, c'est que ces erreurs sont souvent faciles à corriger une fois qu'on sait où regarder.

Le modèle n'apparaît pas dans le sélecteur

• Vérifiez la syntaxe JSON dans ~/.factory/settings.json ou config.json si vous utilisez l'ancien format

• Les modifications des paramètres sont détectées automatiquement grâce à la surveillance des fichiers

• Vérifiez que tous les champs requis sont présents dans la configuration du modèle personnalisé

Erreur « fournisseur invalide »

• Assurez-vous que la valeur du fournisseur est exactement anthropic, openai ou generic-chat-completion-api

• Vérifiez qu'il n'y a pas de fautes d'orthographe ni d'erreurs de casse dans le champ du fournisseur

Erreurs d'authentification

• Vérifiez que votre clé API est valide et dispose de crédits disponibles

• Vérifiez que la clé API dispose des autorisations correctes pour le fournisseur

• Confirmez que l'URL de base correspond au point de terminaison de l'API indiqué dans la documentation du fournisseur

Le modèle local ne se connecte pas

• Assurez-vous que votre serveur de modèle local est en cours d'exécution, par exemple avec ollama serve

• Vérifiez que l'URL de base est correcte et inclut /v1/ si le fournisseur l'exige

• Vérifiez que le modèle a déjà été récupéré ou est disponible en local

Erreurs de limitation de débit ou de quota

• Vérifiez les limites de débit de l'API et les quotas d'utilisation de votre fournisseur

• Surveillez votre utilisation depuis le tableau de bord du fournisseur pour voir si les limites ont été atteintes

Conclusion

Utiliser des API personnalisées dans Droid vous donne plus de contrôle sur la façon dont vous construisez, testez et améliorez du code avec l'IA. Une fois la configuration en place, il devient plus facile d'adapter votre workflow de codage au modèle qui répond à vos besoins. Que vous restiez sur les options intégrées ou que vous connectiez un modèle externe, Droid vous offre un moyen flexible d'intégrer l'IA dans le développement. Si vous cherchez un point de départ simple pour une configuration personnalisée, Kimi vaut la peine d'être essayé dans Droid. Cela peut être un choix pratique pour rendre le travail de codage quotidien plus fluide et plus rapide.