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

Määritä Agentti 365 -ympäristö ja eriytettyjä vaiheita koskevat hallintatoiminnot. Käytä Agent 365 CLI setup -komentoviitettä luodaksesi piirustuksia, konfiguroidaksesi käyttöoikeudet ja suorittaaksesi alkuperäisen Agent 365 -asennustyönkulun.

Minimum-rooli pakollinen: Azure Contributor + Agent ID Developer

Note

Sinulla oleva rooli määrittää, kuinka suuri osa asetuksista suoritetaan yhdellä suorituksella. Yleinen järjestelmänvalvoja voi suorittaa kaikki vaiheet kerralla. Agent ID -ylläpitäjä ja Agent ID -kehittäjä voivat suorittaa kaikki vaiheet paitsi OAuth2-luvan myöntämisen (ylläpitäjän suostumus), jotka vaativat Global Administratorin toimia. Kun asennus on valmis, CLI tulostaa seuraavat vaiheet Global Administratorille suoraan ulostuloon.

Syntax

a365 setup [command] [options]

Asetukset

Option	Description
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Suositeltu suoritusjärjestys

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create blueprint
a365 setup blueprint

# 2. Configure MCP permissions
a365 setup permissions mcp

# 3. Configure bot permissions
a365 setup permissions bot

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

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

Voit myös suorittaa kaikki vaiheet kerralla:

# Full setup using config file (a365.config.json)
a365 setup all

# Config-free: no a365.config.json needed
a365 setup all --agent-name "MyAgent"

Jos suoritat agentin tunnuksen järjestelmänvalvojana tai agenttitunnuksen kehittäjänä (ei yleisenä järjestelmänvalvojana), a365 setup all kaikki vaiheet suoritetaan OAuth2-käyttöoikeuksia lukuun ottamatta. Kun se on valmis, tulos sisältää seuraavat vaiheet globaalille ylläpitäjälle avustusten suorittamiseksi — mukaan lukien suora linkki tai suostumus-URL, jonka he voivat avata.

Asiakassovelluksen valinta

Kun a365.config.json määritellään , clientAppIdasennus jatkaa kyseisen sovelluksen käyttöä. Konfiguratonta asetusta varten komentorivi käyttää seuraavaa järjestystä:

1. Microsoft:n hallinnoima Agent 365 CLI -yrityssovellus, sovellus-IDf54280f4-395e-4ea8-9e48-bf2d4952aa14, kun sen palveluperiaate on saatavilla vuokralaisessasi.
2. Vuokralaisen omistama hakemus nimeltä Agentti 365 CLI.
3. Sovellustunnus, jonka syötät kehotteesta, tai uusi vuokralaisen omistama sovellus, jonka globaali ylläpitäjä luo kehotteesta.

Mukautetun sovelluksen konfiguraatiota varten katso Agentti 365 CLI:n räätälöity asiakassovelluksen rekisteröinti.

setup requirements

Vahvista ja korjaa Agent 365:n 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.

Note

Microsoft-hallinnoimassa sovelluksessa setup requirements varmistetaan, että palvelupäähenkilö on läsnä ja että hankituissa tokeneissa on vaaditut delegoidut laajuudet. Se ei muuta Microsoftin sovellusrekisteröintiä eikä luo vuokralaisen paikallista käyttöoikeutta CLI-sovellukselle.

Tip

Jos Microsoft:n hallinnoimaa sovellusta eikä vuokralaisen omistamaa sovellusta nimeltä Agent 365 CLI ei ole saatavilla, setup requirements sinulta pyydetään mukautettua asiakassovellus-ID:tä. Globaali ylläpitäjä voi syöttää C pyynnöstä luoda ja konfiguroida vuokralaisen omistaman sovelluksen.

