Condividi tramite

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

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

Sintassi

a365 develop [command] [options]

Options

Opzione Description
-c, --config <config> Percorso del file di configurazione. Impostazione predefinita: 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

Opzione Description
-c, --config <config> Percorso del file di configurazione. Impostazione predefinita: a365.config.json
--dry-run Visualizzare le operazioni eseguite dal comando senza eseguirlo.
--skip-auth Ignorare l'autenticazione. Solo per i test. Il comando ha probabilmente esito negativo senza l'autenticazione valida.
-?, -h, --help Mostra informazioni di aiuto e utilizzo.

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

Opzione Description
-c, --config <config> Percorso del file di configurazione. Impostazione predefinita: 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.

Importante

Questo comando viene aggiornato ToolingManifest.json solo, ma non concede autorizzazioni al progetto dell'agente. La modalità di applicazione delle autorizzazioni dipende dalla posizione in cui ci si trova nel processo di installazione:

  • Prima dell'installazione iniziale: procedere con a365 setup all. Le autorizzazioni MCP vengono applicate come parte della creazione iniziale del progetto.
  • Dopo che il progetto esiste già: un amministratore globale deve essere eseguito a365 setup permissions mcp separatamente. L'amministratore deve eseguire a365 config display prima di tutto per verificare che deploymentProjectPath nei punti a365.config.json alla cartella del progetto contenente l'oggetto 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.

Argomentazione Description
<servers> Nomi dei server MCP da aggiungere

Opzioni add-mcp-servers

Usare queste opzioni per personalizzare il comportamento del add-mcp-servers comando, inclusa la selezione dei file di configurazione e i test di esecuzione a secco.

Opzione Description
-c, --config <config> Percorso del file di configurazione. Impostazione predefinita: 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

Argomentazione Description
<servers> Nomi dei server MCP da rimuovere

Opzioni remove-mcp-servers

Opzione Description
-c, --config <config> Percorso del file di configurazione. Impostazione predefinita: 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.

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

Importante

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.

Opzione 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

Importante

--resource e --resource-id non possono essere usati 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.

Opzione Description Impostazione predefinita
-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