Agentin ottaminen käyttöön Azuressa

Agentti on luotu ja testattu paikallisesti. Nyt agentti otetaan käyttöön pilvipalvelussa. Tämä vaihe on valinnainen. Voit ohittaa tämän vaiheen, jos olet jo ottanut agentin käyttöön johonkin pilvipalveluun (se voi olla Azure tai jokin muu).

Tässä oppaassa kerrotaan, miten agenttikoodi otetaan käyttöön Azure-palvelussa ja julkaistaan Microsoftin hallintakeskuksessa, jolloin siitä tulee organisaation rekisteröity resurssi.

Jos haluat päivittää viestinnän päätepisteen, katso alla olevat resurssit. Ne osoittavat, miten voit päivittää viestinnän päätepisteen, jos agentti on otettu käyttöön muiden pilvipalveluntarjoajien, kuten Amazon Web Servicesin tai Google Cloud Platformin, kautta:

• Käytä agenttikoodia, joka on otettu käyttöön Amazon Web Servicesissa
• Käytä agenttikoodia, joka on otettu käyttöön Google Cloud Platformissa

Edellytykset

Varmista ennen aloittamista, että käytettävissä ovat seuraavat kohteet:

Vaaditut tilit ja käyttöoikeudet

• Azure-tilaus osallistujan roolilla.
• Toimiva agenttikoodi, jossa on sallittu, saavutettavissa oleva viestinnän päätepiste. Varmista, että agentti on testattu paikallisesti. Vaihtoehtoisesti voit testata sen Microsoft 365:llä käyttämällä Dev Tunnels -ratkaisua, jos haluat varmistaa, että agenttikoodi voidaan luoda ja että sen suoritus tapahtuu odotetulla tavalla.
• Sallittu agentin suunnitelma, jonka saat suorittamalla agentin suunnitelman asennusvaiheen.
• Ajantasaiset määritystiedostot a365.config.json, a365.generated.config.json sekä määritystiedosto koodissa (esimerkiksi .env-tiedosto).

Tarvittavat työkalut

• Azure CLI asennettu ja todennettu (Asenna Azure CLI)

Ota käyttöön Azuressa

Ota agentin sovelluskoodi käyttöön Azuressa käyttämällä Azuren vakiotyökaluja, kuten Azure CLI, Azure-portaali ja GitHub Actions.

Agenttisovelluksen ottaminen käyttöön

Käytä Azure CLI:n az webapp deploy-komentoa sovelluksen käyttöönotossa seuraavasti:

# Build your project first (example for .NET)
dotnet publish -c Release -o ./publish

# Deploy to Azure Web App
az webapp deploy --name <your-web-app> --resource-group <your-resource-group> --src-path ./publish

Käytä GitHub Actionsissa Azure Web Apps Deploy -toimintoa.

Käyttöönoton tarkistaminen

Kun käyttöönotto on valmis, tarkista se tämän luettelon ja alla olevien osien ohjeiden avulla.

✅ Käyttöönottokomento suoritettiin ilman virheitä
✅ Verkkosovellus on käynnissä
✅ Sovelluslokeissa näkyy onnistunut käynnistys
✅ Ympäristömuuttujat on määritetty
✅ Viestinnän päätepiste vastaa

Tarkista, että käyttöönottokomento on suoritettu ilman virheitä

Kun käyttöönotto on valmis, tarkista onnistuminen käyttöönoton lokeista seuraavasti:

1. Siirry Azure-portaalissa verkkosovellukseen.
2. Siirry kohtaan Asetukset>Määritykset tarkistaaksesi sovelluksen asetukset.
3. Tarkista käyttöönoton lokit käyttöönottokeskuksessa.

Voit katsoa yksityiskohtaisen käyttöönottohistorian seuraavalla tavalla:

1. Siirry kohtaan Azure-portaali > verkkosovellus
2. Käyttöönotto>Käyttöönottokeskus
3. Tarkastele edellisen käyttöönoton lokeja

Jos luominen epäonnistuu:

• Tyhjennä ja luo se uudelleen ensin paikallisesti varmistaaksesi, että luominen onnistuu.
• Tarkista puuttuvat riippuvuudet ja syntaksivirheet.
• Katso Käyttöönottokomento epäonnistuu.

