Delen via


Naslaginformatie over cli-opdrachten develop voor agent 365

Belangrijk

U moet deel uitmaken van het Frontier Preview-programma om vroegtijdige toegang te krijgen tot Microsoft Agent 365. Frontier verbindt u rechtstreeks met de nieuwste AI-innovaties van Microsoft. Grensvertoningen zijn onderhevig aan de bestaande preview-voorwaarden van uw klantovereenkomsten. Omdat deze functies nog in ontwikkeling zijn, kunnen hun beschikbaarheid en mogelijkheden na verloop van tijd veranderen.

BEHEER MCP-hulpprogrammaservers voor agentontwikkeling. De develop opdracht biedt opties voor het beheren van MCP-hulpprogrammaservers (Model Context Protocol) voor agentontwikkeling. U kunt beschikbare servers weergeven, geconfigureerde servers weergeven en MCP-servers toevoegen aan of verwijderen uit uw agentconfiguratie.

Minimale rol vereist: Geen (lokaal manifestbeheer)

Syntaxis

a365 develop [command] [options]

Options

Optie Description
-c, --config <config> Pad naar configuratiebestand. Standaard: a365.config.json
-v, --verbose Uitgebreid loggen inschakelen
-?, , -h--help Help- en gebruiksgegevens weergeven.

develop list-available

Geef alle MCP-servers weer die beschikbaar zijn in de catalogus (wat u kunt installeren).

a365 develop list-available [options]

Met deze opdracht worden alle MCP-servers weergegeven die beschikbaar zijn in de catalogus en kunt u deze installeren voor gebruik met uw agentontwikkeling.

list-available Opties

Optie Description
-c, --config <config> Pad naar configuratiebestand. Standaard: a365.config.json
--dry-run Weergeven wat de opdracht zou doen zonder deze uit te voeren.
--skip-auth Verificatie overslaan. Alleen voor testen. De opdracht mislukt waarschijnlijk zonder geldige verificatie.
-?, , -h--help Help- en gebruiksgegevens weergeven.

develop list-configured

Vermeld momenteel geconfigureerde MCP-servers van uw lokale ToolingManifest.json.

a365 develop list-configured [options]

Met deze opdracht worden alle MCP-servers weergegeven die u momenteel hebt geconfigureerd in uw lokale ToolingManifest.json-bestand.

list-configured Opties

Optie Description
-c, --config <config> Pad naar configuratiebestand. Standaard: a365.config.json
--dry-run Weergeven wat de opdracht zou doen zonder deze uit te voeren.
-?, , -h--help Help- en gebruiksgegevens weergeven.

develop add-mcp-servers

MCP-servers toevoegen aan de huidige agentconfiguratie.

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

Met deze opdracht worden de opgegeven MCP-servers toegevoegd aan ToolingManifest.json de projectmap. Er worden geen machtigingen verleend aan de blauwdruk van de agent.

Belangrijk

Met deze opdracht wordt alleen bijgewerkt ToolingManifest.json . De opdracht verleent geen machtigingen voor de blauwdruk van de agent. Hoe machtigingen worden toegepast, is afhankelijk van waar u zich in het installatieproces bevindt:

  • Voor de eerste installatie: Ga verder met a365 setup all. MCP-machtigingen worden toegepast als onderdeel van het maken van de eerste blauwdruk.
  • Nadat de blauwdruk al bestaat: een globale beheerder moet afzonderlijk worden uitgevoerd a365 setup permissions mcp . De beheerder moet eerst worden uitgevoerd a365 config display om te controleren of deploymentProjectPath in hun a365.config.json punt naar de projectmap met de bijgewerkte map wordt verwezen ToolingManifest.json.

add-mcp-servers Argumenten

Geef een of meer MCP-servernamen op die u wilt toevoegen aan uw agentconfiguratie. U kunt meerdere servernamen opgeven, gescheiden door spaties.

Argument Description
<servers> Namen van de MCP-servers die moeten worden toegevoegd

add-mcp-servers Opties

Gebruik deze opties om het gedrag van de add-mcp-servers opdracht aan te passen, waaronder het selecteren van configuratiebestanden en het testen van droge uitvoeringen.

Optie Description
-c, --config <config> Pad naar configuratiebestand. Standaard: a365.config.json
--dry-run Weergeven wat de opdracht zou doen zonder deze uit te voeren.
-?, , -h--help Help- en gebruiksgegevens weergeven.

develop remove-mcp-servers

MCP-servers verwijderen uit de huidige agentconfiguratie.

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

Met deze opdracht verwijdert u de opgegeven MCP-servers uit de huidige agentconfiguratie.

