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 l'interfaccia della riga di comando di Agent 365 utilizzando il comando seguente:

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

Se ricevi un microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json errore, usa il --prerelease parametro perché questo pacchetto potrebbe comunque essere etichettato come prerelease.

dotnet tool install --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

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

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.

Usa invece questo flusso di lavoro:

  1. a365 publish - Pubblica l'agente nel centro di amministrazione Microsoft 365
  2. Configura il blueprint dell'agente nel Portale Sviluppatori - Vedi Configura il blueprint dell'agente nel Portale Sviluppatori
  3. a365 deploy - Distribuire su Azure (opzionale, solo se si utilizza l'hosting Azure)
  4. Crea un'istanza di agente tramite Microsoft Teams

Vedi Agenti a bordo per istruzioni complete.

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, usa il --prerelease parametro perché questo pacchetto potrebbe comunque essere etichettato come 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:

    Consulta Configura il progetto dell'agente nel Portale Sviluppatori per istruzioni dettagliate.

  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