Installare Agent Developer Kit con GitHub Codespaces

  • Si applica a: ✅ Microsoft Copilot

GitHub Codespaces offre un Visual Studio Code ospitato nel cloud nel browser, con il kit preinstallato. Non si installa nulla nel proprio computer. L'intero passaggio richiede circa 5 minuti.

Usare Codespaces quando:

  • Non è possibile installare il software in locale (dispositivo gestito dall'azienda, ambiente bloccato).
  • Si usa macOS, Linux o qualsiasi computer non Windows.
  • Si vuole provare il kit prima di decidere se installarlo in locale.

Prima di iniziare

Hai bisogno:

  • Un account GitHub con una sottoscrizione di GitHub Copilot attiva.
  • Un browser moderno.

Codespaces include un livello gratuito di 120 core-hours al mese (60 ore nel computer a 2 core usato dal kit). Codespace viene sospeso automaticamente dopo 30 minuti di inattività, quindi viene addebitato solo il tempo che si sta lavorando attivamente.

Se l'account GitHub fa parte di un'organizzazione e Codespaces non è disponibile, l'amministratore potrebbe dover abilitarlo. Vedere Gestione degli spazi di codice per l'organizzazione.

Creare lo spazio di codice

  1. Aprire questo collegamento nel browser:

    https://github.com/codespaces/new?repo=microsoft/Employee-Self-Service-Agent-Developer-Kit& ref=main&devcontainer_path=.devcontainer%2Fdevcontainer.json

  2. Se richiesto, accedere a GitHub.

  3. Nella pagina Crea spazio di codice lasciare le impostazioni predefinite e selezionare il tipo di computer a 2 core .

  4. Selezionare Crea spazio di codice.

GitHub compila codespace. La prima compilazione richiede alcuni minuti perché installa Python, le dipendenze del kit e le estensioni GitHub Copilot. Gli avvii successivi dello stesso codespace sono più veloci.

Aprire la cartella corretta

Al termine della compilazione di Codespace, visualirai VS Code nel browser nella radice del repository. I comandi del kit funzionano solo quando ess-maker-skills è la radice dell'area di lavoro.

  1. Dal menu selezionare Apri cartella file>.
  2. Immettere /workspaces/Employee-Self-Service-Agent-Developer-Kit/solutions/ess-maker-skills.
  3. Selezionare OK.

VS Code viene ricaricato con la cartella corretta aperta.

Dovrebbe essere visualizzato

Il riquadro Esplora risorse viene visualizzato ESS-MAKER-SKILLS nella parte superiore, con queste cartelle direttamente sotto:

ESS-MAKER-SKILLS
  .github
  .vscode
  scripts
  src

Se in Esplora risorse viene visualizzato il nome completo del repository nella parte superiore con cartelle aggiuntive come samples, solutionse tests, è stata aperta la cartella errata. Selezionare di nuovoApri cartellafile> e usare il percorso nella sezione precedente.

Il kit chiede al modello di rilevare gli strumenti, seguire le istruzioni in più passaggi e scrivere YAML valido. Non tutti i modelli ese ano altrettanto bene queste azioni.

Aprire il riquadro Copilot Chat (l'icona Chat sulla barra delle attività). Nella parte superiore del riquadro della chat è presente una selezione modello. Scegliere un modello di frontiera corrente da una di queste famiglie:

Famiglia di modelli Motivo
Claude Sonnet (ultima versione disponibile) Consigliato. Rilevamento affidabile degli strumenti e istruzioni in più passaggi.
Claude Opus (più recente disponibile) Consigliato. Gli stessi punti di forza di Sonnet; qualità superiore, leggermente più lenta.
OpenAI Codex o classe GPT-5 (versione più recente disponibile) Consigliato. Funziona bene per i flussi di configurazione del kit.

Nota

I modelli nel selettore cambiano nel tempo man mano che vengono fornite nuove versioni. Selezionare la versione più recente disponibile in una delle famiglie elencate in precedenza anziché un numero di versione esatto.

Se nessuna di queste famiglie viene visualizzata nella selezione, potrebbe non essere abilitata dall'organizzazione. Scegliere l'equivalente più vicino. Se il kit in un secondo momento segnala che non è in grado di trovare i relativi strumenti, la correzione più comune consiste nel passare a un modello consigliato.

Gestire lo spazio di codice

È possibile arrestare, riavviare ed eliminare codespace da github.com/codespaces. Il lavoro viene salvato tra le sessioni. Al termine del kit, eliminare lo spazio di codice per liberare la quota di archiviazione.

Passaggio successivo

Continuare con Esegui il primo comando.

Se codespace non ha compilato o non apre la cartella corretta, vedere Risolvere i problemi iniziali.

  • Last updated on