Konfigurieren eines benutzerdefinierten Modells in Visual Studio Code für netzwerkbeschränkte Umgebungen

Sie können ein benutzerdefiniertes Modell mit GitHub Copilot modernization in Visual Studio Code verwenden, wenn Sie in einer netzwerkbeschränkten Umgebung arbeiten. Installieren Sie die Erweiterung und AppCAT manuell, und konfigurieren Sie dann Visual Studio Code für die Verwendung eines Modellendpunkts, den Ihre Umgebung erreichen kann.

Sie müssen sich nicht bei GitHub Copilot für diesen Workflow anmelden.

Warning

Ihr Quellcode- und Bewertungskontext werden an den von Ihnen konfigurierten Modellendpunkt gesendet. Ein benutzerdefiniertes Modell garantiert keine vollständige Netzwerkisolation, und einige Modernisierungsfunktionen erfordern weiterhin Netzwerkzugriff. Sie sind für den Sicherheits- und Compliancestatus des Modellanbieters verantwortlich.

Voraussetzungen

  • Visual Studio Code.
  • Ein Computer mit Netzwerkzugriff, den Sie zum Herunterladen der Erweiterungs- und AppCAT-Pakete verwenden können.
  • Eine Möglichkeit, die heruntergeladenen Pakete auf den netzwerkbeschränkten Computer zu übertragen.
  • Ein benutzerdefinierter Modellendpunkt, den der netzwerkbeschränkte Computer erreichen kann.
  • Die Endpunkt-URL, das Modell oder der Bereitstellungsname und ein API-Schlüssel, wenn der Endpunkt eine Authentifizierung erfordert.

Installieren der Erweiterung aus einem VSIX

Laden Sie das Erweiterungspaket auf einem Computer mit Internetverbindung herunter, und installieren Sie es dann auf dem netzwerkbeschränkten Computer.

  1. Öffnen Sie auf dem verbundenen Computer die Ansicht Erweiterungen in Visual Studio Code.

  2. Suchen Sie die Modernisierungserweiterung der GitHub Copilot App.

  3. Öffnen Sie das Kontextmenü der Erweiterung, und wählen Sie dann Download VSIX.

    Screenshot der Ansicht „Visual Studio Code Erweiterungen“ mit ausgewählter Option „VSIX herunterladen“ für die GitHub Copilot-App-Modernisierungserweiterung.

  4. Übertragen Sie die VSIX-Datei auf den netzwerkbeschränkten Computer.

  5. Öffnen Sie auf dem netzwerkbeschränkten Computer die Ansicht „Erweiterungen“.

  6. Wählen Sie Ansichten und weitere Aktionen (...) und dann Aus VSIX installieren... aus.

    Screenshot der Ansicht „Visual Studio Code Erweiterungen“ mit ausgewählter Option „Installieren von VSIX“.

  7. Wählen Sie die übertragene VSIX-Datei aus.

AppCAT manuell installieren

Die Erweiterung kann AppCAT nicht automatisch herunterladen, ohne auf das öffentliche Netzwerk zuzugreifen. Installieren Sie AppCAT, bevor Sie eine Bewertung ausführen.

  1. Wechseln Sie auf dem verbundenen Computer zu AppCAT installieren, und laden Sie das Anwendungspaket herunter.

  2. Übertragen Sie die Paketdatei auf den netzwerkbeschränkten Computer.

  3. Extrahieren Sie das Paket nach ~/.appcat.

  4. Stellen Sie sicher, dass sich die ausführbare AppCAT-Datei an einem der folgenden Speicherorte befindet:

    • Fenster: ~/.appcat/appcat.exe
    • Linux oder macOS: ~/.appcat/appcat
  5. PATHZum System ~/.appcat hinzufügen.

  6. Starten Sie Visual Studio Code neu.

Note

Wenn die installierte AppCAT-Version nicht mit der von der Erweiterung erwarteten Version übereinstimmt, versucht die Erweiterung, eine andere Version herunterzuladen. Ohne Netzwerkzugriff schlägt der Download fehl, und die Bewertung scheint möglicherweise auf unbestimmte Zeit zu laufen. Installieren Sie das neueste AppCAT-Paket manuell, um das Problem zu beheben.

