Agent 365 CLI-kommandoreference develop

Administrer MCP-værktøjsservere til agentudvikling. Kommandoen develop indeholder indstillinger til administration af MCP-værktøjsservere (Model Context Protocol) til agentudvikling. Du kan angive tilgængelige servere, få vist konfigurerede servere og tilføje eller fjerne MCP-servere fra din agentkonfiguration.

Minimumrolle kræves: Ingen (lokal manifestadministration)

Syntax

a365 develop [command] [options]

Indstillinger

Option Description
-c, --config <config> Sti til konfigurationsfil. Default: a365.config.json
-v, --verbose Aktivér detaljeret logføring
-?, -h, --help Vis oplysninger om hjælp og brug.

develop list-available

Vis alle de MCP-servere, der er tilgængelige i kataloget (hvad du kan installere).

a365 develop list-available [options]

Denne kommando viser alle MCP-servere, der er tilgængelige i kataloget, og du kan installere dem til brug sammen med din agentudvikling.

list-available indstillinger

Option Description
--dry-run Vis, hvad kommandoen ville gøre uden at udføre den.
--skip-auth Skip authentication. Kun til test. Kommandoen mislykkes sandsynligvis uden gyldig godkendelse.
-?, -h, --help Vis oplysninger om hjælp og brug.

Note

develop list-available kræver ikke a365.config.json. Den læser miljøet fra miljøvariablen A365_ENVIRONMENT (standard er ).prod

develop list-configured

Vis aktuelt konfigurerede MCP-servere fra din lokale ToolingManifest.json.

a365 develop list-configured [options]

Denne kommando viser alle MCP-servere, som du i øjeblikket har konfigureret i din lokale ToolingManifest.json-fil.

list-configured indstillinger

Option Description
--project-path <path> Sti til agentprojektmappen, der indeholder ToolingManifest.json. Overstyrer DeploymentProjectPath fra a365.config.json.
--dry-run Vis, hvad kommandoen ville gøre uden at udføre den.
-?, -h, --help Vis oplysninger om hjælp og brug.

develop add-mcp-servers

Føj MCP-servere til den aktuelle agentkonfiguration.

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

Denne kommando føjer de angivne MCP-servere til ToolingManifest.json i projektmappen. Den giver ikke tilladelser til agentens kursusplan.

Important

Denne kommando opdateres ToolingManifest.json kun – den giver ikke tilladelser til agentens blueprint. Hvordan du anvender tilladelser afhænger af, hvor du er i opsætningsprocessen:

  • Før den indledende konfiguration: Fortsæt med a365 setup all. MCP-tilladelser anvendes som en del af den indledende oprettelse af kursusplanen.
  • Når kursusplanen allerede findes: En global administrator skal køre a365 setup permissions mcp separat. Administratoren skal verificere, at peger deploymentProjectPath på projektmappen, der indeholder den opdaterede ToolingManifest.json.

add-mcp-servers Argumenter

Angiv et eller flere MCP-servernavne, der skal føjes til agentkonfigurationen. Du kan angive flere servernavne adskilt af mellemrum.

Argument Description
<servers> Navnene på de MCP-servere, der skal tilføjes

add-mcp-servers indstillinger

Brug disse indstillinger til at tilpasse kommandoens add-mcp-servers funktionsmåde.

Option Description
--project-path <path> Sti til agentprojektmappen, der indeholder ToolingManifest.json. Overstyrer DeploymentProjectPath fra a365.config.json.
--dry-run Vis, hvad kommandoen ville gøre uden at udføre den.
-?, -h, --help Vis oplysninger om hjælp og brug.

develop remove-mcp-servers

Fjern MCP-servere fra den aktuelle agentkonfiguration.

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

Denne kommando fjerner de angivne MCP-servere fra din aktuelle agentkonfiguration.

remove-mcp-servers Argumenter

Argument Description
<servers> Navnene på de MCP-servere, der skal fjernes

remove-mcp-servers indstillinger

