Configurar um modelo personalizado em Visual Studio Code para ambientes restritos à rede

Você pode usar um modelo personalizado com a modernização do GitHub Copilot no Visual Studio Code quando trabalha em um ambiente com restrição de rede. Instale a extensão e o AppCAT manualmente e configure Visual Studio Code para usar um ponto de extremidade de modelo que seu ambiente possa alcançar.

Você não precisa fazer login no GitHub Copilot para esse fluxo de trabalho.

Warning

O código-fonte e o contexto de avaliação são enviados para o ponto de extremidade do modelo que você configurar. Um modelo personalizado não garante o isolamento total da rede e alguns recursos de modernização ainda exigem acesso à rede. Você é responsável pela postura de segurança e conformidade do provedor de modelos.

Prerequisites

  • Visual Studio Code.
  • Um computador com acesso à rede que você pode usar para baixar a extensão e os pacotes AppCAT.
  • Uma maneira de transferir os pacotes baixados para o computador com restrição de rede.
  • Um ponto de extremidade de modelo personalizado que o computador restrito à rede pode alcançar.
  • A URL do ponto de extremidade, o modelo ou o nome da implantação e uma chave de API se o ponto de extremidade exigir autenticação.

Instalar a extensão a partir de um VSIX

Baixe o pacote de extensão em um computador conectado e instale-o no computador com restrição de rede.

  1. No computador conectado, abra a visualização Extensões no Visual Studio Code.

  2. Encontre a extensão de modernização do aplicativo GitHub Copilot.

  3. Abra o menu de contexto da extensão e selecione Baixar VSIX.

    Captura de tela que mostra o modo de exibição de Extensões do Visual Studio Code com o Download do VSIX selecionado para a extensão de modernização do aplicativo Copilot do GitHub.

  4. Transfira o arquivo VSIX para o computador com restrição de rede.

  5. No computador restrito à rede, abra a exibição Extensões.

  6. Selecione Exibições e Mais Ações (...) e, em seguida, selecione Instalar do VSIX....

    Captura de tela que mostra o modo de exibição Extensões do Visual Studio Code com Instalar do VSIX selecionado.

  7. Selecione o arquivo VSIX transferido.

Instalar o AppCAT manualmente

A extensão não pode baixar o AppCAT automaticamente sem acesso à rede pública. Instale o AppCAT antes de executar uma avaliação.

  1. No computador conectado, vá para Instalar o AppCAT e baixe o pacote de aplicativos.

  2. Transfira o pacote para o computador restrito à rede.

  3. Extraia o pacote em ~/.appcat.

  4. Verifique se o executável AppCAT está em um dos seguintes locais:

    • Windows: ~/.appcat/appcat.exe
    • Linux ou macOS: ~/.appcat/appcat

  5. Adicionar ~/.appcat ao sistema PATH.

  6. Reinicie Visual Studio Code.

Note

Se a versão do AppCAT instalada não corresponder à versão esperada pela extensão, a extensão tentará baixar outra versão. Sem acesso à rede, o download falha e a avaliação pode parecer ser executada indefinidamente. Instale o pacote appCAT mais recente manualmente para resolver o problema.

Adicionar um modelo de idioma personalizado

  1. Pressione Ctrl+Shift+P para abrir a Paleta de Comandos.

  2. Executar Chat: Gerenciar Modelos de Linguagem.

    Captura de tela que mostra a Paleta de Comandos do Visual Studio Code com Chat: Manage Language Models selecionado.

  3. Na caixa de diálogo Modelos de Linguagem , selecione Adicionar Modelos....

  4. Selecione o provedor que corresponde ao endpoint. Por exemplo, selecione Azure, OpenAI, OpenAI Compatível ou Ponto de Extremidade Personalizado.

  5. Insira os detalhes de conexão exigidos pelo provedor, incluindo o nome do modelo, a chave de API e o endpoint.

  6. Verifique se o modelo aparece em Modelos de Linguagem.

Selecionar e testar o modelo personalizado

  1. Abra o Chat no Visual Studio Code.

  2. Selecione o modelo personalizado na lista Escolher Modelo.

    Captura de tela que mostra o seletor de modelo de chat Visual Studio Code com um modelo Ollama personalizado selecionado.

  3. Envie uma mensagem de teste e verifique se o modelo responde.

    Captura de tela que mostra Visual Studio Code Chat com uma resposta do modelo personalizado selecionado.

Configurar os modelos de utilitário

A Modernização do GitHub Copilot usa as configurações do modelo de utilitário do Visual Studio Code para fluxos de utilitário internos.

  1. Abra Configurações.

  2. Pesquise por chat.utility.

  3. Definir Chat: Utility Model para o modelo personalizado.

  4. Definir Chat: Utility Small Model para o modelo personalizado.

    Captura de tela que mostra Configurações do Visual Studio Code com o modelo personalizado selecionado para Chat Utility Model e Chat Utility Small Model.

Executar uma avaliação e criar um plano

  1. Abra GitHub Copilot Modernization.
  2. Selecione Iniciar Avaliação ou Abrir Painel de Avaliação.
  3. Execute a avaliação e abra o relatório de avaliação.
  4. Selecione as descobertas de modernização que você deseja abordar.
  5. Selecione Criar Plano.

A extensão envia as conclusões de avaliação selecionadas para o Chat e invoca o agente de modernização, as ferramentas e as habilidades com o modelo configurado.

Limitações e problemas conhecidos

  • O domínio de avaliação de segurança requer acesso à rede e não está disponível em um ambiente restrito à rede.
  • A verificação e a resolução de problemas de segurança exigem acesso à rede.
  • As incompatibilidades de versão do AppCAT podem disparar um download automático que falha sem acesso à rede pública.
  • Os resultados dependem dos recursos do modelo personalizado. Um modelo que não suporta as ferramentas ou o contexto necessários pode não concluir o fluxo de trabalho.
  • A configuração de um modelo personalizado não fornece isolamento de rede completo. Use os controles de rede para impor os requisitos de saída da sua organização.

Conteúdo relacionado

  • Última atualização em