Průvodce řešením problémů se službou Agent 365

Použijte tohoto průvodce k diagnostice a řešení problémů v celém životním cyklu vývoje služby Agent 365. Použijte tento článek jako výchozí bod pro řešení problémů a pak přejděte na konkrétní sekce pro podrobná řešení.

Kroky při řešení problému

Každý z odkazů v této tabulce poskytuje kroky k řešení problémů v konkrétní oblasti. Obsah je seskupen podle fáze životního cyklu vývoje pomocí sady Agent 365.

Fáze Obsah pro odstraňování potíží
Sestavení a spuštění agenta Agent 365 CLI
Registrace vlastní klientské aplikace pro Agent 365 CLI
Server pro simulované nástroje
Pozorovatelnost agenta
Testování agentů
Testování agentů pomocí Dev Tunnels
Přidání a správa nástrojů
Nastavení podrobného plánu agenta Nastavení podrobného plánu agenta
Nasazení Nasazení agenta do Azure
Nasazení agenta do Amazon Web Services (AWS)
Nasazení agenta do Google Cloud Platform (GCP)
Publikování agenta do centra pro správu Microsoft 365 Publikování agenta do centra pro správu Microsoft
Vytváření instancí agentů Vytváření instancí agentů

Přehled diagnostických příkazů

Než začnete řešit konkrétní problémy, použijte tyto příkazy ke kontrole aktuálního stavu prostředí Agent 365:

Kontrola CLI a konfigurace

Použijte tyto příkazy k ověření CLI a konfigurace.

# 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

Ověření prostředků Azure

Použijte tyto příkazy ke kontrole prostředků Azure a stavu aplikace.

# 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

Ověření podrobného plánu agenta

Ověřte, zda existuje podrobný plán agenta a je správně konfigurován.

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

Ověření podrobného plánu v Microsoft Entra

  1. Přejděte na https://entra.microsoft.com>Registrace aplikací>Všechny aplikace.
  2. Vyhledejte agentBlueprintId.

Preventivní osvědčené postupy

Použijte tato doporučení, abyste předešli běžným problémům a usnadnili jejich řešení.

Než začnete

Kontrolní seznam předpokladů:

✅ Nainstalovaná sada .NET 8.0 SDK
✅ Nainstalované a ověřené rozhraní Azure CLI
✅ Přidělená povinná oprávnění Entra
✅ Vytvořená a konfigurovaná vlastní klientská aplikace
✅ Povolený tenant pro Microsoft Agent 365 Frontier

Ověřovací příkazy:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Během vývoje

Uložte své konfigurace:

  • Uchovávejte zálohy konfiguračních souborů.
  • Dokumentujte své volby nastavení.
  • Ukládejte generovaná ID, jako je ID podrobného plánu a ID spravované identity.

Udržujte aktuální CLI:

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

Testujte postupně:

  • Testujte po každém větším kroku.
  • Před pokračováním ověřte, zda byl krok úspěšný.
  • Zachovávejte funkční konfigurace.

Před nasazením

Kontrolní seznam před nasazením:

✅ Agent pracuje místně s Agents Playground.
✅ Zdokumentované všechny proměnné prostředí.
✅ Konfigurační soubory uložené ve správě zdrojového kódu.
✅ Konfigurované a otestované servery MCP.
✅ Aktivovaná a ověřená pozorovatelnost.

Získání další pomoci

Ke kontrole vzorového kódu, nahlášení problémů nebo vyhledání existujících problémů použijte tato úložiště:

  • Last updated on