Kun valitaan vuokralaisen omistama mukautettu sovellus, setup requirements se tunnistaa ja korjaa myös puuttuvan wids valinnaisen korvausvaatimuksen. Ilman tätä väitettä roolien tunnistus voi epäonnistua hiljaisesti ja blueprint-lupien myöntäminen voidaan ohittaa aikana setup all. Jos tarkistus epäonnistuu, tuloste sisältää portaalilinkin ja az rest käskyn lisätä vaatimus, ja ohjeistetaan kirjautumaan ulos ja takaisin sisään, jotta seuraava token kantaa sen.

requirements asetukset

Option	Description
-v, --verbose	Ota yksityiskohtainen kirjaaminen käyttöön.
--category <category>	Suorita tarkistuksia vain tietylle kategorialle, kuten Azure, Authentication, PowerShell tai Tenant Enrollment.
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Note

setup requirements Ei vaadi konfiguraatiotiedostoa – aja se missä tahansa hakemistossa.

setup blueprint

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

Vähimmäisvaatimukset: Agent ID Developer -rooli

a365 setup blueprint [options]

blueprint asetukset

Option	Description
-n, --agent-name <name>	Agentin tukikohdan nimi. Kun tarjoat tämän vaihtoehdon, et tarvitse konfiguraatiotiedostoa. Komento tunnistaa automaattisesti vuokralaisen ID:n .az account show Ohita se .--tenant-id
--tenant-id <tenantId>	Azure AD-vuokraajan tunnus. Overrides auto-detection. Käytä kanssa.--agent-name
-v, --verbose	Näytä yksityiskohtainen tuloste.
--dry-run	Näytä, mitä komento tekee ilman sen suorittamista.
--skip-requirements	Ohita vaatimusten tarkistus. Käytä varoen.
--no-endpoint	Älä rekisteröi viestien päätepistettä (vain Blueprint).
--endpoint-only	Rekisteröi vain viestien päätepiste. Vaatii suunnitelman.
--update-endpoint <url>	Poista olemassa oleva viestintäpäätepiste ja rekisteröi uusi määritetty URL-osoite.
--messaging-endpoint <url>	HTTPS-URL rekisteröitymiseen --endpoint-only. Ohittaa arvon messagingEndpoint joukossa a365.config.json. Käytä sitä käyttöönoton jälkeen, kun agentin callback-URL on tiedossa. (--endpoint-only ja --update-endpoint ottaa M365-rekisteröintireitti automaattisesti käyttöön, joten sinun ei tarvitse läpäistä --m365.)
--m365	Kohtele tätä agenttia kuin M365-agenttia. Valinnainen ja a365 setup blueprint - --endpoint-only--update-endpoint käytän jo M365 (Teams Graph) -reittiä automaattisesti. Viestipäätepisteen konfigurointiin osana täyttä asetusta käytä a365 setup all --m365. Oletus on false (opt-in).
--show-secret	Näytä tallennettu blueprint-asiakasohjelman salaisuus selväkielisenä. Asennusvaiheita ei tehdä. Windows:ssa se vaatii saman koneen ja käyttäjätilin, joka ajoi asennuksen.
-?, -h, --help	Näytä 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

Option	Description
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Subcommands

Subcommand	Description
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 hän voi käynnistää Copilot Studio Copilots-kohteen 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]

This command:

• 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.

Important

• Ennen tämän komennon suorittamista varmista, että deploymentProjectPath se osoittaa projektikansioon, joka sisältää päivitetyn ToolingManifest.json. 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

Option	Description
-n, --agent-name <name>	Agentin tukikohdan nimi. Kun tarjoat tämän vaihtoehdon, et tarvitse konfiguraatiotiedostoa.
--tenant-id <tenantId>	Azure AD-vuokraajan tunnus. Overrides auto-detection. Käytä kanssa.--agent-name
-v, --verbose	Näytä yksityiskohtainen tuloste.
--dry-run	Näytä, mitä komento tekee ilman sen suorittamista.
--remove-legacy-scopes	Poistaa aiemmat jaetut vaikutusalueet (McpServers.*.All muoto) Blueprint-suunnitelmasta siirryttyään palvelinkohtaisiin käyttöoikeuksiin (Tools.ListInvoke.All). Käytä sitä vasta, kun V2 SDK on vahvistettu toimivaksi – V1 SDK:n agentit menettävät työkalun pääsyn, jos ne poistetaan ennenaikaisesti.
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Siirtyminen palvelinkohtaisiin MCP-käyttöoikeuksiin

