Condividi tramite

Informazioni di riferimento sul comando dell'interfaccia della riga di comando di Agent 365 setup

Importante

Devi far parte del programma Frontier preview per ottenere l'accesso anticipato a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette ai termini di anteprima esistenti dei tuoi accordi con il cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la loro disponibilità e capacità potrebbero cambiare nel tempo.

Configurare l'ambiente Agent 365 con un controllo granulare su ogni passaggio. Questo comando gestisce il flusso di lavoro di installazione iniziale per i progetti agent 365.

Ruolo minimo obbligatorio:Amministratore globale + di Azure

Sintassi

a365 setup [command] [options]

Options

Opzione Description
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

In alternativa, eseguire tutti i passaggi contemporaneamente:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

Convalidare i prerequisiti per l'installazione di Agent 365. Esegue controlli dei requisiti modulari e fornisce indicazioni per eventuali problemi rilevati.

a365 setup requirements [options]

Questo comando esegue i passaggi seguenti:

  • Controlla tutti i prerequisiti necessari per l'installazione di Agent 365.
  • Segnala eventuali problemi con indicazioni dettagliate sulla risoluzione.
  • Continua a controllare tutti i requisiti anche se alcuni controlli hanno esito negativo.
  • Fornisce un riepilogo di tutti i controlli alla fine.

Opzioni requirements

Opzione Description
-c, --config <config> Percorso del file di configurazione. Il valore predefinito è a365.config.json.
-v, --verbose Mostra l'output dettagliato per tutti i controlli.
--category <category> Esegue controlli solo per una categoria specifica, ad esempio "Azure", "Autenticazione" o "Configurazione".
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.

setup infrastructure

Creare un'infrastruttura di Azure.

Autorizzazioni minime necessarie: Collaboratore o Proprietario della sottoscrizione di Azure

a365 setup infrastructure [options]

Opzioni infrastructure

Opzione Description
-c, --config <config> Percorso del file di configurazione. Il valore predefinito è a365.config.json.
-v, --verbose Mostra output dettagliato.
--dry-run Mostra cosa sarebbe stato fatto senza eseguire.
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.

setup blueprint

Creare un progetto agente (registrazione dell'applicazione Entra ID).

Autorizzazioni minime necessarie: ruolo sviluppatore ID agente

a365 setup blueprint [options]

Opzioni blueprint

Opzione Description
-c, --config <config> Percorso del file di configurazione. Il valore predefinito è a365.config.json.
-v, --verbose Mostra output dettagliato.
--dry-run Mostra cosa sarebbe stato fatto senza eseguire.
--no-endpoint Non registrare l'endpoint di messaggistica (solo progetto)
--endpoint-only Registrare solo l'endpoint di messaggistica. Richiede un progetto esistente
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.

setup permissions

Configurare le autorizzazioni OAuth2 concede ed ereditabili le autorizzazioni.

Autorizzazioni minime necessarie: Amministratore globale

a365 setup permissions [command] [options]

Options

Opzione Description
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.

Sottocomandi

  • mcp - Configurare il server MCP OAuth2 concede ed eredita autorizzazioni ereditabili
  • bot - Configurare l'API bot di messaggistica OAuth2 concede ed eredita autorizzazioni ereditabili

setup permissions mcp

Configurare il server MCP OAuth2 concede e eredita autorizzazioni ereditabili.

Autorizzazioni minime necessarie: Amministratore globale

a365 setup permissions mcp [options]

Opzioni permissions mcp

Opzione Description
-c, --config <config> Percorso del file di configurazione. Il valore predefinito è a365.config.json.
-v, --verbose Mostra output dettagliato.
--dry-run Mostra cosa sarebbe stato fatto senza eseguire.
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.

setup permissions bot

Configurare l'API bot di messaggistica OAuth2 concede e eredita autorizzazioni ereditabili.

Autorizzazioni minime necessarie: Amministratore globale

Prerequisiti: autorizzazioni blueprint e MCP (esecuzione a365 setup permissions mcp prima)

Passaggio successivo: Distribuire l'agente (eseguire a365 deploy se l'hosting in Azure)

a365 setup permissions bot [options]

Opzioni permissions bot

Opzione Description
-c, --config <config> Percorso del file di configurazione. Il valore predefinito è a365.config.json.
-v, --verbose Mostra output dettagliato.
--dry-run Mostra cosa sarebbe stato fatto senza eseguire.
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.

setup all

Eseguire tutti i passaggi di installazione per configurare l'ambiente Agent 365

a365 setup all [options]

Esegue l'installazione completa di Agent 365, tutti i passaggi in sequenza.

Include: infrastruttura, progetto, autorizzazioni ed endpoint.

Autorizzazioni minime necessarie (l'amministratore globale dispone di tutte queste autorizzazioni):

  • Collaboratore sottoscrizione di Azure (per infrastruttura ed endpoint)
  • Ruolo sviluppatore ID agente (per la creazione del progetto)
  • Amministratore globale (per le concessioni di autorizzazioni e il consenso amministratore)

Opzioni setup all

Opzione Description
-c, --config <config> Percorso del file di configurazione. Il valore predefinito è a365.config.json.
-v, --verbose Mostra output dettagliato.
--dry-run Mostra cosa sarebbe stato fatto senza eseguire.
--skip-infrastructure Ignorare la creazione dell'infrastruttura di Azure (usare se l'infrastruttura esiste già). Questa opzione crea ancora: Progetto, Autorizzazioni ed Endpoint.
--skip-requirements Ignorare il controllo di convalida dei requisiti. Prestare attenzione: l'installazione potrebbe non riuscire se i prerequisiti non sono soddisfatti.
-?, -h, --help Mostra informazioni sulla Guida e sull'utilizzo.
  • Last updated on