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 la CLI manualmente.Agent 365 Skill controlla la CLI, installa o aggiorna automaticamente e esegue tutti i comandi necessari per tuo conto. Questo articolo è un riferimento per gli sviluppatori che devono installare o utilizzare direttamente la CLI - ad esempio, quando si costruisce automazione CI/CD, si lavora per risolvere problemi di un passaggio specifico o si lavora senza un agente di codifica AI.
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 - abbonamento Azure, ruoli Entra obbligatori e registrazione personalizzata dell'app client - vedi Avvio Rapido: Collega un agente esistente all'Agente 365.
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.
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
Note
Per aggiornare la CLI dell'Agent 365, è necessario una connessione internet per accedere all'ultimo pacchetto NuGet: Microsoft.Agents.A365.DevTools.Cli.
Uninstall
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:
| Sistema operativo | 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.
Tip
Non è necessario eseguire manualmente i comandi dell'interfaccia della riga di comando. Le competenze di Agent 365 automatizzano l'intero flusso di lavoro - installazione, configurazione della CLI, configurazione, distribuzione e pubblicazione dei blueprint - utilizzando un agente di codifica AI. 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.
Tip
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