Option Description
--project-path <path> Sti til agentprojektmappen, der indeholder ToolingManifest.json. Overstyrer DeploymentProjectPath fra a365.config.json.
--dry-run Vis, hvad kommandoen ville gøre uden at udføre den.
-?, -h, --help Vis oplysninger om hjælp og brug.

develop add-permissions

Tilføj API-tilladelser til MCP-serveren for at Microsoft Entra programmer til udviklingsscenarier, hvor du skal konfigurere brugerdefinerede programmer for at få adgang til MCP-servere.

a365 develop add-permissions [options]

add-permissions indstillinger

Brug disse indstillinger til at føje påkrævede API-tilladelser og -områder til din appregistrering og udnytte værdier fra værktøjsmanifestet.

Option Description
-c, --config <config> Sti til konfigurationsfil (standard: a365.config.json)
-m, --manifest <manifest> Sti til ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Program-id (klient) til at føje tilladelser til (standard: clientAppId fra konfiguration)
--scopes <scopes> Specifikke områder, der skal tilføjes (mellemrumssepareret) (standard: Alle områder fra ToolingManifest.json)
--dry-run Vis, hvad kommandoen ville gøre uden at foretage ændringer
-v, --verbose Vis detaljeret output
-?, -h, --help Vis oplysninger om hjælp og brug.

Important

Det program, der er angivet af --app-id eller clientAppId, skal have tilladelsen Application.ReadWrite.All i Microsoft Entra. Denne kommando er til brugerdefinerede klientprogrammer. Hvis du vil konfigurere tilladelser for agentplaner, skal du bruge a365 setup permissions mcp i stedet.

develop get-token

Hent ihændehavertokens til test af MCP-servere under udvikling ved hjælp af interaktiv browsergodkendelse.

a365 develop get-token [options]

get-token indstillinger

Brug disse indstillinger til at anmode om et adgangstoken, styre områder, opdatere funktionsmåden og vælge outputformatet.

Option Description
-c, --config <config> Sti til konfigurationsfil (standard: a365.config.json)
--app-id <app-id> Program-id (klient) til godkendelse (standard: clientAppId fra konfiguration)
-m, --manifest <manifest> Sti til ToolingManifest.json (standard: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Specifikke områder, der skal anmodes om (mellemrumssepareret) (standard: Læs fra ToolingManifest.json)
-o, --output <output> Outputformat: table, jsoneller raw (standard: table)
--force-refresh Gennemtving tokenopdatering, der tilsidesætter cachen
--resource <resource> Det ressourcenøgleord, der skal hentes token for: mcp (standard) eller powerplatform
--resource-id <resource-id> Id for brugerdefineret ressourceprogram (GUID) for ressourcer, der ikke er omfattet af --resource nøgleord
-v, --verbose Vis detaljeret output, herunder fuldt token
-?, -h, --help Vis oplysninger om hjælp og brug.

get-token ressourceindstillinger

Brug indstillingerne --resource og --resource-id til at hente tokens for forskellige Azure ressourcer:

  • --resource: Brug et nøgleord til at vælge en foruddefineret ressource:
    • mcp (standard): Agent 365 Tools til MCP-servere
    • powerplatform: Power Platform-API
  • --resource-id: Angiv et brugerdefineret ressourceprogram-id (GUID) for ressourcer, der ikke er omfattet af nøgleord

Important

Du kan ikke bruge --resource og --resource-id sammen. Når du bruger en af indstillingerne, skal du inkludere --scopes. Det er kun STANDARD-MCP-flowet, der understøtter manifestbaseret områdeopløsning.

develop start-mock-tooling-server

Start en modelværktøjsserver til test- og udviklingsformål.

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

Denne kommando starter en modelværktøjsserver til test- og udviklingsformål. Ved hjælp af denne server kan du simulere MCP-serverinteraktioner uden at kræve faktiske serverimplementeringer.

start-mock-tooling-server indstillinger

Brug disse indstillinger til at tilpasse kommandoens start-mock-tooling-server funktionsmåde.

Option Description Default
-p, --port <port> Portnummer for mock-serveren 5309
-v, --verbose Aktivér detaljeret logføring false
-?, -h, --help Vis oplysninger om hjælp og brug -
-bg Kør serveren på en ny terminal -