Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'interfaccia della riga di comando di Agent 365 è uno strumento da riga di comando multipiattaforma per la distribuzione e la gestione delle applicazioni di Agent 365 in Azure.
Non è necessario installare l'interfaccia della riga di comando manualmente. La procedura guidata dall'IA verifica la presenza dell'interfaccia della riga di comando, la installa o la aggiorna automaticamente, ed esegue tutti i comandi necessari al posto tuo. Questa pagina è un riferimento per gli sviluppatori che devono installare o utilizzare direttamente l'interfaccia della riga di comando, ad esempio per implementare l'automazione CI/CD, risolvere un passaggio specifico o lavorare senza un agente di codifica AI.
Nota
L'intero flusso di lavoro dello sviluppatore – inclusa la configurazione guidata dall'IA, la guida ai ruoli e le fasi successive alla distribuzione – è disponibile nella pagina Introduzione allo sviluppo con Agent 365. Questa pagina è la guida di riferimento all'interfaccia della riga di comando: installazione, aggiornamento, disinstallazione, comandi disponibili e risoluzione dei problemi.
Prerequisiti
L'interfaccia della riga di comando richiede .NET 8.0 o versioni successive. Per tutti gli altri prerequisiti – abbonamento Azure, ruoli Entra richiesti e registrazione di app client personalizzata – vedi AI-guided setup.
Installa l'interfaccia della riga di comando di Agent 365
Usa la procedura seguente per installare l'interfaccia della riga di comando di Agent 365 a livello globale nel sistema operativo.
Prerequisiti
Devi avere .NET installato. .NET 8.0 è consigliato.
Utilizzare l'installazione con strumento DotNet
Installa l'interfaccia della riga di comando di Agent 365 utilizzando il comando seguente:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
Per le istruzioni più recenti e le versioni disponibili, visitare la pagina ufficiale di NuGet: Microsoft.Agents.A365.DevTools.Cli su NuGet.org
Verifica l'installazione
Dopo aver installato l'interfaccia della riga di comando di Agent 365, verifica che sia installata correttamente eseguendo il comando --help:
a365 -h
Questo comando visualizza le informazioni della Guida e conferma che l'interfaccia della riga di comando è pronta per l'uso.
Update
Aggiorna l'interfaccia della riga di comando di Agent 365 usando il comando di aggiornamento dello strumento DotNet :
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Nota
Per aggiornare l'interfaccia della riga di comando di Agent 365 è necessaria la connessione Internet per accedere al pacchetto NuGet più recente: Microsoft.Agents.A365.DevTools.Cli.
Disinstalla
Disinstalla l'interfaccia della riga di comando di Agent 365 usando il comando di disinstallazione dello strumento DotNet:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
Percorsi dei file
Il percorso predefinito per il file eseguibile di uno strumento dipende dal sistema operativo:
| OS | Percorso |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
L'SDK aggiunge questa posizione al tuo percorso quando lo esegui per la prima volta. Gli strumenti globali possono quindi essere richiamati da qualsiasi directory senza specificare il percorso dello strumento.
L'accesso agli strumenti è specifico dell'utente, non globale del computer. Uno strumento globale è disponibile solo per l'utente che lo ha installato.
Comandi disponibili
Per l'elenco completo dei comandi disponibili, usa il comando --help o vedi Informazioni di riferimento sull'interfaccia della riga di comando di Agent 365.
Suggerimento
Non è necessario eseguire manualmente i comandi dell'interfaccia della riga di comando. Il comando AI-guided setup automatizza l’intero flusso di lavoro: installazione dell'interfaccia della riga di comando, configurazione, preparazione dei progetti, distribuzione e pubblicazione, utilizzando un agente di codifica IA. Utilizza questo riferimento all'interfaccia della riga di comando se stai creando automazione CI/CD, risolvendo problemi relativi a una fase specifica o lavorando senza un agente di codifica IA.
Per istruzioni complete su come configurare un agente di Agent 365 utilizzando l'interfaccia della riga di comando, consulta Introduzione allo sviluppo di Agent 365.
Risoluzione dei problemi
Questa sezione fornisce informazioni su come risolvere gli errori con l'interfaccia della riga di comando di Agent 365.
Suggerimento
Guida alla risoluzione dei problemi di Agent 365 contiene raccomandazioni di alto livello per la risoluzione dei problemi, procedure consigliate e collegamenti a contenuti di risoluzione dei problemi per ogni fase del ciclo di vita dello sviluppo di Agent 365.
Questioni specifiche dell'interfaccia della riga di comando trattate in questa sezione:
L'agente non appare in Teams
Risoluzione dei problemi delle istanze degli agenti: Un agente non appare in Teams