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

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 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:Sviluppatore dell'ID agente collaboratore + di Azure

Annotazioni

Il ruolo che si mantiene determina la quantità di completamento dell'installazione in una singola esecuzione. L'amministratore globale può completare tutti i passaggi contemporaneamente. L'amministratore dell'ID agente e lo sviluppatore dell'ID agente possono completare tutti i passaggi tranne le concessioni di autorizzazione OAuth2 (consenso amministratore), che richiedono un passaggio separato da un amministratore globale. Per altre informazioni sul flusso di lavoro di handoff, vedere setup admin.

Sintassi

a365 setup [command] [options]

Options

Opzione	Description
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e utilizzo.

Ordine di esecuzione consigliato

# 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

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

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

Se si esegue come amministratore dell'ID agente o id agente sviluppatore (non amministratore globale), a365 setup all completa tutti i passaggi tranne le concessioni di autorizzazione OAuth2. Al termine, un amministratore globale deve completare le concessioni:

# Non-admin path: run setup, then hand off to Global Administrator
a365 setup all

# Global Administrator completes OAuth2 grants
a365 setup admin --config-dir "<path-to-config-folder>"

`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`, `Authentication` o `Configuration`.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e utilizzo.

`setup infrastructure`

Creare Azure'infrastruttura.

autorizzazioni necessarie Minimum: collaboratore o proprietario della sottoscrizione 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`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e 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`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`--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 di aiuto e 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 di aiuto e utilizzo.

Sottocomandi

Subcommand	Description
`mcp`	Configurare il server MCP OAuth2 concede e eredita autorizzazioni ereditabili.
`bot`	Configurare l'API bot di messaggistica OAuth2 concede e eredita autorizzazioni ereditabili.
`custom`	Applica le autorizzazioni API personalizzate al progetto agente che superano le autorizzazioni standard necessarie per l'operazione dell'agente.
`copilotstudio`	Configura le autorizzazioni OAuth2 concede ed eredita le autorizzazioni ereditabili per il progetto agente per richiamare i copiloti di Copilot Studio tramite l'API Power Platform.

`setup permissions mcp`

Configurare il server MCP OAuth2 concede e eredita autorizzazioni ereditabili.

Autorizzazioni minime necessarie: Amministratore globale

a365 setup permissions mcp [options]

Questo comando:

ToolingManifest.json Legge dall'oggetto deploymentProjectPath specificato in a365.config.json.
Concede le concessioni di autorizzazioni delegate OAuth2 per ogni ambito del server MCP al progetto agente.
Configura le autorizzazioni ereditabili in modo che le istanze dell'agente possano accedere agli strumenti MCP.
È idempotente e sicuro da eseguire più volte.

Importante

Prima di eseguire questo comando, eseguire a365 config display per verificare che deploymentProjectPath punti alla cartella del progetto contenente l'oggetto aggiornato ToolingManifest.json. Se lo sviluppatore aggiunge server MCP in un computer diverso, condividere prima l'aggiornamento ToolingManifest.json con l'amministratore globale. L'esecuzione senza la correzione ToolingManifest.json non aggiunge le nuove autorizzazioni del server MCP al progetto.
Eseguire questo comando dopo che lo sviluppatore esegue a365 develop add-mcp-servers. L'aggiunta di server MCP al manifesto e la concessione delle autorizzazioni al progetto sono due passaggi distinti. Al termine di questo comando, le autorizzazioni del server MCP sono visibili nel progetto agente.

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`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e 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 si ospita 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`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e utilizzo.

`setup permissions custom`

Applica le autorizzazioni API personalizzate al progetto agente che superano le autorizzazioni standard necessarie per l'operazione dell'agente. Usando questo comando, si concede all'agente l'accesso ad altri ambiti di Microsoft Graph, ad esempio Presenza, File e Chat o alle API personalizzate registrate nel tenant microsoft Entra ID dell'organizzazione.

Autorizzazioni minime necessarie: Amministratore globale

Prerequisiti: eseguire a365 setup blueprint prima. Aggiungere autorizzazioni personalizzate a a365.config.json usando a365 config permissions prima di eseguire questo comando.

a365 setup permissions custom [options]

Questo comando:

Configura le concessioni di autorizzazioni delegate OAuth2 con il consenso amministratore per ogni risorsa configurata.
Imposta le autorizzazioni ereditabili in modo che gli utenti dell'agente possano ereditare l'accesso dal progetto.
Riconcilia Microsoft Entra con la configurazione corrente aggiungendo nuove autorizzazioni e rimuovendo le autorizzazioni eliminate dalla configurazione.
È idempotente e sicuro da eseguire più volte.

Opzioni `permissions custom`

Opzione	Description
`-c`, `--config <config>`	Percorso del file di configurazione. Il valore predefinito è `a365.config.json`.
`-v`, `--verbose`	Mostra output dettagliato.
`--dry-run`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e utilizzo.

Configurare autorizzazioni personalizzate

Usare a365 config permissions per aggiungere autorizzazioni personalizzate alla configurazione prima di eseguire questo comando:

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Durante l'installazione, il nome della risorsa viene risolto automaticamente da Azure. Non è necessario specificarlo nella configurazione.

Rimuovere autorizzazioni personalizzate

Per rimuovere le autorizzazioni personalizzate sia dalla configurazione che dalla Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integrazione con `setup all`

Quando la configurazione include autorizzazioni personalizzate, l'esecuzione a365 setup all li configura automaticamente come parte di una singola fase di autorizzazione batch. L'ordine di installazione completo è:

Infrastruttura
Progetto
Batch di autorizzazioni (MCP, API Bot, autorizzazioni di progetto personalizzate, tutte configurate insieme)

`setup permissions copilotstudio`

Configura le autorizzazioni OAuth2 concede ed eredita le autorizzazioni ereditabili per il progetto agente per richiamare i copiloti di Copilot Studio tramite l'API Power Platform.

Autorizzazioni minime necessarie: Amministratore globale

Prerequisiti: eseguire a365 setup blueprint prima.

a365 setup permissions copilotstudio [options]

Questo comando:

Garantisce che l'entità servizio DELL'API Power Platform esista nel tenant.
Crea una concessione di autorizzazione OAuth2 dal progetto all'API power platform con l'ambito CopilotStudio.Copilots.Invoke .
Imposta le autorizzazioni ereditabili in modo che le istanze dell'agente possano richiamare Copilot copiloti di Studio.

Opzioni `permissions copilotstudio`

Opzione	Description
`-c`, `--config <config>`	Percorso del file di configurazione. Il valore predefinito è `a365.config.json`.
`-v`, `--verbose`	Mostra output dettagliato.
`--dry-run`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e utilizzo.

Usare questo comando quando l'agente deve richiamare i copiloti di Copilot Studio in fase di esecuzione o chiamare le API di Power Platform che richiedono le autorizzazioni di CopilotStudio.

`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 e autorizzazioni.

