Condividi tramite

Guida alla risoluzione dei problemi dell'Agent 365

Importante

Devi far parte del programma Frontier preview per ottenere l'accesso anticipato a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette ai termini di anteprima esistenti dei tuoi accordi con il cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la loro disponibilità e capacità potrebbero cambiare nel tempo.

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.

Procedura di 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
Build ed esegue l'agente Agente 365 CLI
Registrazione personalizzata dell'app client per la CLI dell'Agente 365
Server di mock tooling
Osservabilità dell'agente
Agenti di prova
Test agenti utilizzando i Dev Tunnel
Configurazione Setup Agent 365 Configura la configurazione di Agent 365
Aggiungere e gestire strumenti
Blueprint dell'agente di configurazione Blueprint dell'Agente di Configurazione
Deploy Deploy agent to Azure
Distribuire l'agente su Amazon Web Services (AWS)
Distribuisci l'agente su Google Cloud Platform (GCP)
Pubblica l'agente nel centro amministrativo Microsoft 365 Pubblica l'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
a365 config display

# Display generated configuration (after setup)
a365 config display -g

Verify Azure resources

Usa questi comandi per ispezionare le risorse 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

Verifica blueprint dell'agente

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

# Check if blueprint ID is set
a365 config display -g | Select-String "agentBlueprintId"

Verifica blueprint in Microsoft Entra

  1. Vai su https://entra.microsoft.com>Registrazioni App Tutte>le domande.
  2. Cerca il tuo agentBlueprintId.

Migliori pratiche preventive

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

Prima di iniziare

Lista di controllo dei prerequisiti:

✅ .NET 8.0 SDK installato
✅ Azure CLI installata e autenticata
✅ 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 --prerelease

Testare in modo incrementale:

  • Prova dopo ogni passaggio importante.
  • Verifica il successo prima di andare avanti.
  • Continua a funzionare con le configurazioni.

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