Jaa


Agent 365:n komentorivikäyttöliittymän develop komentoviittaus

Tärkeää

Sinun on oltava osa Frontier-esiversio-ohjelmaa , jotta pääset tutustumaan Microsoft Agent 365:een ennen sen käyttöä. Frontier yhdistää sinut suoraan Microsoftin uusimpiin tekoälyinnovaatioihin. Frontier-esiversioita koskevat asiakassopimusten nykyiset esikatseluehdot. Koska nämä ominaisuudet ovat vielä kehitteillä, niiden käytettävyys ja ominaisuudet voivat muuttua ajan mittaan.

Hallitse MCP-työkalupalvelimia agenttikehitystä varten. Komento develop tarjoaa vaihtoehtoja MCP (Model Context Protocol) -työkalupalvelimien hallintaan agenttikehitystä varten. Voit luetella käytettävissä olevat palvelimet, tarkastella määritettyjä palvelimia sekä lisätä tai poistaa MCP-palvelimia agenttimäärityksistäsi.

Vaadittu vähimmäisrooli: Ei mitään (paikallisen kokoonpanon hallinta)

Syntax

a365 develop [command] [options]

Asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletus: a365.config.json
-v, --verbose Yksityiskohtaisen kirjaamisen käyttöönotto
-?, -h, --help Näytä ohjeet ja käyttötiedot.

develop list-available

Luettele kaikki luettelossa käytettävissä olevat MCP-palvelimet (mitä voit asentaa).

a365 develop list-available [options]

Tämä komento näyttää kaikki luettelossa käytettävissä olevat MCP-palvelimet, ja voit asentaa ne agentin kehittämistä varten.

list-available asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletus: a365.config.json
--dry-run Näytä, mitä komento tekee ilman sen suorittamista.
--skip-auth Ohita todentaminen. Vain testausta varten. Komento todennäköisesti epäonnistuu ilman kelvollista todentamista.
-?, -h, --help Näytä ohjeet ja käyttötiedot.

develop list-configured

Luettele määritetyt MCP-palvelimet paikallisesta ToolingManifest.json-näkymästä.

a365 develop list-configured [options]

Tämä komento näyttää kaikki mcP-palvelimet, jotka olet tällä hetkellä määrittänyt paikallisessa ToolingManifest.json tiedostossa.

list-configured asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletus: a365.config.json
--dry-run Näytä, mitä komento tekee ilman sen suorittamista.
-?, -h, --help Näytä ohjeet ja käyttötiedot.

develop add-mcp-servers

Lisää MCP-palvelimet nykyiseen agenttimääritykseen.

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

Tämä komento lisää määritetyt MCP-palvelimet ToolingManifest.json projektikansioosi. Se ei myönnä oikeuksia agentti Blueprint-suunnitelmaan.

Tärkeää

Tämä komento päivittyy ToolingManifest.json vain – se ei myönnä käyttöoikeuksia agentille Blueprint-suunnitelmalle. Käyttöoikeuksien käyttöönottotapa riippuu siitä, missä vaiheessa määritysprosessia olet:

  • Ennen ensimmäistä asennusta: Jatka toiminnolla a365 setup all. McP-käyttöoikeuksia sovelletaan osana alustavaa blueprint-suunnitelman luomista.
  • Kun Blueprint-suunnitelma on jo olemassa: Yleisen järjestelmänvalvojan on suoritettava a365 setup permissions mcp erikseen. Järjestelmänvalvojan on suoritettava a365 config display ensin, jotta hän voi varmistaa, että deploymentProjectPath hänen pisteistään a365.config.json projektikansioon, joka sisältää päivitetyn -kohteen ToolingManifest.json.

add-mcp-servers Argumentit

Määritä vähintään yksi MCP-palvelimen nimi, joka lisätään agenttimääritykseen. Voit antaa useita palvelinnimiä välilyönneillä eroteltuina.

Argumentti Kuvaus
<servers> Lisällisten MCP-palvelinten nimet

add-mcp-servers asetukset

Näiden asetusten avulla voit mukauttaa komennon add-mcp-servers toimintaa, mukaan lukien määritystiedoston valinnan ja kuivakäytön testauksen.

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletus: a365.config.json
--dry-run Näytä, mitä komento tekee ilman sen suorittamista.
-?, -h, --help Näytä ohjeet ja käyttötiedot.

develop remove-mcp-servers

Poista MCP-palvelimet nykyisestä agentin määrityksestä.

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

Tämä komento poistaa määritetyt MCP-palvelimet nykyisestä agentin määrityksestä.

remove-mcp-servers Argumentit

Argumentti Kuvaus
<servers> Poistettavat MCP-palvelinten nimet

