Guida alla risoluzione dei problemi dell'Agent 365

Usa questa guida per diagnosticare e risolvere problemi durante l'intero ciclo di sviluppo di Agent 365. Usa questo articolo come punto di partenza per la risoluzione dei problemi, poi vai alle sezioni specifiche per soluzioni dettagliate.

Passaggi per la risoluzione dei problemi

Ciascuno dei link in questa tabella fornisce i passaggi di risoluzione dei problemi per aree specifiche. Il contenuto è raggruppato per fase del ciclo di sviluppo dell'SDK dell'Agent 365.

Fase Contenuti di risoluzione dei problemi
Compila ed esegui l'agente Agente 365 CLI
Registrazione personalizzata dell'app client per la CLI dell'Agente 365
Server di simulazione degli strumenti
Osservabilità dell'agente
Agenti di prova
Test agenti utilizzando i Dev Tunnel
Aggiungere e gestire strumenti
Blueprint dell'agente di configurazione Blueprint dell'Agente di Configurazione
Distribuisci Distribuire agente su Azure
Distribuire l'agente su Amazon Web Services (AWS)
Distribuisci l'agente su Google Cloud Platform (GCP)
Pubblicare l'agente nell'interfaccia di amministrazione di Microsoft 365 Pubblica agente nel centro amministrativo Microsoft
Crea istanze di agente Crea istanze di agente

Riferimento ai comandi diagnostici

Prima di entrare in problemi specifici, usa questi comandi per controllare lo stato attuale della tua configurazione Agent 365:

Controlla CLI e configurazione

Usa questi comandi per validare la tua CLI e la configurazione.

# 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

Verificare le risorse Azure

Usare questi comandi per controllare Azure risorse e stato dell'app.

# 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

Verifica piano dell'agente

Conferma che il blueprint del tuo agente esiste e sia configurato correttamente.

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

Verificare il progetto in Microsoft Entra

  1. Passare a https://entra.microsoft.com>Registrazioni app>Tutte le applicazioni.
  2. Cerca il tuo agentBlueprintId.

Migliori pratiche preventive

Usa queste raccomandazioni per prevenire problemi comuni e semplificare la risoluzione dei problemi.

Operazioni preliminari

Lista di controllo dei prerequisiti:

✅ .NET 8.0 SDK è installato
✅ interfaccia della riga di comando di Azure installato ed autenticato
✅ Permessi Entra richiesti assegnati
✅ App client personalizzata creata e configurata
✅ Tenant abilitato per Microsoft Agent 365 Frontier

Comandi di validazione:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Durante lo sviluppo

Salva le tue configurazioni:

  • Conserva backup dei file di configurazione.
  • Documenta le tue scelte di configurazione.
  • Salva gli ID generati, come il blueprint ID e l'ID dell'identità gestita.

Tieni aggiornata la CLI:

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

Testare in modo incrementale:

  • Esegui un test dopo ogni passaggio importante.
  • Verifica il successo prima di andare avanti.
  • Mantieni le configurazioni funzionanti.

Prima della distribuzione

Lista di controllo pre-dispiegamento:

✅ L'agente lavora localmente con Agents Playground.
✅ Tutte le variabili ambientali documentate.
✅ File di configurazione inviati al controllo del fonte.
✅ Server MCP configurati e testati.
✅ Osservabilità abilitata e verificata.

Cerca aiuto aggiuntivo

Per rivedere codice di esempio, segnalare problemi o cercare problemi esistenti, usa questi repository:

  • Last updated on