Jos sovellus kaatuu käyttöönoton jälkeen:

• Tarkista lokit erityisten virheilmoitusten varalta.
• Varmista, että kaikki vaaditut ympäristömuuttujat on määritetty.
• Katso Sovelluksen kaatuminen käynnistyksen aikana.

Varmista, että verkkosovellus on käynnissä

Käytä az webapp show-komentoa tarkistaaksesi, onko verkkosovellus käynnissä.

az webapp show --name <your-web-app> --resource-group <your-resource-group> --query state

Tämän komennon odotettu tulos on Running.

Varmista, että sovelluslokit osoittavat käynnistyksen onnistuneen

Näin tarkastelet verkkosovelluksen lokitietoja Azure-portaalissa:

1. Etsi verkkosovellus nimellä Azure-portaalissa.
2. Siirry kohtaan Yleiskatsaus>Lokit>Lokivirta.

Vaihtoehtoisesti voit käyttää PowerShellin az webapp log tail-komentoa, jos haluat lukea verkkosovelluslokeja:

az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

Jos lokit sisältävät kaatumis- tai virheilmoituksia, katso Sovelluksen kaatuminen käynnistyksessä.

Ympäristömuuttujien määrittämisen varmistaminen

Azure-portaalissa:

1. Siirry verkkosovellukseen.
2. Siirry kohtaan Asetukset>Ympäristömuuttujat.
3. Varmista, että asetukset ovat olemassa.

Jos ympäristömuuttujia ei ole määritetty:

• Käynnistä käyttöönotto uudelleen, jotta tiedot synkronoituvat .env-tiedostosta.
• Vaihtoehtoisesti voit määrittää ne manuaalisesti Azure-portaalissa.
• Katso Ympäristömuuttujia eivät ole määritetty tai ovat virheellisiä.

Varmista, että viestinnän päätepiste vastaa

Varmista, että verkkosovelluksen Yleiskatsaus-sivulta löytyvä päätepiste on olemassa PowerShellin tai muiden menetelmien avulla. Muussa tapauksessa katso 404 viestinnän päätepisteessä.

Seuraavat vaiheet

Julkaise seuraavaksi agenttisovellus Microsoftin hallintakeskuksessa, jotta voit luoda siitä agentti-instansseja ja käyttäjiä.

Agenttisi on nyt julkaistu pilveen, ja se on valmis vastaamaan agentin pyyntöihin. Kun agentti käsittelee todellisia pyyntöjä, voit määrittää koodille seuraavat vaiheet:

• Seuraa suorituskykyä: Käytä havaittavuusominaisuuksia agentin käyttäytymisen seuraamiseen ja vastausten optimointiin.
• Lisää työkaluja: Tutustu työkaluluetteloon laajentaaksesi agentin ominaisuuksia.
• Iteroi ja paranna: Päivitä agenttikoodi, ota se uudelleen käyttöön ja julkaise se uudelleen (muista nostaa versionumeroa).
• Skaalaa organisaatiossa: Jaa agentin menestystarinoita edistääksesi käyttöönottoa.

Vianmääritys

Tässä osassa kuvataan agenttien Azureen tehtävässä käyttöönotossa havaittuja yleisiä ongelmia.

Käyttöönottokomento epäonnistuu

Oire: Azure-käyttöönotto epäonnistuu.

Yleisiä syitä ja ratkaisuja:

• Koontivirheet

  Luo projekti uudelleen paikallisesti nähdäksesi yksityiskohtaiset käännösvirheet:

  # .NET
  dotnet clean
  dotnet build --verbosity detailed
  
  # Python
  uv build
  
  # Node.js
  npm install
  npm run build
  

• Azure-todennus vanhentunut

  Kirjaudu uudelleen sisään Azure-portaaliin seuraavasti:

  az login
  az account show  # Verify correct subscription
  

• Verkkosovellusta ei ole luotu

  Listaa verkkosovellukset seuraavasti varmistaaksesi, että kohde on olemassa:

  # List Web Apps in resource group
  az webapp list --resource-group <your-resource-group> --output table
  

