Хотите использовать собственную модель ИИ для программирования без сложной настройки? Droid упрощает эту задачу: CLI поддерживает внешние API, поэтому вы можете подключить пользовательскую модель под свой рабочий процесс. В этом руководстве показано, как настроить API, устранить распространённые проблемы и использовать Kimi в Droid. Читайте дальше, чтобы начать.
Что такое Droid?
Droid — инструмент программирования с ИИ, который помогает разработчикам писать код, исправлять ошибки и эффективнее выполнять задачи разработки. Он поддерживает встроенные модели ИИ, а также позволяет подключать пользовательские модели через CLI для большей гибкости. Это удобно для разных сценариев работы с кодом — когда нужна быстрая помощь или более персонализированная настройка.
Как использовать встроенные модели ИИ в Droid?
Встроенные модели ИИ позволяют сразу приступить к работе с кодом в Droid: сначала не нужно подключать внешний API. После установки приложения вы можете выбрать модель на платформе и использовать помощь ИИ для анализа кода, разработки функций, исправления ошибок и ревью. Вот как начать работу с Droid:
Шаг 1: Установите и откройте Droid
Сначала скачайте Factory App на своё устройство и завершите установку. Затем откройте приложение и войдите в учётную запись. После этого в приложении станут доступны Droid и его встроенные функции ИИ.
Шаг 2: Подключите Droid к папке проекта
Укажите в качестве рабочей директории кодовую базу, с которой хотите работать. Так Droid подключится к локальному проекту, сможет читать файлы, понимать структуру кода и эффективнее помогать с задачами разработки благодаря дополнительному контексту.
Шаг 3: Выберите встроенную модель и начните вводить prompt
Откройте селектор моделей и выберите одну из встроенных моделей ИИ, доступных в Droid. Затем можно начать отправлять prompt: попросить модель проанализировать кодовую базу, исправить ошибку, провести ревью кода или реализовать функцию.
Как подключить Droid к внешнему API?
Подключение Droid к внешнему API даёт больше свободы: можно работать с предпочитаемой моделью, не ограничиваясь встроенными вариантами. Настройка выполняется в Droid CLI — нужно добавить пользовательскую модель в файл настроек. После сохранения модель появится в меню /model. Ниже на примере Kimi показан весь процесс: от ключа API до выбора модели:
Шаг 1: Получите ключ Kimi API в Moonshot AI
Создайте или скопируйте свой ключ Kimi API в Moonshot AI. Этот ключ нужен Droid для подключения к Kimi API и отправки запросов через вашу учётную запись. Рекомендуется сохранить ключ в переменной среды, например MOONSHOT_API_KEY, чтобы безопасно использовать его в файле настроек.
Шаг 2: Откройте файл настроек Droid
Затем откройте файл настроек, в котором в Droid CLI добавляются пользовательские модели. В macOS путь к файлу: ~/.factory/settings.json. В Windows PowerShell используйте %USERPROFILE%\.factory\settings.json. Это основной файл, из которого Droid считывает конфигурацию пользовательских моделей.
Шаг 3: Добавьте Kimi как пользовательскую модель
В файле settings.json добавьте Kimi в массив customModels. Так вы укажете Droid, какую модель использовать, к какой конечной точке API обращаться, какой формат провайдера она использует и какой ключ API нужен для аутентификации. Если в файле уже есть другие настройки, не заменяйте всё содержимое — просто добавьте этот объект модели в существующий массив customModels.
Шаг 4: Сохраните файл и перезапустите Droid
После добавления конфигурации сохраните файл и перезапустите Droid CLI. Так Droid заново загрузит обновлённые настройки и корректно распознает добавленную пользовательскую модель.
Шаг 5: Выберите модель Kimi через /model в Droid
Откройте Droid CLI и выполните команду /model. В разделе Custom models должна появиться ваша конфигурация Kimi. Выберите её в списке, чтобы сделать Kimi активной моделью для текущей сессии программирования.
Шаг 6: Запустите задачу
После выбора Kimi вы можете начать использовать её для реальной работы в Droid. Попробуйте prompt с просьбой проверить код, исправить ошибку или объяснить кодовую базу. Droid отправит запрос через Kimi API и задействует эту модель для выполнения задачи.
Преимущества использования Kimi API
После подключения Kimi к Droid она становится не просто внешней моделью в CLI, а практичным помощником в программировании, который вписывается в повседневный процесс разработки и помогает как с небольшими задачами по коду, так и с более масштабными инженерными задачами. Вот некоторые преимущества использования Kimi API:
Повышайте эффективность разработки
Kimi помогает быстрее справляться с повседневными задачами программирования: генерирует код, объясняет логику и предлагает исправления прямо в процессе работы. Благодаря этому вам не нужно переключаться между несколькими инструментами для простой помощи в разработке. С Kimi в Droid рутинными задачами программирования можно управлять быстрее.
Пишите более надёжный код
Kimi может проверить ваш код, указать на возможные проблемы и помочь улучшить его структуру, прежде чем небольшие ошибки перерастут в серьёзные. Такая ранняя обратная связь полезна, если вам нужны более чистая логика и лучшая поддерживаемость. Со временем она поможет создавать код, который проще тестировать, обновлять и понимать.
Решайте разнообразные задачи разработки
Возможности Kimi не ограничиваются написанием кода с нуля. Она также помогает с рефакторингом, документированием кода, изучением незнакомых проектов и разработкой функций для разных задач. Это гибкий вариант для разработчиков, которым нужна одна ИИ-модель для помощи на многих этапах рабочего процесса.
Устранение распространённых ошибок при подключении API
Подключить внешний ключ API в Droid обычно несложно, однако небольшие ошибки при настройке всё же могут вызвать проблемы. Чаще всего они связаны с файлом настроек, именем провайдера, ключом API или конфигурацией сервера модели, а не с самим Droid. Хорошая новость в том, что такие ошибки обычно легко исправить, если знать, где искать.
Модель не отображается в списке выбора
Проверьте синтаксис JSON в
~/.factory/settings.jsonилиconfig.json, если используете устаревший форматИзменения настроек определяются автоматически благодаря отслеживанию файлов
Убедитесь, что в конфигурации пользовательской модели указаны все обязательные поля
Ошибка «Invalid provider»
Убедитесь, что значение провайдера точно соответствует
anthropic,openaiилиgeneric-chat-completion-apiПроверьте поле провайдера на опечатки и правильность регистра букв
Ошибки аутентификации
Убедитесь, что ваш ключ API действителен и на балансе есть доступные средства
Проверьте, что ключ API имеет необходимые разрешения для этого провайдера
Убедитесь, что базовый URL соответствует конечной точке API, указанной в документации провайдера
Не удаётся подключить локальную модель
Убедитесь, что сервер локальной модели запущен, например с помощью
ollama serveПроверьте, что базовый URL указан правильно и содержит
/v1/, если этого требует провайдерУбедитесь, что модель уже загружена или доступна локально
Ошибки ограничения скорости или квоты
Проверьте ограничения частоты запросов и квоты использования API у вашего провайдера
Отслеживайте использование на панели управления провайдера, чтобы понять, достигнуты ли лимиты
Заключение
Использование пользовательских API в Droid даёт больше контроля над тем, как вы создаёте, тестируете и улучшаете код с помощью ИИ. После настройки вам будет проще выстроить процесс программирования вокруг модели, которая соответствует вашим потребностям. Останетесь ли вы со встроенными вариантами или подключите внешнюю модель, Droid позволяет гибко внедрить ИИ в разработку. Если вам нужна простая отправная точка для пользовательской настройки, стоит попробовать Kimi в Droid. Это практичный вариант, который поможет сделать повседневную работу с кодом более плавной и быстрой.