Skip to main content

Usando suas próprias chaves de API em modelos de GitHub

Saiba como integrar seus modelos personalizados preferidos com o GitHub Models usando suas próprias chaves de API de LLM.

Quem pode usar esse recurso?

Organization owners can add custom models to GitHub Models for their organization

Observação

A capacidade de trazer suas próprias chaves (BYOK) para usar modelos personalizados com o GitHub Models para organizações no GitHub está no {data variables.release-phases.public_preview %} e sujeita a alterações.

Atualmente, o suporte ao modelo está limitado ao OpenAI e ao AzureAI.

Você pode trazer suas próprias chaves de API (BYOK) para o GitHub Models e permitir que as equipes usem seus fornecedores de modelos de linguagem de grande porte (LLM) preferidos em ferramentas como Prompts, Playground e Modelos em Ações. Para obter mais informações sobre GitHub Models, consulte Sobre modelos de GitHub.

Para saber mais sobre cobrança e preços, consulte Cobrança de Modelos do GitHub.

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. Ao configurar suas próprias chaves de API, você pode:

  •         **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:** Gerencie quais modelos sua equipe pode acessar e monitore o uso por meio dos painéis e da cobrança já existentes do seu provedor.
    
  •         **Flexibilidade:** dar suporte a modelos personalizados ou especializados que sua organização já usa.
    

Como configurar suas chaves de API para adicionar modelos personalizados

Importante

É 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.

Primeiro, você deve adicionar as chaves de API relevantes para a organização. Depois disso, você pode especificar ou habilitar os modelos personalizados que deseja disponibilizar aos usuários.

Como adicionar chaves de API

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na seção "Code, planning, and automation" da barra lateral, clique no menu suspenso Models. Clique em Custom models. A página "Custom Models" exibe as chaves de API e os modelos personalizados adicionados à organização.

  5. Clique em Adicionar chave de API.

  6. Na caixa de diálogo "Adicionar a chave de API", forneça detalhes sobre sua chave. Nome e Chave de API são campos obrigatórios.

  7. Clique em Save (Salvar).

Como habilitar modelos personalizados

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na seção "Code, planning, and automation" da barra lateral, clique no menu suspenso Models. Clique em Development.

  5. Em "Permissões de modelos", selecione Todos os editores para ativar modelos adicionados por chaves de API.

  6. Opcionalmente, selecione Only select models para criar uma lista personalizada de modelos habilitados ou desabilitados. Isso permite que você controle quais modelos estão disponíveis para sua organização.

Como criar uma lista de modelos habilitados ou desabilitados

Para controlar quais modelos estão disponíveis para sua organização, crie uma lista de modelos habilitados ou desabilitados da seguinte maneira:

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na seção "Code, planning, and automation" da barra lateral, clique no menu suspenso Models. Clique em Development.

  5. Em "Models permissions", selecione Only select models, e selecione Enabled list na lista suspensa para criar uma lista de modelos permitidos.

  6. Opcionalmente, selecione Disabled list na lista suspensa para criar uma lista de modelos bloqueados.

  7. Acima da tabela de modelos, clique em Adicionar modelos ou editores.

  8. Na caixa de diálogo "Selecionar modelos e publicadores para permitir", selecione os modelos e publicadores que você deseja incluir em sua lista.

  9. Clique em Update enabled list para salvar as alterações.

Próximas etapas

Agora que você habilitou seus modelos personalizados em GitHub Models, saiba como: