Configure um modelo personalizado no Visual Studio Code para ambientes com restrição de rede

Pode usar um modelo personalizado com a modernização do GitHub Copilot no Visual Studio Code quando trabalha num ambiente com restrições de rede. Instala a extensão e o AppCAT manualmente, e depois configura o Visual Studio Code para usar um endpoint de modelo que o teu ambiente possa alcançar.

Não precisas de iniciar sessão no GitHub Copilot para este fluxo de trabalho.

Warning

O seu código-fonte e o contexto de avaliação são enviados para o endpoint do modelo que configurar. Um modelo personalizado não garante isolamento total da rede, e algumas capacidades de modernização ainda exigem acesso à rede. És responsável pelo nível de segurança e conformidade do fornecedor do modelo.

Prerequisites

  • Código do Visual Studio.
  • Um computador com acesso à rede que possa usar para descarregar a extensão e os pacotes AppCAT.
  • Uma forma de transferir os pacotes descarregados para o computador com restrições de rede.
  • Um endpoint de modelo personalizado que o computador com restrição de rede pode alcançar.
  • O URL do endpoint, o nome do modelo ou de implementação, e uma chave API se o endpoint exigir autenticação.

Instale a extensão a partir de um VSIX

Descarregue o pacote de extensão num computador com ligação à Internet e depois instale-o no computador com acesso à rede restrito.

  1. No computador ligado, abra a vista de Extensões no Visual Studio Code.

  2. Encontre a extensão GitHub aplicação Copilot modernization.

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

    Captura de ecrã que mostra a vista Extensões do Visual Studio Code com Download VSIX selecionado para a extensão de modernização de aplicações do GitHub Copilot.

  4. Transfira o ficheiro VSIX para o computador restrito à rede.

  5. No computador com restrição de rede, abra a vista Extensões .

  6. Selecione Views and More Actions (...), e depois selecione Instalar a partir do VSIX....

    Captura de ecrã que mostra a vista das Extensões do Visual Studio Code com Instalar do VSIX selecionado.

  7. Selecione o ficheiro VSIX transferido.

Instale o AppCAT manualmente

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

  1. No computador ligado, vá a Instalar AppCAT e descarregue o pacote da aplicação.

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

  3. Extrair o pacote para ~/.appcat.

  4. Verifique se o executável do AppCAT está numa das seguintes localizações:

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

  5. Adicione ~/.appcat ao sistema PATH.

  6. Reiniciar o Visual Studio Code.

Note

Se a versão AppCAT instalada não corresponder à versão que a extensão espera, a extensão tenta descarregar outra versão. Sem acesso à rede, o download falha e a avaliação pode parecer decorrer indefinidamente. Instale manualmente o último pacote AppCAT para resolver o problema.

Adicionar um modelo de linguagem personalizado

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

  2. Executar Chat: Gerir Modelos de Linguagem.

    Captura de ecrã que mostra a paleta de comandos do Visual Studio Code com Chat: Manage Language Models selecionado.

  3. No diálogo Modelos de Linguagem , selecione Adicionar Modelos....

  4. Selecione o fornecedor que corresponda ao seu endpoint. Por exemplo, selecione Azure, OpenAI, OpenAI Compatível ou Endpoint Personalizado.

  5. Introduza os detalhes da ligação que o fornecedor exige, incluindo o nome do modelo, a chave API e o endpoint.

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

Selecione e teste o modelo personalizado

  1. Abra o Chat no Visual Studio Code.

  2. Selecione o modelo personalizado da lista Escolher modelo.

    Captura de ecrã que mostra o seletor de modelos do Visual Studio Code Chat com um modelo Ollama personalizado selecionado.

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

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

Configurar os modelos de utilidade

A modernização do GitHub Copilot utiliza as definições do modelo de utilitário do Visual Studio Code para fluxos utilitários incorporados.

  1. Abra Configurações.

  2. Pesquise por chat.utility.

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

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

    Captura de ecrã que mostra as Definições do Visual Studio Code com o modelo personalizado selecionado para Chat Utility Model e Chat Utility Small Model.

Faça uma avaliação e crie um plano

  1. Abrir GitHub Copilot Modernization.
  2. Selecione Iniciar Avaliação ou Abrir Painel de Avaliação.
  3. Faz a avaliação e depois abre o relatório da avaliação.
  4. Selecione as conclusões de modernização que pretende abordar.
  5. Selecione Criar plano.

A extensão envia os resultados selecionados da avaliação para o Chat e invoca o agente de modernização, as ferramentas e as competências 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 num ambiente restrito à rede.
  • Scan & Resolve Security Issues requer acesso à rede.
  • As incompatibilidades de versões do AppCAT podem desencadear um download automático que falha sem acesso à rede pública.
  • Os resultados dependem das capacidades do modelo personalizado. Um modelo que não oferece suporte às ferramentas ou ao contexto necessários pode não completar o fluxo de trabalho.
  • Configurar um modelo personalizado não proporciona isolamento total da rede. Use controlos de rede para fazer cumprir os requisitos de tráfego de saída da sua organização.

Conteúdo relacionado

  • Última atualização a