Agent 365 CLI

Agent 365 CLI on monialustainen komentorivityökalu Agent 365 -sovellusten käyttöönottoon ja hallintaan Azuressa.

Sinun ei tarvitse asentaa CLI:tä manuaalisesti. AI-ohjattu käyttöönotto tarkistaa CLI:n, asentaa tai päivittää sen automaattisesti ja suorittaa kaikki tarvittavat komennot puolestasi. Tämä sivu toimii referenssinä kehittäjille, jotka tarvitsevat CLI:n asennusta tai suoraa käyttöä – esimerkiksi CI/CD-automaation rakentamisessa, tietyn vaiheen vianmäärityksessä tai työskennellessään ilman tekoälykoodausagenttia.

Muistiinpano

Koko kehittäjätyönkulku – mukaan lukien AI-ohjattu käyttöönotto, rooliohjaus ja käyttöönoton jälkeiset vaiheet – löytyy sivulta Agent 365 -kehityksen aloitus. Tämä sivu toimii CLI-dokumentaationa: asennus, päivitys, poisto, käytettävissä olevat komennot ja vianetsintä.

Edellytykset

CLI vaatii .NET 8.0:n tai uudemman. Kaikki muut vaatimukset – Azure-tilaus, tarvittavat Entra-roolit ja mukautetun asiakassovelluksen rekisteröinti – on esitelty osiosta AI-ohjattu asennus.

Agent 365 CLI:n asennus

Noudata seuraavia ohjeita asentaaksesi Agent 365 CLI:n globaalina työkaluna käyttöjärjestelmääsi.

Edellytykset

Vaatimus: .NET tulee olla asennettuna. (.NET 8.0 on suositeltu.)

Käytä dotnet tool install -komentoa

Asenna Agent 365 CLI käyttämällä seuraavaa komentoa:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Viimeisimmät ohjeet ja saatavilla olevat versiot löytyvät viralliselta NuGet-sivulta: Microsoft.Agents.A365.DevTools.Cli NuGet.orgissa

Asennuksen tarkistaminen

Agent 365 CLI:n asennuksen jälkeen varmista, että se on asennettu oikein suorittamalla --help-komento:

a365 -h

Tämä komento näyttää ohjetiedot ja vahvistaa, että CLI on käyttövalmis.

Update

Päivitä Agent 365 CLI käyttämällä dotnet tool update -komentoa:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Muistiinpano

Agent 365 CLI:n päivittämiseen tarvitset internet-yhteyden päästäksesi uusimpaan NuGet-pakettiin: Microsoft.Agents.A365.DevTools.Cli.

Poista

Poista Agent 365 CLI käyttämällä dotnet tool uninstall -komentoa:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Tiedoston sijainnit

Työkalun suoritettavan tiedoston oletussijainti riippuu käyttöjärjestelmästä.

Käyttöjärjestelmä Polku
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

SDK lisää tämän sijainnin polkuusi, kun sitä käytetään ensimmäisen kerran. Voit suorittaa globaaleja työkaluja mistä tahansa hakemistosta ilman, että määrittelet työkalun sijaintia.

Työkalun käyttö on käyttäjäkohtaista, ei järjestelmänlaajuista. Globaali työkalu on käytettävissä vain käyttäjälle, joka on asentanut työkalun.

Käytettävissä olevat komennot

Saatavilla olevien komentojen täydellisen luettelon saat --help-komennolla tai katsomalla Agent 365 CLI -viitteet.

Vinkki

CLI-komentoja ei tarvitse suorittaa manuaalisesti. Tekoälyohjattu käyttöönotto automatisoi koko työnkulun – CLI:n asennuksen, konfiguroinnin, blueprintin käyttöönoton, käyttöönoton ja julkaisun – tekoälypohjaisen koodausagentin avulla. Hyödynnä CLI-ohjeita, jos rakennat CI/CD-automaatiota, teet vianmääritystä tiettyyn vaiheeseen tai työskentelet ilman tekoälyagenttia.

Täydelliset ohjeet Agent 365 -agentin käyttöönottoon CLI:n avulla löydät kohdasta Aloita Agent 365 -kehitys.

Vianmääritys

Tässä osiossa annetaan tietoa Agent 365 CLI:n virheiden selvittämisestä.

Vinkki

Agent 365:n vianmääritysopas sisältää yleisluontoisia vianmääritykseen liittyviä suosituksia, parhaita käytäntöjä sekä linkkejä vianmääritykseen liittyvään sisältöön Agent 365:n kehityksen elinkaaren kaikissa vaiheissa.

Tässä osiossa käsitellään seuraavia CLI-kohtaisia ongelmia:

Agentti ei näy Teamsissa

Luo agentti-instanssien vianetsintä: Agentti ei näy Teamsissa

Agentti-instanssia ei voi luoda Teamsissa

Vianmääritys agentti-instanssin luomisessa Teamsissa: Agentti-instanssia ei voi luoda Teamsissa