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
-c, --config <config> Percorso del file di configurazione. Default: a365.config.json
-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
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
-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
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--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
--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.

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