Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Kommandoreferanse for Agent 365 CLI
Administrer MCP-verktøyservere for agentutvikling. Kommandoen develop inneholder alternativer for å administrere MCP-verktøyservere (Model Context Protocol) for agentutvikling. Du kan vise tilgjengelige servere, vise konfigurerte servere og legge til eller fjerne MCP-servere fra agentkonfigurasjonen.
Minimumsrolle kreves: Ingen (lokal manifestbehandling)
Syntax
a365 develop [command] [options]
Alternativer
| Option | Description |
|---|---|
-v, --verbose |
Aktiver detaljert logging |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
develop list-available
Vis alle MCP-servere som er tilgjengelige i katalogen (det du kan installere).
a365 develop list-available [options]
Denne kommandoen viser alle MCP-servere som er tilgjengelige i katalogen, og du kan installere dem for bruk med agentutviklingen.
list-available Alternativer
| Option | Description |
|---|---|
--dry-run |
Vis hva kommandoen ville gjort uten å kjøre den. |
--skip-auth |
Skip authentication. Bare for testing. Kommandoen mislykkes sannsynligvis uten gyldig godkjenning. |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
Note
develop list-available krever ikke a365.config.json. Den leser miljøet fra miljøvariabelen A365_ENVIRONMENT (standard er ).prod
develop list-configured
Liste over for øyeblikket konfigurerte MCP-servere fra den lokale ToolingManifest.json.
a365 develop list-configured [options]
Denne kommandoen viser alle MCP-servere som du har konfigurert i den lokale ToolingManifest.json-filen.
list-configured Alternativer
| Option | Description |
|---|---|
--project-path <path> |
Vei til agentprosjektmappen som inneholder ToolingManifest.json. Overstyringer DeploymentProjectPath fra a365.config.json. |
--dry-run |
Vis hva kommandoen ville gjort uten å kjøre den. |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
develop add-mcp-servers
Legg til MCP-servere i gjeldende agentkonfigurasjon.
a365 develop add-mcp-servers [<servers>...] [options]
Denne kommandoen legger til de angitte MCP-serverne ToolingManifest.json i prosjektmappen. Den gir ikke tillatelse til agenttegningen.
Important
Denne kommandoen oppdateres ToolingManifest.json bare – den gir ikke tillatelser til agentens blueprint. Hvordan du bruker tillatelser avhenger av hvor du er i oppsettsprosessen:
-
Før første installasjon: Fortsett med
a365 setup all. MCP-tillatelser brukes som en del av den første opprettingen av tegning. -
Etter at tegningen allerede finnes: En global administrator må kjøre
a365 setup permissions mcpseparat. Administratoren må verifisere at detdeploymentProjectPathpeker på prosjektmappen som inneholder den oppdaterteToolingManifest.json.
add-mcp-servers Argumenter
Angi ett eller flere MCP-servernavn som skal legges til agentkonfigurasjonen. Du kan angi flere servernavn atskilt med mellomrom.
| Argument | Description |
|---|---|
<servers> |
Navn på MCP-serverne som skal legges til |
add-mcp-servers Alternativer
Bruk disse alternativene til å tilpasse virkemåten til add-mcp-servers kommandoen.
| Option | Description |
|---|---|
--project-path <path> |
Vei til agentprosjektmappen som inneholder ToolingManifest.json. Overstyringer DeploymentProjectPath fra a365.config.json. |
--dry-run |
Vis hva kommandoen ville gjort uten å kjøre den. |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
develop remove-mcp-servers
Fjern MCP-servere fra gjeldende agentkonfigurasjon.
a365 develop remove-mcp-servers [<servers>...] [options]
Denne kommandoen fjerner angitte MCP-servere fra gjeldende agentkonfigurasjon.
remove-mcp-servers Argumenter
| Argument | Description |
|---|---|
<servers> |
Navn på MCP-serverne som skal fjernes |
remove-mcp-servers Alternativer
| Option | Description |
|---|---|
--project-path <path> |
Vei til agentprosjektmappen som inneholder ToolingManifest.json. Overstyringer DeploymentProjectPath fra a365.config.json. |
--dry-run |
Vis hva kommandoen ville gjort uten å kjøre den. |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
develop add-permissions
Legg til API-tillatelser for MCP-server i Microsoft Entra programmer for utviklingsscenarioer der du må konfigurere egendefinerte programmer for å få tilgang til MCP-servere.
a365 develop add-permissions [options]
add-permissions Alternativer
Bruk disse alternativene til å legge til nødvendige API-tillatelser og omfang i appregistreringen, og dra nytte av verdier fra verktøymanifestet.
| Option | Description |
|---|---|
-m, --manifest <manifest> |
Bane til ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json) |
--app-id <app-id> |
Program-ID (klient)-ID for å legge til tillatelser i (standard: clientAppId fra konfigurasjon) |
--scopes <scopes> |
Bestemte omfang som skal legges til (mellomromsdelt) (standard: Alle omfang fra ToolingManifest.json) |
--dry-run |
Vis hva kommandoen ville gjort uten å gjøre endringer |
-v, --verbose |
Vis detaljerte utdata |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
Important
Programmet som er angitt av --app-id eller clientAppId, må ha tillatelsen Application.ReadWrite.All i Microsoft Entra. Denne kommandoen er for egendefinerte klientprogrammer. Hvis du vil konfigurere tillatelser for agenttegninger, bruker du a365 setup permissions mcp i stedet.
develop get-token
Hent bærertokener for testing av MCP-servere under utvikling ved hjelp av interaktiv nettlesergodkjenning.
a365 develop get-token [options]
get-token Alternativer
Bruk disse alternativene til å be om et tilgangstoken, kontrollere omfang, oppdatere virkemåte og velge utdataformat.
| Option | Description |
|---|---|
--app-id <app-id> |
Program-ID for godkjenning (standard: clientAppId fra konfigurasjon) |
-m, --manifest <manifest> |
Bane til ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json) |
--scopes <scopes> |
Bestemte omfang som skal bes om (mellomromseparert) (standard: Lese fra ToolingManifest.json) |
-o, --output <output> |
Utdataformat: table, jsoneller raw (standard: table) |
--force-refresh |
Tving oppdatering av tokenoppdatering utenom hurtigbuffer |
--device-code |
Autentiser deg med enhetskodeflyten i stedet for den interaktive nettleserflyten (Windows Account Manager (WAM)-megleren på Windows).
Lær om autentisering av get-token enhetskoder |
--resource <resource> |
Ressursnøkkelord for å hente token for: mcp (standard) eller powerplatform |
--resource-id <resource-id> |
Egendefinert ressursprogram-ID (GUID) for ressurser som ikke dekkes av --resource nøkkelord |
-v, --verbose |
Vis detaljerte utdata, inkludert fullstendig token |
-?, -h, --help |
Vis informasjon om hjelp og bruk. |
get-token ressursalternativer
Bruk alternativene --resource og --resource-id for å få tokener for ulike Azure ressurser:
-
--resource: Bruk et nøkkelord til å velge en forhåndsdefinert ressurs:-
mcp(standard): Agent 365-verktøy for MCP-servere -
powerplatform: API for Power Platform
-
-
--resource-id: Angi en egendefinert ressursprogram-ID (GUID) for ressurser som ikke dekkes av nøkkelord
Important
Du kan ikke bruke --resource og --resource-id sammen. Når du bruker et av alternativene, kan du inkludere --scopes. Bare standard MCP-flyt støtter manifestbasert omfangsoppløsning.
get-token Enhetskodeautentisering
På Windows bruker den standard interaktive nettleserflyten Windows Account Manager (WAM)-megleren, som avviser visse Exchange-spesifikke Microsoft Graph-omfang (for eksempel MailboxSettings.ReadWrite og ExchangeMessageTrace.Read.All).
Du trenger ikke oppdage dette selv. Hvis WAM avviser de forespurte scopene, rapporterer CLI avvisningen og prøver automatisk på nytt med enhetskodeflyten, så kommandoen lykkes fortsatt uten --device-code.
Fordi WAM må forsøke og feile før CLI-en prøver på nytt, er fallbacken tregere og opplevelsen suboptimal. Bestå --device-code når du vil velge den flyten på forhånd og unngå det mislykkede forsøket:
- Du kjører der ingen interaktiv nettleser kan åpnes, som for eksempel en ekstern terminal eller SSH-økt.
- Du vet allerede at du ber om Exchange-scopes og vil hoppe over det mislykkede WAM-forsøket og advarselen.
- Du kjører
get-tokengjentatte ganger med de samme scopene, for eksempel på tvers av flere blåkopier, hvor forsinkelsen per kjøring legger seg opp.
$params = @{
ResourceId = "00000003-0000-0000-c000-000000000000"
Scopes = "MailboxSettings.ReadWrite ExchangeMessageTrace.Read.All"
DeviceCode = $true
}
a365 develop get-token @params
Kommandoen viser en URL (https://microsoft.com/devicelogin) og en kode for å fullføre innlogging i nettleseren din.
develop start-mock-tooling-server
Start en mock-verktøyserver for test- og utviklingsformål.
a365 develop start-mock-tooling-server [options]
Denne kommandoen starter en mock-verktøyserver for test- og utviklingsformål. Ved å bruke denne serveren kan du simulere samhandlinger mellom MCP-servere uten å kreve faktiske serverimplementeringer.
start-mock-tooling-server Alternativer
Bruk disse alternativene til å tilpasse virkemåten til start-mock-tooling-server kommandoen.
| Option | Description | Default |
|---|---|---|
-p, --port <port> |
Portnummer for mock-serveren | 5309 |
-v, --verbose |
Aktiver detaljert logging | false |
-?, -h, --help |
Vis informasjon om hjelp og bruk | - |
-bg |
Kjør serveren på en ny terminal | - |