Käytä --remove-legacy-scopes , kun siirryt vanhasta jaettujen käyttöoikeuksien mallista palvelinkohtaisiin käyttöoikeuksiin:

• Vanha jaettu malli: Yksittäisen resurssin sovellustunnus (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1), jossa on jaettuja vaikutusalueita, kuten McpServers.Mail.All ja McpServers.Teams.All.
• Palvelinkohtainen malli: Kullakin MCP-palvelimella on oma sovellustunnus, jonka vaikutusalue Tools.ListInvoke.Allon .

Seuraavassa esimerkissä näytetään, miten palvelinkohtaiset käyttöoikeudet näkyvät Microsoft Entra -hallintakeskus, kun Blueprint-suunnitelma on käytössä. Jokaisella MCP-palvelimella, kuten Work IQ Calendar MCP:llä ja work IQ Mail MCP:llä, on oma delegoitu Tools.ListInvoke.All vaikutusalueensa. Jaettu McpServersMetadata.Read.All vaikutusalue tarjoaa pääsyn MCP-palvelimen metatietoihin.

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)

a365 setup permissions bot [options]

permissions bot asetukset

Option	Description
-n, --agent-name <name>	Agentin tukikohdan nimi. Kun tarjoat tämän vaihtoehdon, et tarvitse konfiguraatiotiedostoa.
--tenant-id <tenantId>	Azure AD-vuokraajan tunnus. Overrides auto-detection. Käytä kanssa.--agent-name
-v, --verbose	Näytä yksityiskohtainen tuloste.
--dry-run	Näytä, mitä komento tekee ilman sen suorittamista.
-?, -h, --help	Näytä 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äalueisiin, kuten läsnäoloon, tiedostoihin ja keskusteluun, tai mukautettuihin ohjelmointirajapintoihin, jotka on rekisteröity organisaatiosi Microsoft Entra ID vuokraajaan.

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

Edellytykset: Suorita a365 setup blueprint ensin.

a365 setup permissions custom [options]

This command:

• 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.
• Täsmäyttää Microsoft Entra nykyiseen määritykseen lisäämällä uusia käyttöoikeuksia ja poistamalla määrityksestä poistamasi käyttöoikeudet.
• On idempotentti ja turvallinen ajaa useita kertoja.

permissions custom asetukset

Option	Description
-n, --agent-name <name>	Agentin tukikohdan nimi. Kun tarjoat tämän vaihtoehdon, et tarvitse konfiguraatiotiedostoa.
--tenant-id <tenantId>	Azure AD-vuokraajan tunnus. Overrides auto-detection. Käytä kanssa.--agent-name
-v, --verbose	Näytä yksityiskohtainen tuloste.
--dry-run	Näytä, mitä komento tekee ilman sen suorittamista.
--resource-app-id <guid>	Resurssisovelluksen ID (GUID) inline-mukautetulle luvalla. Käytä kanssa.--scopes
--scopes <scopes>	Pilkulla erotellut delegoidut scope-alueet inline-mukautetun luvan osalta. Käytä kanssa.--resource-app-id
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Mukautetut käyttöoikeudet konfiguroi rivissä

Käytä --resource-app-id ja --scopes soveltaa mukautettuja oikeuksia suoraan ilman muokkausta a365.config.json:

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

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

Resurssin nimi ratkaistaan automaattisesti Microsoft Entra:sta. Sinun ei tarvitse tarkentaa sitä.

