Configuração da API no Droid: como conectar modelos de IA personalizados

Quer usar seu próprio modelo de IA para programar sem uma configuração complicada? O Droid facilita isso ao oferecer suporte a APIs externas na CLI, permitindo conectar um modelo personalizado adequado ao seu fluxo de trabalho. Este guia mostra como configurar a API, resolver problemas comuns e usar o Kimi no Droid. Continue lendo para começar.

O Droid é uma ferramenta de programação com IA que ajuda desenvolvedores a escrever código, resolver erros e lidar com tarefas de desenvolvimento com mais eficiência. Ele oferece suporte a modelos de IA integrados e também permite conectar modelos personalizados pela CLI para maior flexibilidade. Isso o torna útil para diferentes fluxos de trabalho de programação, seja para obter ajuda rápida ou para uma configuração mais personalizada.

Os modelos de IA integrados facilitam começar a programar com o Droid, pois não é necessário conectar nenhuma API externa antes. Depois de instalar o aplicativo, você pode escolher um modelo na plataforma e começar a usar a ajuda da IA para analisar código, desenvolver recursos, corrigir bugs e fazer revisões. Veja como começar a usar o Droid:

Etapa 1: instale e abra o Droid

Comece baixando o Factory App no seu dispositivo e conclua a instalação. Em seguida, abra o aplicativo e entre na sua conta. Assim, você terá acesso ao Droid e aos recursos de IA integrados no aplicativo.

Etapa 2: conecte o Droid à pasta do projeto

Defina o diretório de trabalho como a base de código em que você quer trabalhar. Isso vincula o Droid ao seu projeto local para que ele possa ler os arquivos, entender a estrutura do código e ajudar nas tarefas de desenvolvimento com mais contexto.

Etapa 3: escolha um modelo integrado e comece a usar prompts

Abra o seletor de modelos e escolha um dos modelos de IA integrados disponíveis no Droid. Depois de selecionar o modelo, você pode começar a fornecer prompts, como pedir que ele analise a base de código, corrija um bug, revise o código ou desenvolva um recurso.

Conectar o Droid a uma API externa dá mais liberdade para trabalhar com o modelo de sua preferência, sem ficar limitado às opções integradas. A configuração é feita na CLI do Droid, adicionando um modelo personalizado ao arquivo de configurações. Depois de salvo, o modelo fica disponível no menu /model. As etapas abaixo usam o Kimi como um exemplo simples, para mostrar como funciona toda a configuração, da chave da API à seleção do modelo:

Etapa 1: obtenha uma chave da Kimi API no Moonshot AI

Comece criando ou copiando suachave da Kimi API no Moonshot AI. Você precisará dessa chave porque o Droid a usa para se conectar à Kimi API e enviar solicitações pela sua própria conta. É recomendável salvar a chave como uma variável de ambiente, como MOONSHOT_API_KEY, para usá-la com segurança no arquivo de configurações.

Etapa 2: abra o arquivo de configurações do Droid

Em seguida, abra o arquivo de configurações em que os modelos personalizados são adicionados na CLI do Droid. No macOS, o caminho do arquivo é ~/.factory/settings.json. No Windows PowerShell, use %USERPROFILE%\.factory\settings.json. Esse é o arquivo principal em que o Droid lê a configuração dos modelos personalizados.

Etapa 3: adicione o Kimi como modelo personalizado

No arquivo settings.json, adicione o Kimi à matriz customModels. Isso informa ao Droid qual modelo usar, qual endpoint de API ele deve chamar, qual formato de provedor ele segue e qual chave de API deve ser usada para autenticação. Se o arquivo já tiver outras configurações, não substitua tudo; apenas adicione este objeto de modelo à matriz customModels existente.

Etapa 4: salve o arquivo e reinicie o Droid

Depois de adicionar a configuração, salve o arquivo e reinicie a CLI do Droid. Assim, o Droid recarrega as configurações atualizadas e reconhece corretamente o novo modelo personalizado.

Etapa 5: selecione o modelo Kimi usando /model no Droid