I passaggi completati dipendono dal ruolo:

Passo	Amministratore globale	Amministratore dell'ID agente	Sviluppatore di ID Agente
Verifica dei prerequisiti	Sì	Sì	Sì
Infrastruttura di Azure	Sì	Sì	Sì
Creazione del progetto agente	Sì	Sì	Sì
Autorizzazioni ereditabili	Sì	Sì	Sì
Concessioni di autorizzazione OAuth2 (consenso amministratore)	Sì	Richiede il passaggio ga	Richiede il passaggio ga

Quando si esegue a365 setup all senza amministratore globale, l'interfaccia della riga di comando:

Completa tutti i passaggi che può eseguire (infrastruttura, creazione del progetto e autorizzazioni ereditabili).
Genera URL di consenso per amministratore per risorsa e li salva in a365.generated.config.json.
Visualizza i passaggi successivi che illustrano come un amministratore globale può completare le concessioni OAuth2 usando a365 setup admin o gli URL di consenso generati.

Suggerimento

Se si è un amministratore globale, a365 setup all completa tutti gli elementi in un'unica esecuzione senza alcun passaggio.

Autorizzazioni minime richieste:

Collaboratore o proprietario della sottoscrizione di Azure (per l'infrastruttura)
Ruolo sviluppatore ID agente (per la creazione del progetto)
Amministratore globale (per le concessioni di autorizzazione OAuth2, se non disponibile, usare setup admin handoff)

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`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`--skip-infrastructure`	Ignorare Azure creazione dell'infrastruttura (usare se l'infrastruttura esiste già). Questa opzione crea ancora: Progetto e autorizzazioni.
`--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 di aiuto e utilizzo.

`setup admin`

Completa le concessioni di autorizzazione OAuth2 (consenso amministratore) che richiedono l'amministratore globale. Eseguire questo comando dopo l'esecuzione a365 setup alldi un amministratore dell'ID agente o di un ID agente.

Autorizzazioni minime necessarie: Amministratore globale

a365 setup admin [options]

Quando usare `setup admin`

Usare questo comando quando:

Dopo l'esecuzione a365 setup alldi un agente ID amministratore o ID agente sviluppatore.
Il riepilogo dell'installazione mostra che le concessioni OAuth2 sono in sospeso e indica all'amministratore globale di eseguire questo comando.
Si vogliono rieseguire le concessioni di consenso dopo la modifica delle autorizzazioni nella configurazione.

Flusso di lavoro di handoff tipico

# Step 1: Agent ID Admin or Developer runs setup
a365 setup all

# The CLI displays next steps, for example:
# "ACTION REQUIRED — Global Administrator must complete OAuth2 grants"
# "Option 1: a365 setup admin --config-dir '<path-to-config-folder>'"
# "Option 2: Share the consent URL displayed above with your Global Administrator"

# Step 2: Agent ID Admin shares config folder with Global Administrator
# (contains a365.config.json and a365.generated.config.json)

# Step 3: Global Administrator completes the grants
a365 setup admin --config-dir "<path-to-config-folder>"

Questo comando:

Carica la configurazione dell'agente dalla directory specificata o dalla directory corrente per impostazione predefinita.
Legge l'ID progetto agente e le autorizzazioni di risorsa configurate dalla configurazione generata.
Crea AllPrincipals concessioni di autorizzazioni OAuth2 per tutte le risorse configurate, tra cui:
- Microsoft Graph (ambiti delegati)
- Strumenti agente 365 (ambiti server MCP)
- API bot di messaggistica
- API Osservabilità
- API di Power Platform
- Eventuali autorizzazioni personalizzate definite nella configurazione
Visualizza una richiesta di conferma prima di apportare modifiche. Usare --yes per ignorare il prompt.

Avviso

Le concessioni OAuth2 create da questo comando sono a livello di tenant (consentType=AllPrincipals). Questa configurazione significa che tutti gli utenti nel tenant possono usare le autorizzazioni delegate dell'agente. Esaminare attentamente gli ambiti elencati prima di confermare.

Opzioni `setup admin`

Opzione	Description
`-d`, `--config-dir <dir>`	Directory contenente `a365.config.json` e `a365.generated.config.json`. Il valore predefinito è la directory corrente.
`-v`, `--verbose`	Mostra output dettagliato.
`--dry-run`	Visualizzare le operazioni eseguite dal comando senza eseguirlo.
`--skip-requirements`	Ignorare il controllo di convalida dei requisiti. Usare con cautela.
`-y`, `--yes`	Ignorare la richiesta di conferma e procedere automaticamente.
`-?`, `-h`, `--help`	Mostra informazioni di aiuto e utilizzo.

Anziché eseguire a365 setup admin, l'amministratore globale può aprire l'URL di consenso combinato che a365 setup all salva in a365.generated.config.json. Questo URL copre tutte le risorse necessarie in un'unica visita al browser.

# Display the generated config to find the consent URL
a365 config display -g
# Look for: combinedAdminConsentUrl

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-03-25

Condividi tramite

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

Sintassi

Options

Ordine di esecuzione consigliato

setup requirements

Opzioni requirements

setup infrastructure

Opzioni infrastructure

setup blueprint

Opzioni blueprint

setup permissions

Options

Sottocomandi

setup permissions mcp

Opzioni permissions mcp

setup permissions bot

Opzioni permissions bot

setup permissions custom

Opzioni permissions custom

Configurare autorizzazioni personalizzate

Rimuovere autorizzazioni personalizzate

Integrazione con setup all

setup permissions copilotstudio

Opzioni permissions copilotstudio

setup all

Opzioni setup all

setup admin

Quando usare setup admin

Flusso di lavoro di handoff tipico

Opzioni setup admin

Alternativa: URL di consenso

Commenti e suggerimenti

Risorse aggiuntive

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

`setup requirements`

Opzioni `requirements`

`setup infrastructure`

Opzioni `infrastructure`

`setup blueprint`

Opzioni `blueprint`

`setup permissions`

`setup permissions mcp`

Opzioni `permissions mcp`

`setup permissions bot`

Opzioni `permissions bot`

`setup permissions custom`

Opzioni `permissions custom`

Integrazione con `setup all`

`setup permissions copilotstudio`

Opzioni `permissions copilotstudio`

`setup all`

Opzioni `setup all`

`setup admin`

Quando usare `setup admin`

Opzioni `setup admin`