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.
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 |
Autenticazione CLI Agent 365 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 |
| Deploy |
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 | Creare istanze dell'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
- Passare a https://entra.microsoft.com>Registrazioni app>Tutte le applicazioni.
- Cerca il tuo
agentBlueprintId.
Risoluzione dei problemi nell'autenticazione CLI
La configurazione di Agent 365 utilizza l'applicazione enterprise Agent 365 CLI gestita da Microsoft quando è disponibile e torna a un'app personalizzata di proprietà del tenant. Per i passaggi completi di comportamento e verifica, consulta l'autenticazione Microsoft Entra.
| Sintomo | Resolution |
|---|---|
| L'applicazione gestita da Microsoft non è stata trovata | Aggiorna la CLI e esegui a365 setup requirements. Cerca Applicazioni aziendali per l'ID applicazione f54280f4-395e-4ea8-9e48-bf2d4952aa14. Se la distribuzione graduale non ha ancora raggiunto il tuo tenant, usa la soluzione di fallback dell'app personalizzata. |
AADSTS530035 Durante l'autenticazione del codice del dispositivo |
Impostazioni predefinite per la sicurezza oppure Accesso condizionale bloccano il codice dispositivo. Non disattivare la politica di sicurezza dell'organizzazione. Esegui la CLI in modo nativo in Windows per usare WAM oppure collabora con il tuo amministratore delle identità per usare un'app personalizzata approvata di proprietà del tenant. |
AADSTS70007 Durante l'autenticazione |
Aggiornamento all'ultima CLI. Le versioni più vecchie potevano utilizzare una modalità di risposta del browser non supportata con l'applicazione gestita da Microsoft. |
| Mancano le autorizzazioni delegate richieste | Eseguire a365 setup requirements di nuovo. Non modificare l'applicazione gestita da Microsoft né creare una concessione di autorizzazione locale al tenant per essa. Se usi un'app di proprietà del tenant, consulta La convalida della CLI non riesce durante la configurazione. |
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
✅ interfaccia della riga di comando di Azure installato ed autenticato
✅ Permessi richiesti Entra assegnati
✅App aziendale di Agent 365 CLI gestita da Microsoft disponibile oppure app client personalizzata 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 l'ID progetto 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.
Ottenere assistenza aggiuntiva
Per rivedere codice di esempio, segnalare problemi o cercare problemi esistenti, usa questi repository: