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

Gestire i server degli strumenti MCP per lo sviluppo di agenti. Il develop comando fornisce opzioni per gestire i server degli strumenti MCP (Model Context Protocol) per lo sviluppo di agenti. È possibile elencare i server disponibili, visualizzare i server configurati e aggiungere o rimuovere server MCP dalla configurazione dell'agente.

Ruolo minimo obbligatorio: Nessuno (gestione del manifesto locale)

Syntax

a365 develop [command] [options]

Options

Option Description
-v, --verbose Abilitare la registrazione dettagliata
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

develop list-available

Elencare tutti i server MCP disponibili nel catalogo (cosa è possibile installare).

a365 develop list-available [options]

Questo comando visualizza tutti i server MCP disponibili nel catalogo ed è possibile installarli per l'uso con lo sviluppo dell'agente.

Opzioni list-available

Option Description
--dry-run Visualizzare le operazioni eseguite dal comando senza eseguirlo.
--skip-auth Skip authentication. Solo per i test. Il comando ha probabilmente esito negativo senza l'autenticazione valida.
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

Note

develop list-available non richiede a365.config.json. Legge l'ambiente dalla A365_ENVIRONMENT variabile ambiente (predefinita su prod).

develop list-configured

Elencare i server MCP attualmente configurati dall'oggetto locale ToolingManifest.json.

a365 develop list-configured [options]

Questo comando mostra tutti i server MCP attualmente configurati nel file di ToolingManifest.json locale.

Opzioni list-configured

Option Description
--project-path <path> Percorso verso la directory del progetto agente che contiene ToolingManifest.json. Sovrascrive DeploymentProjectPath da a365.config.json.
--dry-run Visualizzare le operazioni eseguite dal comando senza eseguirlo.
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

develop add-mcp-servers

Aggiungere server MCP alla configurazione dell'agente corrente.

a365 develop add-mcp-servers [<servers>...] [options]

Questo comando aggiunge i server MCP specificati a ToolingManifest.json nella cartella del progetto. Non concede autorizzazioni al progetto dell'agente.

Important

Questo comando si aggiorna ToolingManifest.json solo - non concede permessi al blueprint dell'agente. Come applichi i permessi dipende da dove ti trovi nel processo di configurazione:

  • Prima dell'installazione iniziale: procedere con a365 setup all. Le autorizzazioni MCP vengono applicate come parte della creazione iniziale del progetto.
  • Dopo che lo schema è già stato creato: un amministratore globale deve eseguire a365 setup permissions mcp separatamente. L'amministratore deve verificare che ciò deploymentProjectPath riporta alla cartella del progetto contenente il file aggiornato ToolingManifest.json.

Argomenti add-mcp-servers

Specificare uno o più nomi di server MCP da aggiungere alla configurazione dell'agente. È possibile specificare più nomi di server separati da spazi.

Argument Description
<servers> Nomi dei server MCP da aggiungere

Opzioni add-mcp-servers

Usare queste opzioni per personalizzare il comportamento del add-mcp-servers comando.

Option Description
--project-path <path> Percorso verso la directory del progetto agente che contiene ToolingManifest.json. Sovrascrive DeploymentProjectPath da a365.config.json.
--dry-run Visualizzare le operazioni eseguite dal comando senza eseguirlo.
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

develop remove-mcp-servers

Rimuovere i server MCP dalla configurazione dell'agente corrente.

a365 develop remove-mcp-servers [<servers>...] [options]

Questo comando rimuove i server MCP specificati dalla configurazione dell'agente corrente.

Argomenti remove-mcp-servers

Argument Description
<servers> Nomi dei server MCP da rimuovere

Opzioni remove-mcp-servers

Option Description
--project-path <path> Percorso verso la directory del progetto agente che contiene ToolingManifest.json. Sovrascrive DeploymentProjectPath da a365.config.json.
--dry-run Visualizzare le operazioni eseguite dal comando senza eseguirlo.
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

develop add-permissions

Aggiungere autorizzazioni API server MCP per Microsoft Entra applicazioni per scenari di sviluppo in cui è necessario configurare applicazioni personalizzate per accedere ai server MCP.

a365 develop add-permissions [options]

Opzioni add-permissions

Usare queste opzioni per aggiungere le autorizzazioni e gli ambiti API necessari alla registrazione dell'app, sfruttando i valori del manifesto degli strumenti.

