Jaa

Agent 365:n komentorivikäyttöliittymän setup 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.

Määritä Agentti 365 -ympäristö ja eriytettyjä vaiheita koskevat hallintatoiminnot. Tämä komento hallitsee agentin 365 Blueprintsin ensimmäisen asennuksen työnkulkua.

Minimum-rooli pakollinen: Azure Contributor + Global Administrator

Syntax

a365 setup [command] [options]

Asetukset

Vaihtoehto Kuvaus
-?, -h, --help Näyttää ohjeet ja käyttötiedot. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

Voit myös suorittaa kaikki vaiheet kerralla:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

Tarkista agentin 365 asennuksen edellytykset. Suorittaa modulaariset vaatimustarkistukset ja antaa ohjeita löytämilleen ongelmille.

a365 setup requirements [options]

Tämä komento suorittaa seuraavat vaiheet:

  • Tarkistaa kaikki Agent 365:n määritykseen tarvittavat edellytykset.
  • Ilmoittaa mahdollisista ongelmista yksityiskohtaisten ratkaisuohjeiden kanssa.
  • Jatkaa kaikkien vaatimusten tarkistamista, vaikka jotkin tarkistukset epäonnistuvat.
  • Antaa yhteenvedon kaikista tarkistusten lopusta.

requirements asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näyttää kaikkien tarkistusten yksityiskohtaisen tuloksen.
--category <category> Suorittaa vain tietyn luokan tarkistukset, kuten Azure, Authentication tai Configuration.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

setup infrastructure

infrastruktuurin luominen Azure.

Minimamin edellyttämät käyttöoikeudet: Azure tilauksen osallistuja tai omistaja

a365 setup infrastructure [options]

infrastructure asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

setup blueprint

Luo agentti Blueprint (Entra ID -sovelluksen rekisteröinti).

Vähimmäisvaatimukset: Agent ID Developer -rooli

a365 setup blueprint [options]

blueprint asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
--no-endpoint Älä rekisteröi viestien päätepistettä (vain Blueprint).
--endpoint-only Rekisteröi vain viestien päätepiste. Vaatii suunnitelman.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

setup permissions

Määritä OAuth2-käyttöoikeus myöntää ja periytyvät käyttöoikeudet.

Vähimmäisvaatimukset: Yleinen järjestelmänvalvoja

a365 setup permissions [command] [options]

Asetukset

Vaihtoehto Kuvaus
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

Alikondoinnit

Subcommand Kuvaus
mcp Määritä MCP-palvelimen OAuth2 myöntää ja periytyvät käyttöoikeudet.
bot Määritä viestibotin ohjelmointirajapinnan OAuth2 myöntää ja periytyvät käyttöoikeudet.
custom Käyttää agenttisi blueprint-suunnitelmaa mukautettuja ohjelmointirajapintakäyttöoikeuksia, jotka ylittävät agenttitoiminnossa edellytettävät vakiokäyttöoikeudet.
copilotstudio Määrittää OAuth2-käyttöoikeudet ja agentin Blueprint-järjestelmän periytyvät käyttöoikeudet, joiden avulla se voi käynnistää Copilot Studio -copilotit Power Platform -ohjelmointirajapinnan kautta.

setup permissions mcp

Määritä MCP-palvelimen OAuth2 myöntää ja periytyvät käyttöoikeudet.

Vähimmäisvaatimukset: Yleinen järjestelmänvalvoja

a365 setup permissions mcp [options]

Tämä komento:

  • Lukee ToolingManifest.json määritetystä kohteesta deploymentProjectPatha365.config.json.
  • Myöntää OAuth2:n delegoidut käyttöoikeusapurahat kullekin MCP-palvelimen laajuudelle agentille Blueprint-suunnitelmalle.
  • Määrittää perittävissä olevat käyttöoikeudet, jotta agenttiesiintymät voivat käyttää MCP-työkaluja.
  • On idempotentti ja turvallinen ajaa useita kertoja.

Tärkeää

  • Ennen kuin suoritat tämän komennon, suorita a365 config display sen tarkistamiseksi, että deploymentProjectPath osoittaa projektikansioon, joka sisältää päivitetyn ToolingManifest.json-kohteen. Jos kehittäjä lisää MCP-palvelimia eri koneeseen, jaa päivitys ToolingManifest.json ensin yleisen järjestelmänvalvojan kanssa. Jos toimit ilman oikeaa ToolingManifest.json , se ei lisää uusia MCP-palvelimen käyttöoikeuksia Blueprint-suunnitelmaan.
  • Suorita tämä komento, kun kehittäjä on suorittanut kohteen a365 develop add-mcp-servers. MCP-palvelinten lisääminen luettelotiedostoon ja käyttöoikeuksien myöntäminen Blueprint-suunnitelmaan ovat kaksi erillistä vaihetta. Kun tämä komento on suoritettu, MCP-palvelimen käyttöoikeudet näkyvät agentin Blueprint-suunnitelmassa.

permissions mcp asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

setup permissions bot

Määritä viestibotin ohjelmointirajapinnan OAuth2 myöntää ja periytyvät käyttöoikeudet.

Vähimmäisvaatimukset: Yleinen järjestelmänvalvoja

Edellytykset: Blueprint- ja MCP-käyttöoikeudet (suorita a365 setup permissions mcp ensin)

Seuraava vaihe: Ota agenttisi käyttöön (suorita a365 deploy, jos isännöit Azure)

