# Habilitar modelos personalizados para GitHub Copilot em sua empresa

Integre com GitHub Copilot os modelos personalizados de sua preferência usando suas próprias chaves de API de LLM e disponibilize-os para organizações em sua conta empresarial.

> \[!NOTE]
> Esse recurso está dentro prévia pública e sujeito a alterações.

Você pode adicionar modelos personalizados à sua empresa ou organização fornecendo suas próprias chaves de API. Isso permite que as equipes usem seus provedores preferidos de LLM (grandes modelos de linguagem) com Bate-papo do Copilot, CLI do Copilot e IDEs.

Há suporte para chaves de API dos seguintes provedores:

* Anthropic
* AWS Bedrock
* Google AI Studio
* Microsoft Foundry
* OpenAI
* Provedores compatíveis com OpenAI
* xAI

Modelos com ajustes finos também são suportados, mas a funcionalidade e a qualidade dos resultados podem variar dependendo da configuração do ajuste. Você deve testar seu modelo e examinar suas saídas cuidadosamente antes de usá-lo em produção.

> \[!NOTE] Um recurso separado permite que os usuários configurem suas próprias chaves LLM localmente em vários clientes. Consulte [Traga sua própria chave para GitHub Copilot](/pt/copilot/concepts/models/bring-your-own-key).

## Por que trazer suas próprias chaves de API?

Como proprietário da empresa, você pode ter requisitos específicos para governança, segurança de dados e conformidade. Configurar suas próprias chaves de API permite que você resolva:

* **Governança e conformidade:** escolher provedores LLM em conformidade com as políticas e os requisitos regulatórios da sua organização.
* **Gerenciamento de custos:** alinhar-se com suas formas de pagamento, contratos, créditos ou taxas negociadas existentes e evitar excessos de uso.
* **Visibilidade e controle:** gerenciar quais modelos sua equipe pode acessar e monitorar o uso por meio dos painéis e cobrança existentes do seu provedor.
* **Flexibilidade:** dar suporte a modelos personalizados ou especializados que sua organização já usa.

## Adicionando sua chave a uma conta corporativa

> \[!IMPORTANT] É altamente recomendável cumprir o princípio do privilégio mínimo atribuindo apenas os escopos mínimos necessários às suas chaves de API.

Depois de adicionar sua chave e selecionar um ou mais modelos, você e os membros de suas organizações poderão usá-los com Bate-papo do Copilot, CLI do Copilot e IDEs. Seus modelos aparecerão na parte inferior do seletor de modelos, sob o nome da empresa.

1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\&ref_type=engagement\&ref_style=text) em GitHub.com.

2. Na parte superior da página, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg> controles de IA**.

3. Na barra lateral, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg>Copilot**.

4. Clique **em Configurar modelos permitidos**.

5. Clique na guia **Modelos personalizados** .

6. Acima da lista de chaves de API, clique em **Adicionar chave de API**.

7. Em "Provedor", selecione o provedor LLM que você deseja usar.

8. Em "Nome", digite um nome para essa chave. Isso será mostrado no seletor de modelo.

9. Em "Chave de API", digite ou cole sua chave.

10. Dependendo de qual provedor você está usando, selecione ou adicione modelos.
    * Se você estiver usando OpenAI, Antropic ou xAI, clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-sync" aria-label="Fetch new models" role="img"><path d="M1.705 8.005a.75.75 0 0 1 .834.656 5.5 5.5 0 0 0 9.592 2.97l-1.204-1.204a.25.25 0 0 1 .177-.427h3.646a.25.25 0 0 1 .25.25v3.646a.25.25 0 0 1-.427.177l-1.38-1.38A7.002 7.002 0 0 1 1.05 8.84a.75.75 0 0 1 .656-.834ZM8 2.5a5.487 5.487 0 0 0-4.131 1.869l1.204 1.204A.25.25 0 0 1 4.896 6H1.25A.25.25 0 0 1 1 5.75V2.104a.25.25 0 0 1 .427-.177l1.38 1.38A7.002 7.002 0 0 1 14.95 7.16a.75.75 0 0 1-1.49.178A5.5 5.5 0 0 0 8 2.5Z"></path></svg> no campo de texto da chave de API para buscar os modelos associados à sua chave. Em seguida, em "Modelos disponíveis", selecione os modelos que você deseja usar.

      ![Captura de tela do formulário "Adicionar chave de API". O botão "Buscar novos modelos" é realçado com uma borda laranja.](/assets/images/help/copilot/byok-add.png)

    * Se você estiver usando o Microsoft Foundry, digite sua URL de implantação no campo em "URL de Implantação". Em seguida, no campo em "Modelos disponíveis", digite uma ID do Modelo e clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Adicionar modelo" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> para adicioná-la.

      Se seus modelos tiverem URLs de implantação diferentes, eles não poderão ser adicionados à mesma chave de API. Crie uma chave de API separada para cada URL de implantação.

      ![Captura de tela do formulário "Adicionar chave de API". O campo de texto do modelo e o botão "Adicionar modelo" são destacados com um contorno laranja.](/assets/images/help/copilot/byok-add-foundry.png)

11. Depois de selecionar ou adicionar os modelos que deseja disponibilizar, clique em **Salvar**.

## Gerenciando a disponibilidade de modelos personalizados em suas organizações

Você pode escolher se os modelos adicionados estão disponíveis para as organizações em sua conta corporativa.

1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\&ref_type=engagement\&ref_style=text) em GitHub.com.
2. Na parte superior da página, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg> controles de IA**.
3. Na barra lateral, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg>Copilot**.
4. Clique **em Configurar modelos permitidos**.
5. Clique na guia **Modelos personalizados** .
6. Acima da lista de chaves de API, clique na guia **Modelos Adicionados** .
7. Ao lado de um modelo, clique em **Configurar**. Se alguma organização já tiver acesso ao modelo, em vez de "Configurar", você precisará clicar em **Todas as organizações** ou **organizações X**.
8. No modal aberto, clique na guia **Acesso** .
   > \[!NOTE] O modelo deve ser definido como "Habilitado" antes que a guia "Access" esteja disponível.
9. Escolha como o modelo deve ser disponibilizado para as organizações:
   * Para disponibilizar o modelo para todas as organizações em sua conta corporativa, selecione **Permitir para todas as organizações**.
   * Para disponibilizar apenas o modelo para organizações específicas, selecione **Escolher por organização** e verifique ou desmarque as organizações listadas abaixo.
10. Clique em **Salvar**.

## Leitura adicional

* [Habilitar modelos personalizados para GitHub Copilot em sua organização](/pt/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys) em nossa documentação para organizações.
* [Sobre GitHub Copilot Chat](/pt/copilot/concepts/chat)
* [Superfícies com suporte para políticas de GitHub Copilot](/pt/copilot/reference/supported-surfaces-for-policies)