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 manualmente l'interfaccia della riga di comando. La configurazione guidata dall'intelligenza artificiale verifica la presenza dell'interfaccia della riga di comando, installa o aggiorna automaticamente e esegue tutti i comandi necessari per conto dell'utente. Questa pagina è un riferimento per gli sviluppatori che devono installare o usare direttamente l'interfaccia della riga di comando, ad esempio durante la compilazione di automazione CI/CD, la risoluzione dei problemi di un passaggio specifico o l'uso senza un agente di codifica di intelligenza artificiale.
Note
Il flusso di lavoro per sviluppatori completo, tra cui la configurazione guidata tramite intelligenza artificiale, le linee guida per i ruoli e i passaggi post-distribuzione, è disponibile in Introduzione allo sviluppo di Agent 365. Questa pagina è il 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 versione successiva. Per tutti gli altri prerequisiti, ovvero sottoscrizione Azure, ruoli Entra necessari e registrazione di un'app client personalizzata, consultare Configurazione guidata dall'IA.
Installa la CLI 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
È necessario aver installato .NET. È consigliabile .NET 8.0.
Usare il comando dotnet tool install
Installare l'interfaccia della riga di comando di Agent 365 usando 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 la CLI di Agent 365, verifica che sia installata correttamente eseguendo il --help comando:
a365 -h
Questo comando visualizza le informazioni di aiuto e conferma che l'interfaccia della riga di comando è pronta per l'uso.
Aggiornamento
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
Note
Per aggiornare la CLI dell'Agent 365, è necessario una connessione internet per accedere all'ultimo pacchetto NuGet: Microsoft.Agents.A365.DevTools.Cli.
Disinstalla
Disinstalla Agent 365 CLI usando il comando dotnet tool uninstall:
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. Quindi puoi invocare strumenti globali da qualsiasi directory senza specificare la posizione dello strumento.
L'accesso agli strumenti è specifico dell'utente, non globale del computer. Uno strumento globale è disponibile solo per l'utente che lo installa.
Comandi disponibili
Per l'elenco completo dei comandi disponibili, usa il --help comando o consulta Agent 365 CLI Reference.
Suggerimento
Non è necessario eseguire manualmente i comandi dell'interfaccia della riga di comando. La configurazione guidata dall'intelligenza artificiale automatizza il flusso di lavoro completo, ovvero l'installazione dell'interfaccia della riga di comando, la configurazione, la configurazione del progetto, la distribuzione e la pubblicazione, usando un agente di codifica per intelligenza artificiale. Consulta qui la guida di riferimento per l'interfaccia della riga di comando se stai costruendo l'automazione CI/CD, per risolvere i problemi di un passaggio specifico o se si lavora senza un agente di codifica basato su intelligenza artificiale.
Per istruzioni complete su come configurare un agente agent 365 usando l'interfaccia della riga di comando, vedere Introduzione allo sviluppo di Agent 365.
Troubleshooting
Questa sezione fornisce informazioni su come risolvere errori con la CLI dell'Agente 365.
Suggerimento
La Guida alla risoluzione dei problemi dell'Agente 365 contiene raccomandazioni di alto livello, best practice e link a contenuti di risoluzione dei problemi per ogni fase del ciclo di sviluppo dell'Agente 365.
Questioni specifiche per la CLI trattate in questa sezione:
L'agente non appare in Teams
Risoluzione dei problemi delle istanze degli agenti: Un agente non appare in Teams
Non si può creare un'istanza di agente in Teams
Risoluzione problemi di creazione di istanze agenti: Non si può creare istanze agenti in Teams