Vai al contenuto

Assistente IA per VS Code

GitHub Copilot Chat in Visual Studio Code consente di registrare modelli linguistici personalizzati tramite Manage Language Models. Questa guida mostra come collegare VS Code direttamente alla nostra Everyware AI API svizzera — chattate con i nostri modelli, generate codice e utilizzate la modalità agente senza che i vostri dati lascino la Svizzera.

Funzionalità principali

  • Integrazione nativa nell'IDE: Chattate direttamente in VS Code (Ctrl+Alt+I) — non servono terminali o strumenti separati.
  • Chiamata di strumenti: Il modello può leggere file, applicare modifiche ed eseguire comandi nel terminale (modalità agente).
  • Contesto esteso: Fino a 128.000 token di input — sufficienti per conversazioni estese all'intero repository.
  • Sovranità completa dei dati: Tutti i prompt e il codice sorgente vengono elaborati esclusivamente sulla nostra infrastruttura GPU svizzera.

Prerequisiti

  • VS Code (versione corrente) con l'estensione GitHub Copilot Chat.
  • Una chiave API personale per l'Everyware AI API (formato sk-bf-...). Se non ne disponete ancora, richiedete una chiave virtuale tramite il Cloud Service Portal o il nostro team di supporto.

Gestite le chiavi API con cautela

Non inserite mai la vostra chiave API in un repository. VS Code memorizza la chiave come segreto e la referenzia tramite un segnaposto ${input:...} — mantenete questo comportamento.

1. Aggiungere il modello

  1. Aprite la tavolozza dei comandi: Ctrl+Shift+P
  2. Selezionate Chat: Manage Language Models
  3. Scegliete Add Models → Custom Endpoint
  4. Inserite le vostre credenziali:
    • Group Name: EW
    • API Key: la vostra chiave personale (sk-bf-...)

2. Configurazione

Il modello viene registrato come provider Chat Completions con la seguente configurazione:

[
    {
        "name": "everyware",
        "vendor": "customendpoint",
        "apiKey": "${input:chat.lm.secret.xxxxxx}",
        "apiType": "chat-completions",
        "models": [
            {
                "id": "ew/flagship",
                "name": "Flagship Model",
                "url": "https://ai.ewcs.ch/v1/chat/completions",
                "toolCalling": true,
                "vision": false,
                "maxInputTokens": 128000,
                "maxOutputTokens": 16000
            }
        ]
    }
]

Parametri di configurazione

Parametro Valore Descrizione
name everyware Nome visualizzato del provider in VS Code
vendor customendpoint Tipo di provider (endpoint compatibile con OpenAI)
apiKey ${input:...} Riferimento al segreto memorizzato nel passaggio 1 — nessuna chiave codificata
apiType chat-completions Protocollo dell'endpoint
id ew/flagship Identificatore del modello per l'API
url https://ai.ewcs.ch/v1/chat/completions Endpoint dell'API
toolCalling true Abilita le funzionalità dell'agente (accesso ai file, terminale)
vision false L'input di immagini non è supportato
maxInputTokens 128000 Dimensione massima del contesto
maxOutputTokens 16000 Lunghezza massima della risposta

3. Aprire la chat

Aprite il pannello della chat con Ctrl+Alt+I, selezionate Flagship Model nel selettore del modello — fatto!

Proxy aziendale

Nelle reti aziendali, VS Code raggiunge tipicamente ai.ewcs.ch tramite un proxy HTTP. VS Code utilizza lo stesso stack di rete di Chrome e riprende automaticamente le impostazioni proxy dal vostro sistema operativo — se il proxy del sistema è configurato correttamente, non è necessaria alcuna configurazione aggiuntiva.

Per configurare il proxy in modo esplicito, avviate VS Code con un argomento da riga di comando:

code --proxy-server=http://proxy.example.com:8080

oppure impostate il proxy nel vostro settings.json:

{
    "http.proxy": "http://proxy.example.com:8080",
    "http.proxySupport": "override"
}

I proxy autenticati (Basic, NTLM, Negotiate) sono supportati — VS Code mostra una richiesta di accesso quando il proxy richiede credenziali.

Ispezione TLS / certificati personalizzati

Se la vostra azienda utilizza l'ispezione TLS o una propria autorità di certificazione, aggiungete il certificato CA all'archivio attendibile del vostro sistema operativo — VS Code lo considererà automaticamente affidabile:

  • Windows / macOS: Importate il certificato tramite il gestore dei certificati di sistema.
  • Linux: Copiate il certificato in /usr/local/share/ca-certificates/ ed eseguite sudo update-ca-certificates (Ubuntu/Debian), oppure inseritelo in /etc/pki/ca-trust/source/anchors/ ed eseguite sudo update-ca-trust (RHEL/Fedora).

Non disattivate mai i controlli sui certificati

Non aggirate l'ispezione TLS con l'opzione --ignore-certificate-errors né disattivando la validazione dei certificati — ciò esporrebbe la vostra chiave API e i prompt all'intercettazione. Chiedete invece al vostro team IT il certificato CA ufficiale.

Prompt e flussi di lavoro tipici

  • Analisi del codice: "Explain the architecture of this repository and show me where the API calls are made."
  • Refactoring: "Optimize error handling in this module and add unit tests."
  • Modalità agente: "Run the linter and fix all reported syntax errors."

Alternativa: OpenCode Agent

Preferite lavorare nel terminale? L'OpenCode Agent offre la stessa integrazione con l'Everyware AI API con flussi di lavoro multi-agente e routing intelligente dei modelli.

Ultimo aggiornamento: settembre 2026