Määritä mukautetut oikeudet config-tiedoston avulla

Vaihtoehtoisesti lisää customBlueprintPermissions ja a365.config.json suorita komento ilman inline-lippuja:

a365 setup permissions custom

Tämä komento sovittaa Microsoft Entra:n konfiguroituihin käyttöoikeuksiin – se lisää uusia käyttöoikeuksia ja poistaa kaikki konfiguraatiosta poistetut käyttöoikeudet.

Integrointi setup all:n kanssa

Kun määritys sisältää mukautetut käyttöoikeudet, suorittaminen a365 setup all määrittää ne automaattisesti osana yksittäisen erän käyttöoikeusvaihetta. Täydellinen määritysjärjestys on:

1. Blueprint
2. Käyttöoikeuserä (MCP, Bot API, Mukautetut blueprint-käyttöoikeudet – kaikki määritetty yhdessä)

setup permissions copilotstudio

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

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

Edellytykset: Suorita a365 setup blueprint ensin.

a365 setup permissions copilotstudio [options]

This command:

• 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.

permissions copilotstudio asetukset

Option	Description
-n, --agent-name <name>	Agentin tukikohdan nimi. Kun tarjoat tämän vaihtoehdon, et tarvitse konfiguraatiotiedostoa.
--tenant-id <tenantId>	Azure AD-vuokraajan tunnus. Overrides auto-detection. Käytä kanssa.--agent-name
-v, --verbose	Näytä yksityiskohtainen tuloste.
--dry-run	Näytä, mitä komento tekee ilman sen suorittamista.
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Käytä tätä komentoa, kun agentin on kutsuttava Copilot Studio-kuvakkeita 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ää: Blueprint ja Permissions.

Suoritettavat vaiheet riippuvat roolistasi:

Step	Global Administrator	Agentin tunnuksen järjestelmänvalvoja	Agent ID Kehittäjä
Prerequisites check	Yes	Yes	Yes
Agentti Suunnitelman luominen	Yes	Yes	Yes
Inheritable permissions	Yes	Yes	Yes
OAuth2-käyttöoikeudet myöntää (järjestelmänvalvojan suostumus)	Yes	Edellyttää GA-vaihe	Edellyttää GA-vaihe
Agentin identiteettioikeudet (--authmode s2s tai both)	Yes	PowerShell fallback	PowerShell fallback

Kun suoritat a365 setup all ilman yleistä järjestelmänvalvojaa, komentorivikäyttöliittymä:

1. Suorittaa kaikki mahdolliset vaiheet (Blueprint-suunnitelman luominen ja periytyvät käyttöoikeudet).
2. Luo resurssikohtaisten järjestelmänvalvojien hyväksynnän URL-osoitteet ja tallentaa ne kohteeseen a365.generated.config.json.
3. Näyttää seuraavat vaiheet tulosteessa, jotta globaali ylläpitäjä voi suorittaa OAuth2-avustukset, mukaan lukien suora linkki tai suostumus-URL.

Tip

Jos olet yleinen järjestelmänvalvoja, a365 setup all viimeistelee kaiken yhdellä suorituksella ilman luovutusta.

Vaaditut vähimmäisoikeudet:

• Agent ID Developer -rooli (Blueprint-suunnitelman luomista varten)
• Global Administrator (OAuth2-käyttöoikeuksien myöntämiseen – jos ei ole saatavilla, CLI tulostaa seuraavat vaiheet tulosteessa)
• Application Administrator tai Global Administrator (S2S (Server-to-Server) -agentti-identiteettiluville – --authmode s2s tai both; jos ei ole saatavilla, CLI tulostaa PowerShell-varasuunnitelman asennusyhteenvetoon)

setup all asetukset

