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, assicurarsi di disporre degli elementi seguenti:

Nota

Durante il a365 config init passaggio (dopo l'installazione), la CLI convalida automaticamente la registrazione della tua app client personalizzata, verificando che l'app esista, abbia i permessi necessari e abbia il consenso amministratore concesso.

Suggerimento

Comandi CLI diversi possono richiedere 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 l'interfaccia della riga di comando di Agent 365, verifica che sia installata correttamente eseguendo:

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

Tutti gli aggiornamenti per la CLI dell'Agent 365 richiedono la 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

Questo percorso viene aggiunto al percorso dell'utente quando l'SDK viene eseguito 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

Aggiornamenti importanti

Comando rimosso: Il create-instance comando è stato rimosso dalla CLI. 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à in linea con il flusso di lavoro raccomandato.

Consulta Ciclo di Vita di Sviluppo Agent 365 per istruzioni complete su come configurare un agente Agent 365 utilizzando la CLI.

Risoluzione dei problemi

Questa sezione contiene informazioni su come risolvere gli errori con l'interfaccia della riga di comando di Agent 365.

L'installazione, aggiornamento o disinstallazione della CLI fallisce con Not found in NuGet feeds

Se ricevi un microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json errore, assicurati di usare il --prerelease parametro. Tutte le versioni attuali della CLI sono versioni prerelease.

Soluzione:

# 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:

Error: Command 'create-instance' not found

Causa: Il create-instance comando è stato rimosso dalla CLI. 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à in linea con il flusso di lavoro raccomandato.

Soluzione:

Usa il flusso di lavoro aggiornato:

  1. Pubblica il tuo agente:

    a365 publish

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

    Impara a configurare un progetto di agente nel Portale Sviluppatori di Teams

  3. Deploy su Azure (opzionale):

    # Only if hosting on Azure Web App
a365 deploy

  4. Crea un'istanza agente tramite Microsoft Teams:

    • Open Microsoft Teams
    • Naviga alle app
    • Cerca il tuo agente
    • Clicca su "Aggiungi" per creare un'istanza di agente

Per istruzioni dettagliate, vedi Agenti a bordo.

Agente che non appare nelle squadre

Sintomo: Dopo aver eseguito i comandi, l'agente non appare in Microsoft Teams.

Causa: Potresti aver saltato il publish passaggio o aver tentato di usare il comando rimosso create-instance .

Soluzione:

  1. Verifica di aver eseguito a365 publish con successo
  2. Attendere 5-10 minuti per la propagazione
  3. Controlla il Centro Amministrazione Microsoft 365: https://admin.cloud.microsoft/#/agents/all
  4. Crea un'istanza di agente tramite la sezione Apps di Teams

Non è possibile creare un'istanza dell'agente in Teams

Sintomo: L'agente appare in Teams ma non puoi creare un'istanza dell'agente (non puoi aggiungere l'agente).

Causa: La licenza "Microsoft Agent 365 Frontier" non è assegnata al tuo account utente.

  • Last updated on