> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar a Provedores de IA

> Use suas próprias credenciais da OpenAI ou Anthropic com o Craft Assistant em vez de créditos de IA do Craft.

O Craft Assistant usa créditos de IA do Craft por padrão, mas você pode conectar sua própria conta de provedor de IA. Quando você usa um provedor conectado, nenhum crédito de IA do Craft é consumido.

<Info>
  Este recurso está disponível apenas no **macOS** e no **iOS**. Não está disponível no Web ou no Windows.
</Info>

## Provedores disponíveis

| Provedor           | Método de conexão                                 |
| ------------------ | ------------------------------------------------- |
| **OpenAI**         | Entrar com o ChatGPT ou colar uma chave de API    |
| **Anthropic**      | Colar uma chave de API                            |
| **Modelos locais** | Executados no dispositivo, sem conexão necessária |
| **Craft**          | Padrão, usa créditos de IA do Craft               |

<Info>
  Quando você usa um provedor conectado, a conversa é processada pela API desse provedor. A cota de uso de IA do Craft não é afetada.
</Info>

## Conectar um provedor

<Steps>
  <Step title="Abrir Configurações">
    Acesse **Configurações** > **Assistente**.
  </Step>

  <Step title="Localizar Conexões de Provedores de IA">
    Role até a seção **Conexões de Provedores de IA**.
  </Step>

  <Step title="Tocar em Conectar">
    Toque em **Conectar** ao lado do provedor que deseja adicionar.
  </Step>

  <Step title="Verificar o provedor ativo">
    Abra o painel do Assistente e confirme que o novo provedor está selecionado. Novas conversas usam o provedor conectado automaticamente, mas chats que já estavam abertos podem continuar usando o Craft. Consulte [Alternar entre provedores](#alternar-entre-provedores) para alterar isso.
  </Step>
</Steps>

<Frame caption="Clique para ampliar">
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/bring-your-own-key/en/content/settings-ai-provider-connections.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=b7258cea96e57b581394a1f82ad381cc" alt="AI Provider Connections section in Settings showing OpenAI and Anthropic options" width="1470" height="1067" data-path="images/ai-assistant/bring-your-own-key/en/content/settings-ai-provider-connections.png" />
</Frame>

### OpenAI

Há duas formas de conectar a OpenAI:

* **Entrar com o ChatGPT**: use sua conta e assinatura existentes do ChatGPT. Não é necessária uma chave de API.
* **Usar chave de API da OpenAI**: cole uma chave de API da [OpenAI Platform](https://platform.openai.com/api-keys). O uso é cobrado na sua conta da OpenAI.

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/bring-your-own-key/en/content/connect-openai-dialog.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=0c42784bf0718402b2f4b626a621f9a4" alt="Connect to OpenAI dialog with two options: Use OpenAI API Key and Sign in with ChatGPT" width="1470" height="1067" data-path="images/ai-assistant/bring-your-own-key/en/content/connect-openai-dialog.png" />
</Frame>

### Anthropic

Para conectar a Anthropic, cole uma chave de API do [Anthropic Console](https://console.anthropic.com/). O uso é cobrado na sua conta da Anthropic.

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/bring-your-own-key/en/content/connect-anthropic-dialog.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=99975bfc8d17d7a33ca55af604b3b23e" alt="Connect to Anthropic dialog with API key field and Open Anthropic Console button" width="1470" height="1067" data-path="images/ai-assistant/bring-your-own-key/en/content/connect-anthropic-dialog.png" />
</Frame>

## Alternar entre provedores

Após conectar um provedor, você pode alternar entre provedores e modelos diretamente no painel do Assistente.

<Steps>
  <Step title="Abrir o painel do Assistente">
    Abra o Assistente em qualquer documento ou visualização de Space.
  </Step>

  <Step title="Tocar no botão do Assistente">
    Abaixo do campo de entrada, toque no **botão do Assistente**.
  </Step>

  <Step title="Selecionar Modelo">
    Escolha **Modelo** no popup. Os modelos dos seus provedores conectados aparecem junto com os modelos do Craft.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/bring-your-own-key/en/content/model-selector-provider.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=58d8da8fb4d5adb65f5f04222a1b5f23" alt="Model selector in the Assistant panel showing OpenAI models" width="1076" height="1124" data-path="images/ai-assistant/bring-your-own-key/en/content/model-selector-provider.png" />
</Frame>

Para alterar o provedor ativo, toque em **Configurar** na parte inferior da lista de modelos e selecione um provedor no menu **Provedor**.

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/bring-your-own-key/en/content/configure-provider-dropdown.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=e64aeb2da5097bb72d3e02a0366e762d" alt="Configure dialog showing provider dropdown with Craft, Local Models, OpenAI, and Anthropic" width="1024" height="967" data-path="images/ai-assistant/bring-your-own-key/en/content/configure-provider-dropdown.png" />
</Frame>

<Tip>
  Você pode identificar qual provedor está ativo pelo selo exibido no chat. O logotipo do provedor aparece ao lado do nome do modelo, indicando se a conversa está usando créditos do Craft ou o seu próprio provedor.
</Tip>

## Remover uma conexão

<Steps>
  <Step title="Abrir Configurações">
    Acesse **Configurações** > **Assistente**.
  </Step>

  <Step title="Localizar a conexão">
    Na seção **Conexões de Provedores de IA**, encontre o provedor que deseja remover.
  </Step>

  <Step title="Remover">
    Toque no **botão de 3 pontos** ao lado da conexão e, em seguida, toque em **Remover**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/craft-support/mrn9h3Zv_F-f37nX/images/ai-assistant/bring-your-own-key/en/content/remove-connection.png?fit=max&auto=format&n=mrn9h3Zv_F-f37nX&q=85&s=d047ca8c12d7fb24a5e088400343bd1c" alt="AI Provider Connections showing connected providers with Remove button" width="1091" height="953" data-path="images/ai-assistant/bring-your-own-key/en/content/remove-connection.png" />
</Frame>

Após remover uma conexão, o Assistente volta a usar os créditos de IA do Craft.

<Columns cols={2}>
  <Card title="Escolher Modelos de IA" href="/pt-BR/ai-assistant/models" />

  <Card title="Créditos de IA" href="/pt-BR/ai-assistant/usage" />
</Columns>