Abra o Droid CLI e execute o comando /model. A configuração do Kimi deverá aparecer na seção de modelos personalizados. Selecione-a na lista para tornar o Kimi o modelo ativo na sua sessão de programação.

Etapa 6: Execute uma tarefa

Depois de selecionar o Kimi, você pode começar a usá-lo para tarefas reais no Droid. Experimente um prompt para revisar código, corrigir um bug ou explicar uma base de código. O Droid enviará a solicitação pela Kimi API e usará esse modelo para a tarefa.

Depois de conectar o Kimi ao Droid, ele se torna muito mais do que um modelo externo no CLI. Ele passa a ser um assistente prático de programação, que se encaixa no seu fluxo diário de desenvolvimento e ajuda tanto em pequenas tarefas de código quanto em trabalhos maiores de engenharia. Estas são algumas vantagens de usar a Kimi API:

• Aumente a eficiência no desenvolvimento

O Kimi pode ajudar você a concluir tarefas cotidianas de programação mais rapidamente, gerando código, explicando a lógica e sugerindo correções enquanto você trabalha. Assim, não é necessário alternar entre várias ferramentas para obter suporte básico ao desenvolvimento. Com o Kimi no Droid, o trabalho rotineiro de programação fica mais rápido de gerenciar.

• Escreva código mais confiável

O Kimi pode revisar seu código, apontar possíveis problemas e ajudar a melhorar a estrutura antes que pequenos erros se tornem problemas maiores. Esse tipo de feedback antecipado é útil quando você busca uma lógica mais clara e melhor manutenibilidade. Com o tempo, ele pode ajudar você a criar código mais fácil de testar, atualizar e entender.

• Lide com diversas tarefas de desenvolvimento

O Kimi não se limita a escrever código do zero. Ele também pode ajudar a refatorar, documentar código, entender projetos desconhecidos e apoiar o desenvolvimento de recursos em diferentes tarefas. Isso o torna uma opção flexível para desenvolvedores que querem um modelo de IA para auxiliar em várias partes do fluxo de trabalho.

Conectar uma chave de API externa no Droid geralmente é simples, mas pequenos erros de configuração ainda podem causar problemas. A maioria das questões vem do arquivo de configurações, do nome do provedor, da chave de API ou da configuração do servidor do modelo, e não do próprio Droid. A boa notícia é que esses erros costumam ser fáceis de corrigir quando você sabe onde procurar.

• Verifique a sintaxe JSON em ~/.factory/settings.json ou em config.json se estiver usando o formato legado

• As alterações nas configurações são detectadas automaticamente pelo monitoramento de arquivos

• Confirme que todos os campos obrigatórios estão presentes na configuração do modelo personalizado

• Verifique se o valor do provedor é exatamente anthropic, openai ou generic-chat-completion-api

• Verifique se há erros de ortografia e capitalização correta no campo do provedor

• Confirme que sua chave de API é válida e tem créditos disponíveis

• Verifique se a chave de API tem as permissões corretas para o provedor

• Confirme que a URL base corresponde ao endpoint da API na documentação do provedor

• Verifique se o servidor do seu modelo local está em execução, como ollama serve

• Confirme que a URL base está correta e inclui /v1/ se o provedor exigir

• Verifique se o modelo já foi baixado ou está disponível localmente

• Verifique os limites de taxa da API e as cotas de uso do seu provedor

• Monitore seu uso no painel do provedor para verificar se os limites foram atingidos

Usar APIs personalizadas no Droid oferece mais controle sobre como você cria, testa e aprimora código com IA. Depois que a configuração está pronta, fica mais fácil adaptar seu fluxo de programação ao modelo que atende às suas necessidades. Seja usando as opções integradas ou conectando um modelo externo, o Droid oferece uma forma flexível de levar a IA ao desenvolvimento. Se você procura um ponto de partida simples para uma configuração personalizada, vale a pena experimentar o Kimi no Droid. Ele pode ser uma opção prática para tornar o trabalho cotidiano de programação mais fluido e rápido.