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

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.

Gestire la configurazione dell'interfaccia della riga di comando di Agent 365. Fornisce opzioni per gestire le impostazioni di configurazione dell'interfaccia della riga di comando di Agent 365. È possibile inizializzare nuove configurazioni in modo interattivo o visualizzare le impostazioni di configurazione correnti.

Ruolo minimo obbligatorio: Nessuno (configurazione locale)

Sintassi

a365 config [command] [options]

Options

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

config init

Configurare in modo interattivo l'interfaccia della riga di comando di Agent 365 o importare da un file.

a365 config init [options]

Usare questo comando per configurare la configurazione dell'interfaccia della riga di comando di Agent 365 tramite un processo interattivo o importando le impostazioni da un file di configurazione esistente.

Opzioni init

Opzione	Description
-c, --configfile <configfile>	Percorso di un file di configurazione esistente da importare
-g, --global	Creare la configurazione nella directory globale (AppData) anziché nella directory corrente
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Osservazioni:

Il config init comando avvia una procedura guidata interattiva che riduce al minimo l'input manuale:

• integrazione Azure CLI: rileva automaticamente la sottoscrizione, il tenant, i gruppi di risorse, i piani di servizio app e le aree.
• Impostazioni predefinite intelligenti: genera nomi di risorse dal nome dell'agente e un timestamp (ad esempio, myagent-webapp-11140916). È possibile personalizzare questi nomi prima del salvataggio.
• rilevamento Piattaforma: rileva il tipo di progetto (.NET, Node.js, Python) dal percorso del progetto di distribuzione e avvisa se non viene trovato alcun tipo supportato.
• Convalida dell'app client: convalida l'ID dell'app client nel tenant entra, verificando che le autorizzazioni necessarie siano configurate e che venga concesso il consenso amministratore. Prima dell'uscita dalla procedura guidata sono disponibili fino a tre tentativi.

Autorizzazioni di progetto personalizzate (facoltativo): la procedura guidata include un passaggio facoltativo per configurare le autorizzazioni per risorse esterne aggiuntive, ad esempio la presenza di Teams o i file di OneDrive. La maggior parte degli agenti non richiede questo problema. È anche possibile configurare le autorizzazioni dopo l'installazione iniziale usando a365 config permissions.

Aggiornamento della configurazione esistente: l'esecuzione riesegua a365 config init il caricamento corrente a365.config.json come impostazione predefinita. Premere INVIO a ogni richiesta per mantenere il valore corrente oppure digitare un nuovo valore per aggiornarlo.

config display

Mostra la configurazione corrente dell'interfaccia della riga di comando di Agent 365.

a365 config display [options]

Questo comando visualizza le impostazioni di configurazione correnti per l'interfaccia della riga di comando di Agent 365, in modo da poter esaminare l'installazione corrente.

Opzioni display

Opzione	Description
-g, --generated	Visualizzare la configurazione generata (a365.generated.config.json).
-a, --all	Consente di visualizzare sia la configurazione statica che quella generata.
-f, --field <field>	Restituisce il valore di un singolo campo , ad esempio : --field messagingEndpoint.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Osservazioni:

Usare --field per recuperare un singolo valore dalla configurazione da usare negli script o in altri comandi. Quando si usa questa opzione con -g o -a, l'interfaccia della riga di comando cerca prima di tutto la configurazione generata.

# Get the messaging endpoint from generated config
a365 config display -g --field messagingEndpoint

# Get a value from static config
a365 config display --field webAppName

Struttura dei file di configurazione

L'interfaccia della riga di comando usa un file di configurazione JSON (a365.config.json) con le proprietà chiave seguenti:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}