# Configurar a IA

Conecte um provedor de API, um modelo local ou um agente de CLI instalado.

Escolha como você quer trabalhar. O Oleafly pode executar o assistente integrado com a API de um modelo, conectar-se a um modelo local ou usar um agente de CLI instalado.

| Se você já tem… | Escolha… |
| --- | --- |
| Uma chave de API de modelo | **Provedores e chaves** |
| Um servidor de modelo local | **Ollama** ou um provedor personalizado compatível com OpenAI |
| Um agente de programação instalado | [**Agentes de CLI**](/docs/cli-agents/) |
| Um cliente MCP externo | [**MCP**](/docs/mcp/) |

Abra **Configurações → Assistente de IA** para configurar o caminho que você quer. Você pode manter vários provedores conectados e trocar de modelo no chat.

Sem chave de API? Um agente de CLI em que você já fez login pode ocupar o lugar dela. Escolha-o como o modelo para as Ferramentas, e as Ferramentas e os outros recursos de IA do Oleafly passam a usá-lo. Veja [Use um agente no lugar de uma chave de API](/docs/cli-agents/#use-an-agent-instead-of-an-api-key).

![Configurações → Assistente de IA → Provedores e chaves. Expanda o seu provedor para configurá-lo. O Ollama fica perto do fim da lista.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

![Chaves de provedores, agentes de linha de comando e habilidades nas configurações do assistente.](https://cdn.oleafly.com/images/gifs/desktop/settings-ai-agents.gif?v=2)

## Conecte um provedor

1. Abra **Provedores e chaves** e expanda um provedor.
2. Digite a chave de API dele e salve.
3. O Oleafly verifica a conexão e atualiza a lista de modelos.
4. Escolha um modelo no assistente ou defina um padrão em **Instruções**.

OpenAI

Anthropic

Google Gemini

Perplexity

Z.AI

Groq

OpenRouter

DeepSeek

Mistral

xAI

Ollama

O cartão de cada provedor em Configurações leva à configuração da chave dele. O Ollama se conecta a um servidor de modelo local.

## Escolha um modelo

As linhas de modelos mostram informações de recursos quando disponíveis: tamanho do contexto, visão, ferramentas e raciocínio. Use um modelo com suporte a ferramentas para o trabalho no projeto e com suporte a visão para a inspeção de imagens.

**Verificado** significa que uma verificação de chamada de ferramenta deu certo. **Não testado** significa que o assistente não verificou esse modelo; **Bloqueado** inclui o motivo de ele não poder ser selecionado. Esses selos descrevem a compatibilidade com ferramentas. Eles não avaliam a qualidade da pesquisa ou da escrita de um modelo.

Um modelo que não consegue chamar ferramentas ainda funciona para conversa simples. Enquanto ele está selecionado, o campo de mensagem diz **Só conversa, este modelo não usa ferramentas**.

Escolha **Atualizar** no cartão de um provedor quando os modelos disponíveis mudarem. Cada provedor pode ser atualizado uma vez a cada 30 segundos; passe o mouse sobre o botão para ver quanto tempo falta. Você também pode adicionar um modelo pelo identificador dele.

**Ativar todos** e **Desativar todos** ligam ou desligam todos os modelos da lista de um provedor. Desligue uma lista longa com um clique e depois religue os poucos modelos que você usa.

## Conecte um modelo local

Instale e inicie o [Ollama](https://ollama.com/) e depois baixe um modelo nele. No Oleafly, abra o cartão do Ollama e escolha **Procurar o Ollama**. Selecione um modelo instalado quando o servidor for encontrado.

Um modelo local mantém as requisições ao modelo na sua máquina. As ferramentas de pesquisa online ainda entram em contato com os serviços de origem delas quando são usadas.

## Adicione um endpoint personalizado

Escolha **Adicionar provedor personalizado** para um serviço compatível com OpenAI, um servidor local ou um gateway. Digite um nome, a URL base e a chave, se for exigida. Salve e escolha um modelo.

O OpenCode Zen e o OpenCode Go funcionam como provedores personalizados. Eles recusam requisições sem um ID de sessão, então o Oleafly envia a eles o ID de cada chat e não o envia a nenhum outro provedor. Um servidor Lemonade local também funciona aqui. Para os modelos dele que pensam antes de responder, veja [Pule a etapa de raciocínio](/docs/ollama/#skip-the-thinking-step).

Editar um provedor salvo permite mudar o endereço dele. Uma chave salva será enviada ao novo endereço quando esse provedor for usado, então confira o destino antes de salvar.

## Defina preferências de escrita

**Instruções** guarda as preferências permanentes e o modelo padrão do chat. Use instruções concretas:

> Use a ortografia britânica. Preserve as chaves de citação. Explique as mudanças nas equações antes de aplicá-las.

**Personas** guarda conjuntos de instruções com nome. **Habilidades** fornece procedimentos para trabalhos de pesquisa recorrentes. [Conheça as habilidades →](/docs/skills/)

## Chaves e custos

As chaves dos provedores são criptografadas no armazenamento local do aplicativo e ficam fora dos arquivos de código-fonte do projeto. As requisições a modelos hospedados vão para o provedor selecionado com o contexto fornecido. As cobranças de API de modelos e as assinaturas de CLI são faturadas pelos próprios provedores.

[Veja o uso e os orçamentos →](/docs/ai-usage/)