Hinzufügen eines benutzerdefinierten Sprachmodells

  1. Drücken Sie STRG+UMSCHALT+P , um die Befehlspalette zu öffnen.

  2. Führen Sie Chat: Sprachmodelle verwalten aus.

    Screenshot der Visual Studio Code-Befehlspalette mit ausgewähltem „Chat: Sprachmodelle verwalten“.

  3. Wählen Sie im Dialogfeld "Sprachmodelle " die Option " Modelle hinzufügen..." aus.

  4. Wählen Sie den Anbieter aus, der Ihrem Endpunkt entspricht. Wählen Sie z. B. Azure, OpenAI, OpenAI-kompatibel oder benutzerdefinierten Endpunkt aus.

  5. Geben Sie die Verbindungsdetails ein, die der Anbieter benötigt, einschließlich des Modellnamens, des API-Schlüssels und des Endpunkts.

  6. Stellen Sie sicher, dass das Modell unter Sprachmodelle angezeigt wird.

Wählen Sie das benutzerdefinierte Modell aus und testen Sie es.

  1. Öffnen Sie Chat in Visual Studio Code.

  2. Wählen Sie das benutzerdefinierte Modell aus der Liste Modell auswählen aus.

    Screenshot der Visual Studio Code Chatmodellauswahl mit ausgewähltem benutzerdefiniertem Ollama-Modell.

  3. Senden Sie eine Testnachricht, und stellen Sie sicher, dass das Modell antwortet.

    Screenshot, der den Visual Studio Code Chat mit einer Antwort des ausgewählten benutzerdefinierten Modells zeigt.

Konfigurieren der Dienstprogrammmodelle

Die GitHub Copilot-Modernisierungsfunktion verwendet die Einstellungen für das Dienstprogrammmodell von Visual Studio Code für integrierte Dienstprogrammflows.

  1. Öffnen Sie "Einstellungen".

  2. Suchen Sie nach chat.utility.

  3. Setze Chat: Utility Model auf das benutzerdefinierte Modell fest.

  4. Chat: Utility Small Model auf das benutzerdefinierte Modell festlegen.

    Ein Screenshot, der die Visual Studio Code Einstellungen mit dem benutzerdefinierten Modell zeigt, das für das Chat Utility Model und das Chat Utility Small Model ausgewählt ist.

Führen Sie eine Bewertung durch und erstellen Sie einen Plan

  1. Öffnen Sie GitHub Copilot Modernization.
  2. Wählen Sie "Bewertung starten" oder "Bewertungsdashboard öffnen" aus.
  3. Führen Sie die Bewertung aus, und öffnen Sie dann den Bewertungsbericht.
  4. Wählen Sie die Modernisierungsergebnisse aus, die Sie adressieren möchten.
  5. Wählen Sie Plan erstellen aus.

Die Erweiterung sendet die ausgewählten Einschätzungsergebnisse an Chat und ruft den Modernisierungs-Agent, Tools und Skills mit dem konfigurierten Modell auf.

Einschränkungen und bekannte Probleme

  • Die Sicherheitsbewertungsdomäne erfordert Netzwerkzugriff und ist in einer netzwerkbeschränkten Umgebung nicht verfügbar.
  • Scan & Resolve Security Issues erfordert Netzwerkzugriff.
  • AppCAT-Versionskonflikte können einen automatischen Download auslösen, der ohne öffentlichen Netzwerkzugriff fehlschlägt.
  • Die Ergebnisse hängen von den Funktionen des benutzerdefinierten Modells ab. Ein Modell, das die erforderlichen Tools oder Kontexte nicht unterstützt, schließt den Workflow möglicherweise nicht ab.
  • Das Konfigurieren eines benutzerdefinierten Modells bietet keine vollständige Netzwerkisolation. Verwenden Sie Netzwerksteuerelemente, um die Egress-Anforderungen Ihrer Organisation durchzusetzen.