Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima 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 e 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 |
| Configurazione dell'Agent 365 |
Configura la configurazione di Agent 365 Aggiungere e gestire strumenti |
| Blueprint dell'agente di configurazione | Blueprint dell'Agente di Configurazione |
| Deploy |
Distribuire agente su Azure Distribuire l'agente su Amazon Web Services (AWS) Distribuisci l'agente su Google Cloud Platform (GCP) Comando CLI deploy di Agent 365 |
| Pubblicare l'agente nell'interfaccia di amministrazione di 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
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
a365 config display -g | Select-String "agentBlueprintId"
Verificare il progetto in Microsoft Entra
- Passare a https://entra.microsoft.com>App registrations>Tutte le applicazioni.
- 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 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 --prerelease
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: