Хотите использовать собственную ИИ-модель для программирования без сложной настройки? Droid упрощает эту задачу, поддерживая внешние API в своем CLI, поэтому вы можете подключить пользовательскую модель, которая подходит под ваш рабочий процесс. В этом руководстве показано, как настроить API, устранить распространенные проблемы и использовать Kimi в Droid. Продолжайте читать, чтобы начать.
Что такое Droid?
Droid — это инструмент для программирования на основе ИИ, который помогает разработчикам писать код, устранять ошибки и эффективнее справляться с задачами разработки. Он поддерживает встроенные ИИ-модели, а также позволяет пользователям подключать пользовательские модели через CLI для большей гибкости. Это делает его полезным для разных рабочих процессов программирования — будь то быстрая помощь или более персонализированная настройка.
Как использовать встроенные ИИ-модели в Droid?
Встроенные ИИ-модели позволяют легко начать программировать в Droid, поскольку сначала не нужно подключаться к какому-либо внешнему API. После установки приложения вы можете выбрать модель внутри платформы и начать использовать ИИ-помощь для анализа кода, работы над функциями, исправления ошибок и проверок. Вот как начать работу с Droid:
Шаг 1: Установите и откройте Droid
Начните с загрузки Factory App на устройство и завершения установки. После этого откройте приложение и войдите в свою учетную запись. Это даст вам доступ к Droid и его встроенным ИИ-функциям внутри приложения.
Шаг 2: Подключите Droid к папке вашего проекта
Укажите рабочую директорию с той кодовой базой, над которой вы хотите работать. Это связывает Droid с вашим локальным проектом, позволяя ему читать файлы, понимать структуру кода и поддерживать ваши задачи разработки с более точным контекстом.
Шаг 3: Выберите встроенную модель и начните вводить запросы
Откройте селектор моделей и выберите одну из встроенных ИИ-моделей, доступных в Droid. После выбора модели вы можете начать вводить запросы, например, попросить проанализировать кодовую базу, исправить ошибку, проверить код или создать новую функцию.
Как подключить Droid к внешнему API?
Подключение Droid к внешнему API дает больше свободы для работы с моделью, которую вы предпочитаете, вместо того чтобы ограничиваться встроенными вариантами. Настройка выполняется внутри Droid CLI путем добавления пользовательской модели в файл настроек, и после сохранения модель становится доступной в меню /model. В шагах ниже в качестве простого примера используется Kimi, чтобы показать, как весь процесс настройки работает — от API-ключа до выбора модели:
Шаг 1: Получите API-ключ Kimi от Moonshot AI
Начните с создания или копирования вашего Kimi API key от 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. Ваша настройка Kimi должна появиться в разделе Custom models. Выберите её из списка, чтобы сделать Kimi активной моделью для вашей сессии разработки.
Шаг 6: Запустите задачу
После выбора Kimi вы можете начать использовать её для реальной работы в Droid. Попробуйте промпт, например, для проверки кода, исправления ошибки или объяснения кодовой базы. 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"
Убедитесь, что значение provider точно соответствует
anthropic,openaiилиgeneric-chat-completion-apiПроверьте на опечатки и правильность написания заглавных букв в поле provider
Ошибки аутентификации
Убедитесь, что ваш API-ключ действителен и на нём есть доступные средства
Проверьте, что у API-ключа есть необходимые права доступа для данного провайдера
Убедитесь, что базовый URL соответствует конечной точке API из документации провайдера
Локальная модель не подключается
Убедитесь, что сервер вашей локальной модели запущен, например, командой
ollama serveПроверьте, что базовый URL указан правильно и включает
/v1/, если это требуется провайдеромУбедитесь, что модель уже загружена (pulled) или доступна локально
Ошибки ограничения скорости запросов или квот
Проверьте лимиты API-запросов и квоты использования у вашего провайдера
Отслеживайте использование в панели управления провайдера, чтобы понять, не достигнуты ли лимиты
Заключение
Использование кастомных API в Droid даёт вам больше контроля над тем, как вы создаёте, тестируете и улучшаете код с помощью ИИ. Как только настройка завершена, становится проще выстроить рабочий процесс разработки вокруг модели, которая соответствует вашим потребностям. Независимо от того, останетесь ли вы со встроенными вариантами или подключите внешнюю модель, Droid даёт вам гибкий способ внедрить ИИ в разработку. Если вы хотите начать с простой настройки, Kimi стоит попробовать в Droid. Это может стать практичным выбором, который сделает повседневную работу с кодом более гладкой и быстрой.