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.
Importante
È necessario far parte del programma di anteprima Frontier per ottenere l'accesso early a Microsoft Agent 365. Frontier ti connette direttamente con le ultime innovazioni di intelligenza artificiale di Microsoft. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.
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.
Prerequisiti
Prima di iniziare, verificare di aver soddisfatto i prerequisiti seguenti:
- Registrazione dell'app client personalizzata: l'interfaccia della riga di comando richiede un'app client personalizzata nel tenant Microsoft Entra ID per l'autenticazione. Consulta Registrazione dell'app client personalizzata per istruzioni dettagliate di configurazione. Serve l'ID dell'applicazione (client) durante la configurazione.
- Azure sottoscrizione : accesso a una sottoscrizione Azure in cui è possibile creare risorse.
- Permessi richiesti - Il tuo account deve avere uno dei seguenti ruoli:
Nota
Durante il a365 config init passaggio (dopo l'installazione), la CLI valida automaticamente la registrazione della tua app client personalizzata controllando che l'app esista, abbia i permessi necessari e abbia il consenso amministratore concesso.
Suggerimento
Comandi CLI diversi richiedono ruoli o permessi differenti. Ogni pagina di riferimento di comando specifica il ruolo minimo richiesto. Ad esempio, consulta il setup riferimento del comando per i suoi requisiti specifici.
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.
Utilizzare l'installazione con strumento DotNet
Installa la CLI dell'Agent 365 usando il seguente comando con il --prerelease parametro:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
Importante
L'interfaccia della riga di comando di Agent 365 è ancora in anteprima. Fino a quando la CLI dell'Agent 365 non sarà generalmente disponibile, usa sempre il --prerelease parametro per ottenere l'ultima versione con le correzioni e le funzionalità più recenti. Quando la CLI dell'Agent 365 diventa generalmente disponibile, il --prerelease parametro non sarà più necessario.
Per le istruzioni più recenti e le versioni disponibili, visitare la pagina ufficiale di NuGet: Microsoft. Agents.A365.DevTools.Cli in 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 la CLI dell'Agente 365 usando il comando dotnet tool update con il parametro --prerelease :
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease
Nota
Per aggiornare l'interfaccia della riga di comando di Agent 365, è necessaria una connessione Internet per accedere al pacchetto NuGet più recente: 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:
| 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.
Risoluzione dei problemi
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:
-
Not found in NuGet feedsErrore durante l'installazione, l'aggiornamento o la disinstallazione - L'agente non appare in Teams
- Non si può creare un'istanza di agente in Teams
Not found in NuGet feeds Errore durante l'installazione, l'aggiornamento o la disinstallazione
Sintomo:microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json errore durante l'installazione, l'aggiornamento o la disinstallazione della CLI dell'Agent 365.
Soluzione: Usa il --prerelease parametro.
Tutte le versioni attuali della CLI sono versioni prerelease.
# For installation
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease
Per le istruzioni più recenti e le versioni disponibili, visitare la pagina ufficiale di NuGet: Microsoft. Agents.A365.DevTools.Cli in NuGet.org
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