Option Description
-m, --manifest <manifest> Percorso di ToolingManifest.json (impostazione predefinita: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> ID applicazione (client) per aggiungere autorizzazioni a (impostazione predefinita: clientAppId da config)
--scopes <scopes> Ambiti specifici da aggiungere (separati da spazio) (impostazione predefinita: Tutti gli ambiti da ToolingManifest.json)
--dry-run Mostrare le operazioni eseguite dal comando senza apportare modifiche
-v, --verbose Mostra output dettagliato
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

Important

L'applicazione specificata da --app-id o clientAppId deve disporre dell'autorizzazione Application.ReadWrite.All in Microsoft Entra. Questo comando è destinato alle applicazioni client personalizzate. Per configurare le autorizzazioni per i progetti dell'agente, usare a365 setup permissions mcp invece .

develop get-token

Recuperare i token di connessione per testare i server MCP durante lo sviluppo usando l'autenticazione interattiva del browser.

a365 develop get-token [options]

Opzioni get-token

Usare queste opzioni per richiedere un token di accesso, controllare gli ambiti, aggiornare il comportamento e scegliere il formato di output.

Option Description
--app-id <app-id> ID applicazione (client) per l'autenticazione (impostazione predefinita: clientAppId da config)
-m, --manifest <manifest> Percorso di ToolingManifest.json (impostazione predefinita: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Ambiti specifici da richiedere (separati da spazio) (impostazione predefinita: Lettura da ToolingManifest.json)
-o, --output <output> Formato di output: table, jsono raw (impostazione predefinita: table)
--force-refresh Forzare l'aggiornamento del token ignorando la cache
--device-code Autentica con il flusso di codice del dispositivo invece che con il flusso interattivo del browser (il broker Windows Account Manager (WAM) su Windows). Scopri l'autenticazione get-token per codice dispositivo
--resource <resource> Parola chiave resource per ottenere il token per: mcp (impostazione predefinita) o powerplatform
--resource-id <resource-id> ID applicazione risorsa personalizzata (GUID) per le risorse non coperte da --resource parole chiave
-v, --verbose Visualizzare l'output dettagliato, incluso il token completo
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

get-token opzioni delle risorse

Usare le opzioni --resource e --resource-id per ottenere token per risorse Azure diverse:

  • --resource: usare una parola chiave per selezionare una risorsa predefinita:
    • mcp (impostazione predefinita): Strumenti agente 365 per server MCP
    • powerplatform: API Power Platform
  • --resource-id: immettere un ID applicazione di risorse personalizzato (GUID) per le risorse non coperte dalle parole chiave

Important

Non puoi usare --resource e --resource-id insieme. Quando si usa una delle due opzioni, includere --scopes. Solo il flusso MCP predefinito supporta la risoluzione dell'ambito basata su manifesto.

get-token Autenticazione tramite codice dispositivo

Su Windows, il flusso interattivo predefinito del browser utilizza il broker Windows Account Manager (WAM), che rifiuta alcuni scope Microsoft Graph specifici per Exchange (ad esempio, MailboxSettings.ReadWrite e ExchangeMessageTrace.Read.All).

Non devi rilevarlo da solo. Se WAM rifiuta gli scope richiesti, la CLI segnala il rifiuto e ritenta automaticamente con il flusso di codice del dispositivo, quindi il comando ha comunque successo senza --device-code.

Poiché il WAM deve tentare e fallire prima che la CLI tenti, il fallback è più lento e l'esperienza è subottimale. Passa --device-code quando vuoi scegliere quel flusso fin dall'inizio ed evita il tentativo fallito:

  • Stai usando un luogo dove nessun browser interattivo può aprirsi, come un terminale remoto o una sessione SSH.
  • Sai già che stai richiedendo scope Exchange e vuoi saltare il tentativo fallito di WAM e il suo avviso.
  • Corri get-token ripetutamente con gli stessi mirini, ad esempio su più progetti, dove il ritardo per ogni corsa si somma.
$params = @{
  ResourceId = "00000003-0000-0000-c000-000000000000"
  Scopes     = "MailboxSettings.ReadWrite ExchangeMessageTrace.Read.All"
  DeviceCode = $true
}

a365 develop get-token @params

Il comando mostra un URL (https://microsoft.com/devicelogin) e un codice per completare l'accesso nel browser.

develop start-mock-tooling-server

Avviare un server di strumenti fittizi per scopi di test e sviluppo.

a365 develop start-mock-tooling-server [options]

Questo comando avvia un server di strumenti fittizi per scopi di test e sviluppo. Usando questo server, è possibile simulare le interazioni del server MCP senza richiedere implementazioni effettive del server.

Opzioni start-mock-tooling-server

Usare queste opzioni per personalizzare il comportamento del start-mock-tooling-server comando.

Option Description Default
-p, --port <port> Numero di porta per il server fittizio 5309
-v, --verbose Abilitare la registrazione dettagliata false
-?, -h, --help Visualizzare informazioni sulla Guida e sull'utilizzo -
-bg Eseguire il server in un nuovo terminale -
  • Last updated on