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

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 Minimum necessario: Azure Collaboratore + Global Administrator

Sintassi

a365 setup [command] [options]

Options

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

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

setup infrastructure

Creare Azure'infrastruttura.

autorizzazioni necessarie Minimum: collaboratore o proprietario della sottoscrizione Azure

a365 setup infrastructure [options]

Opzioni infrastructure

setup blueprint

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

Autorizzazioni minime necessarie: ruolo sviluppatore ID agente

a365 setup blueprint [options]

Opzioni blueprint

setup permissions

Configurare le autorizzazioni OAuth2 concede ed ereditabili le autorizzazioni.

Autorizzazioni minime necessarie: Amministratore globale

a365 setup permissions [command] [options]

Options

Sottocomandi

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.

Opzioni permissions mcp

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

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

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

Il nome della risorsa viene risolto automaticamente da Azure durante l'installazione. 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. L'ordine di installazione completo è:

1. Infrastruttura
2. Progetto
3. Autorizzazioni MCP
4. Autorizzazioni dell'API bot
5. Autorizzazioni di progetto personalizzate (se configurate)
6. Endpoint di messaggistica

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

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, autorizzazioni ed endpoint.

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

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

Opzioni setup all