Installare Agent Developer Kit con il programma di installazione one-shot

  • Si applica a: ✅ Microsoft Copilot

Il programma di installazione one-shot è il modo più veloce per far funzionare il kit in un computer Windows. Un comando installa Visual Studio Code, Python, Git, PowerShell 7 e l'interfaccia della riga di comando di GitHub, clona il kit, installa l'estensione GitHub Copilot Chat e apre la cartella corretta in VS Code. L'intero passaggio richiede circa 10 minuti, la maggior parte dei quali è stata spesa per i download.

Nota

Il programma di installazione one-shot è solo Windows. Se si usa macOS o Linux o non è possibile installare il software in locale, usare GitHub Codespaces.

Prima di iniziare

Hai bisogno:

  • Un computer Windows 10 o Windows 11 in cui è possibile installare il software.
  • Un account GitHub con una sottoscrizione di GitHub Copilot attiva. Se non si è certi, l'amministratore può confermare nelle impostazioni dell'organizzazione di GitHub.
  • Autorizzazione per eseguire PowerShell con accesso a Internet.

Eseguire il programma di installazione

  1. Aprire PowerShell (tasto Windows, digitare powershell, selezionare Windows PowerShell).

  2. Incollare questo comando e selezionare INVIO:

    iex (irm https://raw.githubusercontent.com/microsoft/Employee-Self-Service-Agent-Developer-Kit/main/setup/bootstrap.ps1)

Il programma di installazione stampa ciò che sta per fare, quindi esegue i passaggi. È possibile che vengano visualizzati prompt di Windows che richiedono di confermare le installazioni software. Approvare ognuno di essi.

Operazioni eseguite dal programma di installazione

Durante l'esecuzione, il programma di installazione:

  • Installa Visual Studio Code, Python 3.12, Git, interfaccia della riga di comando di GitHub e PowerShell 7 usando winget. Gli strumenti già installati vengono ignorati.
  • Installa i pacchetti Python necessari per il kit.
  • Clona il repository Employee Self-Service Agent Developer Kit nella cartella utente.
  • Installa le estensioni GitHub Copilot, chat GitHub Copilot e Python in Visual Studio Code.
  • Apre VS Code nella solutions/ess-maker-skills cartella.

Il programma di installazione è idempotente. Se qualcosa lo interrompe, eseguire di nuovo lo stesso comando. Riprende da dove si è interrotto e ignora il lavoro già fatto.

Accedere a GitHub Copilot

All'apertura di VS Code, nell'angolo inferiore destro viene visualizzata una richiesta di accesso per GitHub Copilot.

  1. Selezionare Accedi a GitHub.
  2. Il browser si apre su GitHub.
  3. Autorizzare VS Code a usare l'account GitHub.
  4. Il browser restituisce VS Code. L'icona dell'account in basso a sinistra mostra ora il nome utente di GitHub.

Se Visual Studio Code segnala che l'account non ha accesso a Copilot, confermare la sottoscrizione all'indirizzo github.com/settings/copilot.

Dovrebbe essere visualizzato

Al termine del programma di installazione:

  • VS Code è aperto con ESS-MAKER-SKILLS nella parte superiore del riquadro Esplora risorse.
  • Explorer mostra .github, .vscode, scriptse src come cartelle principali.
  • Il riquadro Copilot Chat è disponibile dalla barra delle attività a sinistra.

Se Esplora risorse viene visualizzato EMPLOYEE-SELF-SERVICE-AGENT-DEVELOPER-KIT nella parte superiore con cartelle aggiuntive (samples, solutions, tests), il programma di installazione ha aperto la cartella errata. Chiudere l'area di lavoro e riaprire solutions/ess-maker-skills.

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.

Passaggio successivo

Continuare con Esegui il primo comando.

Se il programma di installazione non è stato completato, vedere Risolvere i problemi iniziali.

  • Last updated on