# Habilitar modelos personalizados para GitHub Copilot em sua organização

Integre seus modelos personalizados preferenciais usando GitHub Copilot suas próprias chaves de API LLM e disponibilize-os aos membros da sua organização.

> \[!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 de uma organização, 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.

## Pré-requisitos

Um proprietário da empresa deve ter habilitado a política **Habilitar modelos personalizados** .

## Adicionando sua chave a uma conta da organização

> \[!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 da sua organização 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 organização.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-organization" aria-label="organization" role="img"><path d="M1.75 16A1.75 1.75 0 0 1 0 14.25V1.75C0 .784.784 0 1.75 0h8.5C11.216 0 12 .784 12 1.75v12.5c0 .085-.006.168-.018.25h2.268a.25.25 0 0 0 .25-.25V8.285a.25.25 0 0 0-.111-.208l-1.055-.703a.749.749 0 1 1 .832-1.248l1.055.703c.487.325.779.871.779 1.456v5.965A1.75 1.75 0 0 1 14.25 16h-3.5a.766.766 0 0 1-.197-.026c-.099.017-.2.026-.303.026h-3a.75.75 0 0 1-.75-.75V14h-1v1.25a.75.75 0 0 1-.75.75Zm-.25-1.75c0 .138.112.25.25.25H4v-1.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 .75.75v1.25h2.25a.25.25 0 0 0 .25-.25V1.75a.25.25 0 0 0-.25-.25h-8.5a.25.25 0 0 0-.25.25ZM3.75 6h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1 0-1.5ZM3 3.75A.75.75 0 0 1 3.75 3h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 3 3.75Zm4 3A.75.75 0 0 1 7.75 6h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 7 6.75ZM7.75 3h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1 0-1.5ZM3 9.75A.75.75 0 0 1 3.75 9h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 3 9.75ZM7.75 9h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1 0-1.5Z"></path></svg> Your organizations**.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg> Settings**. Caso não consiga ver a guia "Configurações", selecione o menu suspenso **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>** , clique em **Configurações**.

   ![Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.](/assets/images/help/discussions/org-settings-global-nav-update.png)

4. Na barra lateral, em "Código, planejamento e automação", 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**.

5. Em "Copilot", clique em **Modelos**.

6. Clique na guia **Modelos personalizados** .

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

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

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

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

11. 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)

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

## Leitura adicional

* [Habilitar modelos personalizados para GitHub Copilot em sua empresa](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) em nossa documentação para contas corporativas.
* [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)