remove-mcp-servers Argumenten

Argument Description
<servers> Namen van de MCP-servers die moeten worden verwijderd

remove-mcp-servers Opties

Optie Description
-c, --config <config> Pad naar configuratiebestand. Standaard: a365.config.json
--dry-run Weergeven wat de opdracht zou doen zonder deze uit te voeren.
-?, , -h--help Help- en gebruiksgegevens weergeven.

develop add-permissions

Voeg API-machtigingen voor MCP-servers toe aan Microsoft Entra toepassingen voor ontwikkelingsscenario's waarbij u aangepaste toepassingen moet configureren voor toegang tot MCP-servers.

a365 develop add-permissions [options]

add-permissions Opties

Gebruik deze opties om vereiste API-machtigingen en -bereiken toe te voegen aan uw app-registratie, waarbij gebruik wordt gemaakt van waarden uit het hulpprogrammamanifest.

Optie Description
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
-m, --manifest <manifest> Pad naar ToolingManifest.json (standaard: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Toepassings-id (client) om machtigingen toe te voegen aan (standaard: clientAppId van configuratie)
--scopes <scopes> Specifieke bereiken die moeten worden toegevoegd (door spaties gescheiden) (standaard: Alle bereiken van ToolingManifest.json)
--dry-run Weergeven wat de opdracht zou doen zonder wijzigingen aan te brengen
-v, --verbose Gedetailleerde uitvoer weergeven
-?, , -h--help Help- en gebruiksgegevens weergeven.

Belangrijk

De toepassing die is opgegeven door --app-id of clientAppId moet de machtiging Application.ReadWrite.All hebben in Microsoft Entra. Deze opdracht is bedoeld voor aangepaste clienttoepassingen. Als u machtigingen voor agentblauwdrukken wilt configureren, gebruikt a365 setup permissions mcp u in plaats daarvan.

develop get-token

Bearer-tokens ophalen voor het testen van MCP-servers tijdens de ontwikkeling met behulp van interactieve browserverificatie.

a365 develop get-token [options]

get-token Opties

Gebruik deze opties om een toegangstoken aan te vragen, bereiken te beheren, gedrag te vernieuwen en de uitvoerindeling te kiezen.

Optie Description
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--app-id <app-id> Toepassings-id (client) voor verificatie (standaard: clientAppId van configuratie)
-m, --manifest <manifest> Pad naar ToolingManifest.json (standaard: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Specifieke bereiken die moeten worden aangevraagd (door spaties gescheiden) (standaard: lezen uit ToolingManifest.json)
-o, --output <output> Uitvoerindeling: table, jsonof raw (standaard: table)
--force-refresh Token vernieuwen omslaan van cache afdwingen
--resource <resource> Trefwoord resource voor het ophalen van token voor: mcp (standaard) of powerplatform
--resource-id <resource-id> Id van aangepaste resourcetoepassing (GUID) voor resources die niet worden gedekt door --resource trefwoorden
-v, --verbose Gedetailleerde uitvoer weergeven, inclusief volledig token
-?, , -h--help Help- en gebruiksgegevens weergeven.

get-token resourceopties

Gebruik de opties --resource en --resource-id om tokens op te halen voor verschillende Azure resources:

  • --resource: Gebruik een trefwoord om een vooraf gedefinieerde resource te selecteren:
    • mcp (standaard): Agent 365 Tools voor MCP-servers
    • powerplatform: Power Platform-API
  • --resource-id: Voer een aangepaste id van de resourcetoepassing (GUID) in voor resources die niet worden gedekt door trefwoorden

Belangrijk

--resource en --resource-id kunnen niet samen worden gebruikt. Wanneer u een van beide opties gebruikt, neemt u het volgende op --scopes. Alleen de standaard MCP-stroom biedt ondersteuning voor bereikomzetting op basis van manifesten.

develop start-mock-tooling-server

Start een mock tooling-server voor test- en ontwikkelingsdoeleinden.

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

Met deze opdracht wordt een mock tooling-server gestart voor test- en ontwikkelingsdoeleinden. Met behulp van deze server kunt u MCP-serverinteracties simuleren zonder daadwerkelijke server-implementaties te vereisen.

start-mock-tooling-server Opties

Gebruik deze opties om het gedrag van de start-mock-tooling-server opdracht aan te passen.

Optie Description Verstek
-p, --port <port> Poortnummer voor de mock-server 5309
-v, --verbose Uitgebreid loggen inschakelen false
-?, -h, --help Help- en gebruiksgegevens weergeven -
-bg De server uitvoeren op een nieuwe terminal -