Option	Description
-v, --verbose	Näytä yksityiskohtainen tuloste.
--dry-run	Näytä, mitä komento tekee ilman sen suorittamista.
--skip-requirements	Ohita vaatimusten tarkistus. Käytä varovasti: määrittäminen voi epäonnistua, jos edellytykset eivät täyty.
--aiteammate	Käytä tätä parametria ohjataksesi tekoälytiimikaverin agenttivirtaa luomaan vain blueprintin ja käyttöoikeudet. Ilman tätä parametria blueprint-agenttivirta luo automaattisesti agentin identiteettipalvelun päähenkilön ilman Entra-käyttäjää. Tämä parametri ohittaa kentän aiteammate joukossa a365.config.json.
--authmode <mode>	Agentti-identiteetin käyttöoikeuksien todennusmalli (vain blueprint-agenteille). obo (oletus) — päähenkilön laajuudessa delegoidut avustukset, ei hallinnollista roolia tarvita. s2s — sovellusroolien määrittäminen agentin identiteetin SP:ssä, vaatii Sovelluksen ylläpitäjän tai globaalin ylläpitäjän; PowerShellin varajärjestelmä tulostettu, jos rooli puuttuu. both — soveltaa OBO (On-Behalf-Of) ja S2S-avustuksia. Ei tue .--aiteammate Voidaan myös asettaa muodossa authModea365.config.json.
--agent-registration-only	Ohita blueprint- ja käyttöoikeusvaiheet ja suorita vain agentin rekisteröinti. Käytä tätä epäonnistuneen rekisteröintivaiheen uudelleenyrityksenä.
--m365	Kohtele tätä agenttia kuin M365-agenttia. Rekisteröi viestipäätepisteen MCP-alustan kautta. Oletus on false (opt-in).
--messaging-endpoint <url>	HTTPS-URL, jossa otettu M365-agentti vastaanottaa viestejä. Käytä kanssa.--m365 Kun suoritus jätetään pois, interaktiivinen suoritus pyytää URL-osoitteen, ja ei-interaktiivinen suoritus lykkää sen — päätepiste on jälki-julkaisun artefakti, joten sen rekisteröinti myöhemmin on odotettu ensimmäinen reitti. Katso Viestinnän päätepiste.
-n, --agent-name <name>	Agentin perusnimi (esimerkiksi MyAgent). Määritystiedostoa ei vaadita, kun se on annettu. Johtaa näyttönimet seuraavasti: <name> Identity ja <name> Blueprint. TenantId tunnistetaan automaattisesti kohteesta az account show (ohita määrityksellä --tenant-id). ClientAppId käyttää oletuksena Microsoft:n hallinnoimaa Agent 365 CLI -yrityssovellusta, ja palaa sitten vuokralaisen omistamaan sovellukseen nimeltä Agent 365 CLI.
--tenant-id <tenantId>	Azure AD-vuokraajan tunnus. Ohittaa automaattisen tunnistuksen palvelusta az account show. --agent-name-kohteen käyttäminen käytettäessä ei-vuorovaikutteista ympäristöä tai tietylle vuokraajalle.
-?, -h, --help	Näytä ohjeet ja käyttötiedot.

Agent setup

Oletuksena se a365 setup all suorittaa blueprint-agenttivirran. Tämä työnkulku luo agentin ilman Dataversen tai tekoälyn tiimin riippuvuuden. Se toimii agenteille, jotka kommunikoivat suoraan Agent 365 -alustan kanssa.

# Default: uses a365.config.json
a365 setup all

# Or explicitly (same result)
a365 setup all --aiteammate false

Jos haluat ajaa tekoälyn tiimikaverin agenttivirran, läpäise --aiteammate.

Tämä työnkulku suorittaa seuraavat vaiheet järjestyksessä:

1. Requirements validation – tarkistaa Azure roolit ja edellytykset.
2. Tystulos – luo tai käyttää uudelleen Entra ID -tunnus Agent Blueprint -sovellusta.
3. Batch-käyttöoikeudet – määrittää delegoidut käyttöoikeusapurahat Blueprint-suunnitelmalle Microsoft Graph, agentin 365-työkaluille, viestibotin ohjelmointirajapinnalle, observability-ohjelmointirajapinnalle, Power Platformille ja mahdollisille mukautetuille resursseille.
4. Agent Identity creation – luo agentin identiteetin Entra ID -tunnus Agent Identity -Graph API kautta.
5. Agenttirekisteröinti – rekisteröi agentin AgentX V2 Agent Registration -ohjelmointirajapinnan kautta.
6. Määrityksen synkronointi – kirjoittaa suorituksenaikaiset yhteysasetukset ja havaittavuusmääritykset projektitiedostoihisi (appsettings.json, .env).

Note

Jos AI Teammate -agenttivirta käyttää vuokralaisen omistamaa räätälöityä asiakassovellusta, sovellus vaatii lisäbeta-API-oikeuksia perusjoukon lisäksi. Katso Mukautettu asiakassovelluksen rekisteröinti saadaksesi täydellisen vaaditun käyttöoikeuslistan.

Määritys maksutta -asetus ja --agent-name

Jos sinulla ei ole tiedostoa a365.config.json , suorita asennus käyttämällä - --agent-name sovellusta ilman sellaista. Komentorivi tunnistaa vuokralaisen automaattisesti ja etsii ensin Microsoft:n hallinnoiman Agent 365 CLI -yrityssovelluksen.

# Preview what would happen (no changes made)
a365 setup all --agent-name "MyAgent" --dry-run

# Run the full setup
a365 setup all --agent-name "MyAgent"

Käytettäessä :--agent-name

• TenantId tunnistetaan automaattisesti kohteesta az account show. Välitä --tenant-id ohitukseen.
• ClientAppId käyttää oletuksena Microsoft:n hallinnoimaa sovellusta, kun sen palveluperiaate on olemassa. Muussa tapauksessa CLI etsii vuokralaisen omistamaa sovellusta nimeltä Agent 365 CLI. Jos kumpaakaan sovellusta ei ole saatavilla, komentokeskus pyytää mukautettua sovellus-ID:tä tai Global Administratorille tarjoaa vuokralaisen omistaman sovelluksen luomista.
• Näyttönimet johdetaan seuraavasti: <name> Agent (identity) ja <name> Blueprint (Blueprint).
• Infrastruktuuri ohitetaan aina (oletettu ulkoinen isännöinti).
• Määrityssynkronointi (kirjoittaminen appsettings.json) ohitetaan, koska projektipolkua ei ole määritetty.

Järjestelmänvalvojan suostumus määrityksen aikana

Microsoft:n hallinnoimalle sovellukselle CLI validoi hankittujen tokenien delegoidut laajuudet eikä luo AllPrincipals käyttöoikeutta CLI-sovellukselle.

Jos vuokralaisen omistama räätälöity asiakassovellus ei anna AllPrincipals ylläpitäjän suostumusta vaadittaviin käyttöoikeuksiin, komentokeskus havaitsee tämän ja pyytää sinua myöntämään suostumuksen interaktiivisesti:

The following permissions require admin consent:
  AgentIdentity.ReadWrite.All
  AgentIdentity.Create.All
  ...
Grant admin consent for these permissions now? [y/N]:

Syötä y , jos haluat antaa suostumuksen rivissä. Jos et ole Global Administrator, hylkää — CLI tulostaa seuraavat vaiheet Global Administratorille asetusyhteenvetoon.

Viestipäätepiste (--m365)

Kun läpäiset --m365, a365 setup all rekisteröi agentin viestipäätepisteen, HTTPS-URL-osoitteen, johon otettu agentti vastaanottaa viestejä, Agent 365 -alustalla.

Päätepiste on jälki-julkaisun artefakti: ensimmäisessä asennuksessa agenttia ei yleensä ole vielä otettu käyttöön, joten sen URL-osoitetta ei ole olemassa. CLI hoitaa tämän:

• Toimita se suoraan--messaging-endpoint <url> (esimerkiksi käyttöönoton jälkeen tai kun käytät Dev Tunnelia paikalliseen testaukseen).
• Interaktiivinen ajo, ei URL-osoitteita: komentorivi pyytää sitä. Jätä se tyhjäksi ohitettavaksi.
• Ei-interaktiivinen suoritus (CI tai skriptattu), ei URL-osoitteita: vaihe siirretään ja suoritus onnistuu silti — mikään ei epäonnistu.

Kun päätepiste on siirretty, rekisteröi se myöhemmin, kun agentti on otettu käyttöön:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Lisätietoja viestinpäätepisteestä löytyy kohdasta Agentin viestipäätepiste.

Agentin henkilöllisyyden myöntämiset (--authmode)

Oletuksena luodaan a365 setup all päähenkilökohtaiset delegoidut avustukset agentin identiteettipalvelun päähenkilölle (obo tila). Nämä apurahat eivät vaadi ylläpitäjän roolia.

Käytä --authmode apurahatyypin hallintaan:

Value	Behavior	Minimum role
obo (oletus)	Päällikön laajuudessa delegoidut avustukset agentin identiteetille SP	Ei mitään (mikään todennettu käyttäjä)
s2s	Sovellusroolien määritykset agentin identiteetin SP:ssä	Sovelluksen ylläpitäjä tai globaali ylläpitäjä
both	Sekä OBO delegoi apurahoja että S2S-sovellusten roolijakoja	S2S-rooli (yllä) S2S-osuudelle

# Default — OBO delegated grants (no admin role needed)
a365 setup all

# S2S app role assignments
a365 setup all --authmode s2s

# Both OBO and S2S
a365 setup all --authmode both

Kun kirjautuneelta käyttäjältä puuttuu vaadittu rooli S2S-avustuksiin, komentoryhmä tulostaa PowerShell-varasuunnitelman asetusyhteenvetoon. Ylläpitäjä voi suorittaa sen suorittaakseen tehtävät.

Aseta authModea365.config.json niin, että se pätee jokaisella pelikierroksella ilman lippua:

{
  "authMode": "s2s"
}

Note

--authmodeei ole tuettu .--aiteammate Tekoälytiimikaverin agentit käyttävät OBO:ta automaattisesti agentin käyttäjätunnuksen kautta.

Config sync

Onnistuneen suorituksen jälkeen komentorivikäyttöliittymä kirjoittaa automaattisesti suorituksenaikaiset asetukset projektitiedostoihisi:

Setting	Written to	Description
Connections.ServiceConnection	appsettings.json / .env	Blueprint-asiakastunnus, asiakkaan salasana, vuokraajan tunnus ja tunnuksen päätepiste
Agent365Observability	appsettings.json / .env	Agentin tunnus (agentin tunnus), blueprint-tunnus, vuokraajatunnus, asiakastunnus ja telemetrian viennin asiakassalaisuus
TokenValidation	appsettings.json	Tunnuksen vahvistusasetukset (oletusarvoisesti poissa käytöstä muille kuin DW:lle)
ConnectionsMap	appsettings.json / .env	Yhteyden yhdistämisen oletusarvoinen palvelun URL-osoite

Komentorivikäyttöliittymä luo tiedoston, jos sitä ei ole olemassa, ja päivittää yksittäiset kentät korvaamatta muita määrityksiä.

Epäonnistuneen rekisteröinnin uudelleenyrityksenä

Jos asennus suorittaa Suunnitelman ja käyttöoikeudet onnistuneesti, mutta epäonnistuu agentin rekisteröinnin aikana, yritä --agent-registration-only vain kyseistä vaihetta uudelleen toistamatta aiempaa työtä:

a365 setup all --agent-registration-only