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

Ota agentin 365 sovellus binaarit käyttöön määritetyissä Azure App Service ja päivitä Agent 365 -työkalujen käyttöoikeudet deploy -komento tarjoaa vaihtoehtoja Agent 365 -käyttöönottojen luomiseen. Tämän komennon avulla voit ottaa käyttöön sovellus binaarit Azure-infrastruktuurissa ja myöntää Agent 365 Tools -käyttöoikeudet.

Minimum-rooli pakollinen: Azure Contributor + Global Administrator

Lisätietoja tämän komennon käyttämisestä on kohdassa Deploy-agentti Azure.

Syntaksi

a365 deploy [command] [options]

Asetukset

Huomautukset

Käynnissä a365 deploy ilman alivalintaaja suorittaa kaksivaiheisen käyttöönoton:

• Phase 1 – Application binaries: Luo ja ottaa sovelluksesi käyttöön Azure App Service.
• Vaihe 2 – McP-käyttöoikeudet: lukee pakolliset toolingManifest.json vaikutusalueet ja päivittää agentin Blueprint-suunnitelmalle tarvittavat käyttöoikeudet.

Molemmat vaiheet suoritetaan myös :n kanssa --dry-run. Kuivatuloste on jaettu kahteen otsikkoon, jotta voit tarkastella, mitä kukin vaihe tekisi.

Esivalotarkistukset

Ennen käyttöönottoa komentorivikäyttöliittymä vahvistaa seuraavat:

• Azure todentaminen ja tilaus: Azure CLI-istunnon ja tilauksen on oltava kelvollisia. Jos näin ei ole, käyttöönotto päättyy virheeseen. Olemme korjanneet ongelman mittarin ja az login --tenant <TENANT_ID>avullaaz account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service existence: Kohdeverkkosovelluksen on oltava olemassa ennen käyttöönoton jatkamista. Jos sovellusta ei löydy, suorita a365 setup tai tee se oikein webAppName ja resourceGroup suorita kohteessa a365.config.json.

Määritykset

Komentorivikäyttöliittymässä on kaksi määritystiedostoa:

• a365.config.json — projektisi määritykset (käyttäjälle ylläpidettävä).
• a365.generated.config.json — dynaaminen tila, joka luodaan asennuskomennoilla.

MCP-työkalujen vaikutusalueet luetaan käyttöönottoprojektin hakemistosta toolingManifest.json .

Komentorivikäyttöliittymässä on myös yleinen määritysten ja tilan kopio osoitteessa

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• Linux/macOS: ~/.config/a365

Merkinnän toiminta

--restart: Ohittaa koontivaiheen ja aloittaa suoraan olemassa olevan publish/ kansion pakkaamisesta. Jos publish/ ei ole olemassa, käyttöönotto epäonnistuu. Suorita täysi käyttöönotto (ilman --restart) ensin luodaksesi kansion publish/ .

--inspect: Keskeytyy ennen latausvaihetta, jotta voit tarkastaa kansion publish/ ja luodun ZIP-tiedoston. Käytettävissä vain sovellusvaiheessa.

--dry-run: Tulostaa kaiken, mitä tapahtuisi ilman muutoksia. Kun suoritetaan a365 deploy (kaksivaiheinen), tulos jaetaan:

• Osa 1 – Sovellus binaarien käyttöönotto
• Osa 2: Agent 365 -työkalujen käyttöoikeuksien käyttöönotto ja päivitys

deploy app

Ottaa agenttikoodisi käyttöön määrityksen aikana luodussa Azure Web Appissa.

a365 deploy app [options]

Ota Käyttöön Microsoft Agent 365 -sovellus binaarit määritetyille Azure App Service. Tämä komento ottaa käyttöön sovellus binaarit määritetyssä Azure-sovelluspalvelussa Azure.

app asetukset

deploy mcp

Päivittää MCP-palvelimen käyttöoikeudet agenttisi Blueprint-suunnitelmaan.

a365 deploy mcp [options]

mcp asetukset

Käyttötiedot

Päivitä MCP-palvelinten vaikutusalueet ja käyttöoikeudet olemassa olevassa agentin Blueprint-suunnitelmassa. Komento lisää agentti 365 Toolsin käyttöoikeudet agentti Blueprint-agentille.

Jos lisäät tai muokkaat MCP-palvelimia agenttikoodissasi, päivitä tämän komennon avulla agenttisi Blueprint-suunnitelman käyttöoikeudet.

Tämä komento:

• Lukee MCP-palvelimen määritykset koodistasi.
• Päivittää agentin Blueprint-suunnitelmalle tarvittavat käyttöoikeudet.
• Antaa tarvittavat ohjelmointirajapintaoikeudet MCP-palvelimille.

Käyttöoikeuspäivitys on voimassa seuraavassa järjestyksessä:

1. OAuth2-käyttöoikeuden myöntäminen (Blueprint-palvelun päänimi → MCP-alusta)
2. Perittävissä olevat käyttöoikeudet (agent blueprint → MCP-resurssi)
3. Järjestelmänvalvojan suostumus (agentin → MCP-ympäristö)

Milloin :a kannattaa käyttää deploy mcp?

• Kun olet lisännyt uudet MCP-palvelimet agentillesi.
• McP-palvelimen määritysten muuttamisen jälkeen.
• Kun MCP-työkalut eivät ole agenttisi käytettävissä.

Sinun ei tarvitse suorittaa deploy mcp:

• Ensimmäisen käyttöönoton yhteydessä. Tämä hoidetaan automaattisesti määrityksen aikana.
• Kun vain agenttilogiikkaa muutetaan ilman MCP:n muutoksia.
• Sen jälkeen, kun koodin rutiinipäivitykset eivät vaikuta työkaluihin.

Vianmääritys

Voit ratkaista komennon mahdolliset ongelmat seuraavien osioiden deploy avulla.

• Kirjaudu sisään Azure tai väärään tilaukseen
• Verkkosovellusta ei löytynyt
• Käyttöoikeuksien päivitys epäonnistuu
• --restart Epäonnistuu

Ei kirjautunut sisään Azure tai väärään tilaukseen

Suorita az login --tenant <TENANT_ID> ja az account set --subscription <SUBSCRIPTION_ID>.

Verkkosovellusta ei löytynyt

Varmista a365 setup , että on tehty, tai varmista, että webAppName ja resourceGroup ovat oikein kohteessa a365.config.json.

Käyttöoikeuksien päivitys epäonnistuu

• Vahvista AgentBlueprintId, AgenticAppId, ja ympäristö on määritetty kohteessa a365.config.json.
• Varmista, että tililläsi on oikeudet hallita palvelun päänimiä ja käyttöoikeuksia.
• Varmista, että käyttöönottoprojektin toolingManifest.json hakemistossa on kelvolliset alueet.

--restart Epäonnistuu

Suorita täysi käyttöönotto ilman --restart , että tuotat kansion publish/ , ja käytä --restart sitten seuraavia iteraatioita varten.

Logs

CLI-lokitiedostot tallennetaan kohteeseen:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• Linux/macOS: ~/.config/a365/logs/

Voit tarkastella viimeisimmän käyttöönottolokitiedoston 80 viimeistä riviä käyttämällä Get-Content -Windows tai tail Linuxissa/macOS:ssä:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Käytä suorituksenaikaisia sovelluslokeja varten Log Stream Azure-portaalissa sovelluspalvelun stdout/stderr-käyttöä varten.