Agent 365:n vianmäärityksen opas

Käytä tätä opasta Agent 365:n kehityksen elinkaaren kaikkien vaiheiden ongelmien diagnosoimisessa ja ratkaisemisessa. Käytä tätä artikkelia vianmäärityksen lähtökohtana ja siirry sitten tiettyihin osiin yksityiskohtaisia ratkaisuja varten.

Vianmääritysvaiheet

Jokainen tämän taulukon linkeistä tarjoaa vianetsintävaiheet tietyille alueille. Sisältö on ryhmitelty Agent 365 SDK:n kehityksen elinkaaren vaiheiden mukaan.

Vaihe Vianmäärityssisältö
Agentin luominen ja suorittaminen Agent 365 CLI
Mukautetun asiakassovelluksen rekisteröinti Agent 365 CLI:tä varten
Mock tooling -palvelin
Agentin havainnoitavuus
Agenttien testaus
Agenttien testaaminen Dev Tunnelsin avulla
Työkalujen lisääminen ja hallinta
Agentin suunnitelman määrittäminen Agentin suunnitelman määrittäminen
Käyttöönotto Agentin ottaminen käyttöön Azuressa
Agentin ottaminen käyttöön Amazon Web Servicesissa (AWS)
Agentin ottaminen käyttöön Google Cloud Platformissa (GCP)
Agentin julkaiseminen Microsoft 365 -hallintakeskuksessa Agentin julkaiseminen Microsoft -hallintakeskuksessa
Agentti-instanssien luominen Agentti-instanssien luominen

Diagnostiikkakomentojen viite

Ennen kuin ryhdyt ratkaisemaan yksittäisiä ongelmia, käytä näitä komentoja tarkistaaksesi Agent 365 -asennuksen nykytilan:

CLI:n ja määrityksen tarkistaminen

Käytä näitä komentoja CLI:n ja määrityksen tarkistamiseen.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Azure-resurssien tarkistaminen

Käytä näitä komentoja Azure-resurssien ja sovelluksen tilan tarkastamiseen.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Agentin suunnitelman tarkistaminen

Varmista, että agentin suunnitelma on olemassa ja määritetty oikein.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Agentin suunnitelman tarkistaminen Microsoft Entrassa

  1. Siirry kohtaan https://entra.microsoft.com>Sovellusrekisteröinnit>Kaikki sovellukset.
  2. Hae oma agentBlueprintId-tunnuksesi.

Ennakoivat käytännöt

Käytä näitä suosituksia välttääksesi yleisiä ongelmia ja helpottaaksesi vianmääritystä.

Ennen aloittamista

Edellytysten tarkistuslista:

✅ .NET 8.0 SDK asennettu
✅ Azure CLI asennettu ja todennettu
✅ Vaaditut Entra-oikeudet myönnetty
✅ Mukautettu asiakassovellus luotu ja määritetty
✅ Vuokraaja otettu käyttöön Microsoft Agent 365 Frontierissa

Validointikomennot:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Kehityksen aikana

Tallenna määritykset:

  • Tee määritystiedostoista varmuuskopiot.
  • Dokumentoi asetusvalinnat.
  • Tallenna luodut tunnukset, kuten suunnitelman tunnus ja hallittujen käyttäjätietojen tunnus.

Pidä CLI ajan tasalla:

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

Testaa vaiheittain:

  • Testaa jokaisen tärkeän askeleen jälkeen.
  • Varmista onnistuminen ennen kuin jatkat eteenpäin.
  • Säilytä toimivat määritykset.

Ennen käyttöönottoa

Käyttöönottoa edeltävä tarkistuslista:

✅ Agentti toimii paikallisesti agenttien testausalustalla.
✅ Kaikki ympäristömuuttujat on dokumentoitu.
✅ Määritystiedostot viety lähdekoodin hallintaan.
✅ MCP-palvelimet on määritetty ja testattu.
✅ Havaittavuus on käytössä ja varmennettu.

Pyydä lisää apua

Käytä näitä säilöjä näytekoodin tarkasteluun, ongelmien ilmoittamiseen ja olemassa olevien ongelmien etsimiseen:

  • Last updated on