remove-mcp-servers asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletus: a365.config.json
--dry-run Näytä, mitä komento tekee ilman sen suorittamista.
-?, -h, --help Näytä ohjeet ja käyttötiedot.

develop add-permissions

Lisää MCP-palvelimen ohjelmointirajapinnan käyttöoikeudet Microsoft Entra sovelluksia kehitysskenaarioita varten, joissa sinun on määritettävä mukautetut sovellukset MCP-palvelimien käyttöä varten.

a365 develop add-permissions [options]

add-permissions asetukset

Näiden vaihtoehtojen avulla voit lisätä vaaditut ohjelmointirajapinnan käyttöoikeudet ja vaikutusalueet sovelluksen rekisteröintiin hyödyntäen arvoja työkalujen luettelotiedostosta.

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku (oletus: a365.config.json)
-m, --manifest <manifest> Polku kohteeseen ToolingManifest.json (oletus: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Sovelluksen (asiakasohjelman) tunnus oikeuksien lisäämiseksi kohteeseen (oletus: clientAppId määrityksestä)
--scopes <scopes> Lisätyt tietyt vaikutusalueet (välilyöntierotettu) (oletus: kaikki alueet kohteesta ToolingManifest.json)
--dry-run Näytä, mitä komento tekee tekemättä muutoksia
-v, --verbose Näytä yksityiskohtaiset tulokset
-?, -h, --help Näytä ohjeet ja käyttötiedot.

Tärkeää

--app-id:n tai clientAppId:n määrittämällä sovelluksella on oltava Application.ReadWrite.All-käyttöoikeus Microsoft Entra. Tämä komento on tarkoitettu mukautetuille asiakassovelluksille. Käytä sen sijaan agentti Blueprintsin käyttöoikeuksien määrittämiseen a365 setup permissions mcp .

develop get-token

Haltijatunnusten noutaminen MCP-palvelinten testaamista varten kehityksen aikana vuorovaikutteisen selaintodennuksen avulla.

a365 develop get-token [options]

get-token asetukset

Näiden asetusten avulla voit pyytää käyttöoikeustietuetta, hallita vaikutusalueita, päivittää ja valita tulostemuodon.

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku (oletus: a365.config.json)
--app-id <app-id> Sovelluksen (asiakkaan) tunnus todentamista varten (oletus: clientAppId määritystoiminnosta)
-m, --manifest <manifest> Polku kohteeseen ToolingManifest.json (oletus: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Tietyt pyydettävät vaikutusalueet (välilyöntierotettu) (oletus: Lue kohteesta ToolingManifest.json)
-o, --output <output> Tulostemuoto: table, jsontai raw (oletus: table)
--force-refresh Tunnuksen päivityksen pakottaminen ohittamaan välimuisti
--resource <resource> Resurssin avainsana, jota varten tunnus hankitaan: mcp (oletus) tai powerplatform
--resource-id <resource-id> Mukautettu resurssisovellustunnus (GUID) resursseille, jotka --resource eivät kuulu avainsanoihin
-v, --verbose Näytä yksityiskohtaiset tulokset koko tunnus mukaan lukien
-?, -h, --help Näytä ohjeet ja käyttötiedot.

get-token resurssiasetukset

Hanki tunnukset eri Azure resursseille käyttämällä --resource/>- ja --resource-id -asetuksia:

  • --resource: Valitse esimääritetty resurssi avainsanan avulla:
    • mcp (oletus): Agentti 365 -työkalut MCP-palvelimille
    • powerplatform: Power Platform -ohjelmointirajapinta
  • --resource-id: Anna mukautetun resurssin sovellustunnus (GUID) niille resursseille, jotka eivät kuulu avainsanoihin

Tärkeää

--resource ja --resource-id ettei niitä voi käyttää yhdessä. Kun käytät jommankumman vaihtoehdon, sisällytä mukaan --scopes. Vain oletusarvoinen MCP-työnkulku tukee luettelopohjaista vaikutusalueen tarkkuutta.

develop start-mock-tooling-server

Käynnistä testityökalupalvelin testausta ja kehitystarkoituksia varten.

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

Tämä komento käynnistää testityökalupalvelimen testaus- ja kehitystarkoituksiin. Käyttämällä tätä palvelinta voit simuloida MCP-palvelimen toimia ilman varsinaisia palvelintoteutuksia.

start-mock-tooling-server asetukset

Näiden asetusten avulla voit mukauttaa komennon start-mock-tooling-server toimintaa.

Vaihtoehto Kuvaus Oletus
-p, --port <port> Mallipalvelimen porttinumero 5309
-v, --verbose Yksityiskohtaisen kirjaamisen käyttöönotto väärä
-?, -h, --help Näytä ohjeet ja käyttötiedot -
-bg Palvelimen suorittaminen uudessa päätteessä -