Condividi tramite

Interfaccia della riga di comando di Agent 365

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. 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:

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 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 la CLI dell'Agent 365 usando il seguente comando con il --prerelease parametro:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Importante

La CLI dell'Agente 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 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 della Guida e conferma che l'interfaccia della riga di comando è pronta per l'uso.

Update

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 la CLI dell'Agent 365, è necessario una connessione internet per accedere all'ultimo pacchetto NuGet: 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. 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.

Aggiornamenti importanti

Comando rimosso: Il CLI ha rimosso il create-instance comando. Ha bypassato i passaggi di registrazione necessari, limitando la funzionalità dell'agente. Questo comando potrebbe essere reintrodotto in una versione successiva, una volta che sarà all'altezza del flusso di lavoro raccomandato.

Per istruzioni complete su come configurare un agente Agent 365 utilizzando la CLI, vedi Ciclo di Vita dello Sviluppo dell'Agente 365.

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 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 su NuGet.org

Comando create-instance non trovato

Sintomo: Vedi l'errore Command 'create-instance' not found .

Causa: Il CLI ha rimosso il create-instance comando. Ha bypassato i passaggi di registrazione necessari, limitando la funzionalità dell'agente. Il team di sviluppo potrebbe reintrodurre questo comando in una versione successiva, una volta che sarà in linea con il flusso di lavoro raccomandato.

Soluzione: Usa invece i seguenti passaggi:

  1. Pubblica il tuo agente: Usa il comando a365 pubblica.

    a365 publish

  2. Configura il blueprint dell'agente nel Portale Sviluppatori:

    Impara a configurare un blueprint di agente nel Portale Sviluppatori di Teams.

  3. Deploy su Azure (opzionale): Usa il comando deploy a365.

    # Only if hosting on Azure Web App
a365 deploy

  4. Crea un'istanza agente tramite Microsoft Teams:

    1. Apri Microsoft Teams.
    2. Vai ad App.
    3. Cerca il tuo agente.
    4. Seleziona Aggiungi per creare un'istanza agente.

Per istruzioni dettagliate, vedi Agenti a bordo.

L'agente non appare in Teams

Risoluzione problemi di istanze di creare agenti: L'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

  • Last updated on