{"meta":{"title":"Habilitar modelos personalizados para GitHub Copilot em sua organização","intro":"Integre os modelos personalizados preferidos a GitHub Copilot usando as próprias chaves de API LLM e as disponibilize aos membros da organização.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/administer-copilot","title":"Administrar o Copilot"},{"href":"/pt/copilot/how-tos/administer-copilot/manage-for-organization","title":"Gerenciar a organização"},{"href":"/pt/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models","title":"Habilitar modelos personalizados"}],"documentType":"article"},"body":"# Habilitar modelos personalizados para GitHub Copilot em sua organização\n\nIntegre os modelos personalizados preferidos a GitHub Copilot usando as próprias chaves de API LLM e as disponibilize aos membros da organização.\n\n> \\[!NOTE]\n> Esse recurso está dentro prévia pública e sujeito a alterações.\n\nVocê 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 Copilot Chat, Copilot CLI, and IDEs.\n\nHá suporte para chaves de API dos seguintes provedores:\n\n* Anthropic\n* AWS Bedrock\n* Google AI Studio\n* Microsoft Foundry\n* OpenAI\n* Provedores compatíveis com OpenAI\n* xAI\n\nModelos 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.\n\n> \\[!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).\n\n## Por que trazer suas próprias chaves de API?\n\nComo 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:\n\n* **Governança e conformidade:** escolher provedores LLM em conformidade com as políticas e os requisitos regulatórios da sua organização.\n* **Gerenciamento de custos:** alinhar-se com suas formas de pagamento, contratos, créditos ou taxas negociadas existentes e evitar excessos de uso.\n* **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.\n* **Flexibilidade:** dar suporte a modelos personalizados ou especializados que sua organização já usa.\n\n## Pré-requisitos\n\nUm proprietário da empresa deve ter habilitado a política **Habilitar modelos personalizados** .\n\n## Adicionando sua chave a uma conta da organização\n\n> \\[!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.\n\nDepois de adicionar sua chave e selecionar um ou mais modelos, você e os membros da sua organização poderão usá-los com Copilot Chat, Copilot CLI, and IDEs. Seus modelos aparecerão na parte inferior do seletor de modelos, sob o nome da organização.\n\n1. 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**.\n\n2. Selecione uma organização clicando nela.\n\n3. 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**.\n\n   ![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)\n\n4. 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**.\n\n5. Em \"Copilot\", clique em **Modelos**.\n\n6. Clique na guia **Modelos personalizados** . 1. Acima da lista de chaves de API, clique em **Adicionar chave de API**.\n\n7. Em \"Provedor\", selecione o provedor LLM que você deseja usar.\n\n8. Em \"Nome\", digite um nome para essa chave. Isso será mostrado no seletor de modelo.\n\n9. Em \"Chave de API\", digite ou cole sua chave.\n\n10. Dependendo de qual provedor você está usando, selecione ou adicione modelos.\n    * Se você estiver usando OpenAI, Anthropic ou xAI, clique <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.\n\n      ![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)\n\n    * 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 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-check\" aria-label=\"Add model\" 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.\n\n      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.\n\n      ![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)\n\n11. Depois de selecionar ou adicionar os modelos que deseja disponibilizar, clique em **Salvar**.\n\n## Leitura adicional\n\n* [Habilitar modelos personalizados para GitHub Copilot em sua empresa](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models) em nossa documentação para contas empresariais.\n* [Sobre GitHub Copilot Chat](/pt/copilot/concepts/chat)\n* [Superfícies com suporte para políticas de GitHub Copilot](/pt/copilot/reference/supported-surfaces-for-policies)"}