Guida alla risoluzione dei problemi di Agent 365

Usa questa guida per diagnosticare e risolvere problemi nell'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 di risoluzione dei problemi

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

Riferimento ai comandi diagnostici

Prima di affrontare problemi specifici, utilizza questi comandi per verificare lo stato attuale della tua configurazione di Agent 365:

Controllare l'interfaccia della riga di comando e la configurazione

Utilizza questi comandi per verificare l'interfaccia della riga di comando 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 di Azure

Usa questi comandi per ispezionare le risorse di Azure e lo 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

Verificare il progetto dell'agente

Conferma che il progetto del tuo agente esista e sia configurato correttamente.

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

Verifica il progetto in Microsoft Entra

1. Vai su https://entra.microsoft.com>Registrazioni app>Tutte le applicazioni.
2. Cerca il agentBlueprintId.

Procedure consigliate preventive

Usa questi elementi consigliati per prevenire problemi comuni e semplificare la risoluzione dei problemi.

Prima di iniziare

Elenco di controllo dei prerequisiti:

✅ SDK .NET 8.0 installato
✅ Interfaccia della riga di comando di Azure installata e autenticata
✅ Permessi richiesti Entra assegnati
✅ Applicazione client personalizzata creata e configurata
✅ Tenant abilitato per Microsoft Agent 365 Frontier

Comandi di convalida:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Durante lo sviluppo

Salva le tue configurazione:

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

Mantieni aggiornata l'interfaccia della riga di comando:

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

Test incrementale:

• Esegui un test dopo ogni passaggio principale.
• Verifica che tutto sia andato a buon fine prima di procedere.
• Mantieni le configurazioni funzionanti.

Prima della distribuzione

Elenco di controllo pre-distribuzione:

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

Ottenere altre informazioni

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

• Esempi di Agent 365
• Agent 365 DevTools (interfaccia della riga di comando)
• SDK Agent 365 - .NET
• SDK Agent 365 - Python
• SDK Agent 365 - Node.js