a365 setup permissions bot [options]

permissions bot asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

setup permissions custom

Käyttää agenttisi blueprint-suunnitelmaa mukautettuja ohjelmointirajapintakäyttöoikeuksia, jotka ylittävät agenttitoiminnossa edellytettävät vakiokäyttöoikeudet. Tämän komennon avulla myönnät agentillesi käyttöoikeuden Microsoft Graph lisälaajuuteen, kuten läsnäolo, tiedostot ja keskustelu, tai mukautettuihin ohjelmointirajapintoihin, jotka on rekisteröity organisaatiosi Entra ID -vuokraajaan.

Vähimmäisvaatimukset: Yleinen järjestelmänvalvoja

Edellytykset: Suorita a365 setup blueprint ensin. Lisää mukautettuja käyttöoikeuksia kohteeseen a365.config.json - a365 config permissions toiminnolla ennen tämän komennon suorittamista.

a365 setup permissions custom [options]

Tämä komento:

  • Määrittää OAuth2:n delegoidut käyttöoikeudet myöntää järjestelmänvalvojan suostumuksen kullekin määritetylle resurssille.
  • Määrittää perittävissä olevat käyttöoikeudet, jotta agenttikäyttäjät voivat periä käyttöoikeuden Blueprint-suunnitelmasta.
  • Korjaa Microsoft Entra nykyiseen määritykseen lisäämällä uusia käyttöoikeuksia ja poistamalla määrityksestä poistetut käyttöoikeudet.
  • On idempotentti ja turvallinen ajaa useita kertoja.

permissions custom asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

Mukautettujen käyttöoikeuksien määrittäminen

Tämän avulla a365 config permissions voit lisätä määritykseen mukautettuja käyttöoikeuksia ennen tämän komennon suorittamista:

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Resurssin nimi ratkaistaan automaattisesti Azure:stä asennuksen aikana. Sinun ei tarvitse määrittää sitä määrityksessä.

Poista mukautetut käyttöoikeudet

Poista mukautetut käyttöoikeudet sekä määrityksestä että Microsoft Entra seuraavasti:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integrointi :n kanssa setup all

Kun määritys sisältää mukautetut käyttöoikeudet, ne määritetään automaattisesti suorittamalla a365 setup all . Täydellinen määritysjärjestys on:

  1. Infrastruktuuri
  2. Sinikopio
  3. MCP-käyttöoikeudet
  4. Botin ohjelmointirajapinnan käyttöoikeudet
  5. Mukautetut Blueprint-suunnitelman käyttöoikeudet (jos määritetty)
  6. Viestien päätepiste

setup permissions copilotstudio

Määrittää OAuth2-käyttöoikeudet ja agentin Blueprint-järjestelmän periytyvät käyttöoikeudet, joiden avulla se voi käynnistää Copilot Studio -copilotit Power Platform -ohjelmointirajapinnan kautta.

Vähimmäisvaatimukset: Yleinen järjestelmänvalvoja

Edellytykset: Suorita a365 setup blueprint ensin.

a365 setup permissions copilotstudio [options]

Tämä komento:

  • Varmistaa, että Power Platform -ohjelmointirajapinnan palvelun päänimi on vuokraajassasi.
  • Luo OAuth2-käyttöoikeuden myöntämisen Blueprint-suunnitelmasta Power Platform -ohjelmointirajapinnalle, joka sisältää laajuuden CopilotStudio.Copilots.Invoke .
  • Määrittää perittävissä olevat käyttöoikeudet, jotta agenttiesiintymät voivat käynnistää Copilot Studio -copilotit.

permissions copilotstudio asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.

Käytä tätä komentoa, kun agentin on kutsuttava Copilot Studio -copilots suorituksen aikana tai kutsuttava Power Platform -ohjelmointirajapintoja, jotka edellyttävät CopilotStudio-käyttöoikeuksia.

setup all

Määritä Agentti 365 -ympäristösi suorittamalla kaikki asennusvaiheet

a365 setup all [options]

Suorittaa Agent 365:n täydellisen määrityksen järjestyksessä kaikki vaiheet.

Sisältää: Infrastruktuuri, Blueprint, Käyttöoikeudet ja Päätepiste.

Vähimmäisoikeudet (yleisellä järjestelmänvalvojalla on kaikki nämä oikeudet):

  • Azure tilauksen osallistuja (infrastruktuurille ja päätepisteelle)
  • Agent ID Developer -rooli (Blueprint-suunnitelman luomista varten)
  • Yleinen järjestelmänvalvoja (käyttöoikeuksien myöntämiselle ja järjestelmänvalvojan suostumukselle)

setup all asetukset

Vaihtoehto Kuvaus
-c, --config <config> Määritystiedostopolku. Oletusarvo on a365.config.json.
-v, --verbose Näytä yksityiskohtainen tuloste.
--dry-run Näytä, mitä pitäisi tehdä ilman suorittamista.
--skip-infrastructure Ohita Azure infrastruktuurin luominen (käytä, jos infrastruktuuri on jo olemassa). Tämä vaihtoehto luo edelleen: Blueprint, Permissions ja Endpoint.
--skip-requirements Ohita vaatimusten tarkistus. Käytä varovasti: määrittäminen voi epäonnistua, jos edellytykset eivät täyty.
-?, -h, --help Näyttää ohjeet ja käyttötiedot.
  • Last updated on