• Tarkista käyttöönottolokit

  Käytä az webapp log tail-komentoa tarkastellaksesi yksityiskohtaisia käyttöönoton lokitietoja seuraavasti:

  az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
  

• Vahvistus:

  # Web App should be running
  az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
  # Expected: "Running"
  

Verkkosovellus on pysäytetty

Oire: Käyttöönotto onnistuu, mutta verkkosovellus ei ole käynnissä.

Ratkaisu: Käytä az webapp start- ja az webapp show-komentoa käynnistääksesi verkkosovelluksen ja varmistaaksesi, että se toimii.

# Start the Web App
az webapp start --name <your-app> --resource-group <your-resource-group>

# Verify it's running
az webapp show --name <your-app> --resource-group <your-resource-group> --query state

Sovellus kaatuu käynnistettäessä

Oire: Verkkosovellus käynnistyy, mutta kaatuu välittömästi. Lokit näyttävät virheitä.

Yleisimmät syyt:

• Puuttuvat riippuvuudet – Tarkista koonnin tuloksesta, että kaikki vaaditut paketit on lisätty.
• Puuttuvat ympäristömuuttujat – Varmista, että kaikki vaaditut asetukset on määritetty.
• Suorituspalvelun version ristiriidat – Varmista, että Azuren suorituspalvelu vastaa kehitysympäristöä.
• Koodivirheet – Tarkista sovelluslokit tiettyjen poikkeusten varalta.

Ratkaisu: Käytä az webapp log tail-, az webapp config appsettings list- ja az webapp config appsettings set-komentoa lokien tarkastelemisessa, ympäristömuuttujien tarkistamisessa ja puuttuvien muuttujien määrittämisessä.

# View application logs
az webapp log tail --name <your-app> --resource-group <your-resource-group>

# Check environment variables
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Manually set a missing variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings KEY=VALUE

404 viestinnän päätepisteessä

Oire: Verkkosovellus on käynnissä, mutta /api/messages-päätepiste palauttaa virheen 404.

Ratkaisu:

1. Varmista reitityksen määritys agenttikoodissa.
2. Tarkista, että päätepisteen käsittelijä on rekisteröity asianmukaisesti.
3. Varmista, että käyttöönotossa on määritetty oikea aloituskohta.

Testaa päätepiste lähettämällä GET-pyyntö URL-osoitteeseen. Käytä az webapp config show-komentoa tarkistaaksesi verkkosovelluksen määrityksen.

curl https://<your-app-name>.azurewebsites.net/api/messages
az webapp config show --name <your-app> --resource-group <your-resource-group>

Ympäristömuuttujat puuttuvat tai ne ovat virheellisiä

Oire: Käyttöönotto onnistuu, mutta agentti ei toimi. Lokeissa näkyy puuttuvaa määritystä koskevia virheitä.

Ratkaisu: Tarkista ja päivitä ympäristömuuttujat. Käytä az webapp config appsettings list- ja az webapp config appsettings set-komentoa tarkistaaksesi ympäristömuuttujat ja määrittääksesi puuttuvat muuttujat. Julkaise uudelleen.

# List all app settings
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Set a specific variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings API_KEY=your-value

Koonti onnistuu paikallisesti, mutta epäonnistuu Azure-ympäristössä

Oire: Koodi rakentuu paikallisesti koneella, mutta epäonnistuu Azuren käyttöönoton yhteydessä.

Ratkaisut:

• Tarkista ympäristökohtaiset riippuvuudet

  • Joissain paketeissa on ympäristökohtaisia versioita.
  • Varmista, että riippuvuudet tukevat Linuxia (Azure Web Apps toimii oletusarvoisesti Linuxissa).

• Tarkista, että suorituspalvelun versiot vastaavat toisiaan

  Suorita nämä komennot:

  # Check your local version
  dotnet --version  # .NET
  node --version    # Node.js
  python --version  # Python
  

  Vertaa Azuren suorituspalvelua portaalissa kohdassa Asetukset>Määritys>Yleiset asetukset>Pinoasetukset.

Lisätietoja on kohdassa Viestinnän päätepisteen vianmääritys.