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.
Questa pagina illustra i problemi e le soluzioni comuni quando si usa Agent Framework.
Annotazioni
Questa pagina è in fase di ristrutturazione. Verranno aggiunti scenari comuni per la risoluzione dei problemi.
Problemi comuni
Errori di autenticazione
Assicurarsi di avere le credenziali corrette configurate per il provider di intelligenza artificiale. Per Azure OpenAI, verificare:
- L'interfaccia della riga di comando di Azure è installata e autenticata (
az login) - L'utente ha il ruolo
Cognitive Services OpenAI Usero il ruoloCognitive Services OpenAI Contributor
Problemi di installazione dei pacchetti
Assicurarsi di usare .NET 8.0 SDK o versione successiva. Eseguire dotnet --version per controllare la versione installata.
Agent Framework supporta Python dalla versione 3.10 alla 3.15. Python 3.10 rimane supportato per questa versione, ma è deprecato in modo non definitivo perché upstream Python 3.10 ha raggiunto la fine del ciclo di vita. Usare Python 3.11 o versione successiva per i nuovi ambienti ed eseguire python --version per verificare l'interprete attivo.
In Python 3.14 e 3.15 le espressioni Dichiarative Power Fx non vengono valutate. In Python 3.15, pip install agent-framework ha esito positivo con un set di funzionalità ridotto: Redis e Hyperlight non sono installati e la AG-UI A2UI extra non è disponibile. Se non è possibile risolvere un'integrazione, controllarne l'intervallo di compatibilità Requires-Python e usare un interprete compatibile. Per informazioni dettagliate, vedere la guida alle modifiche significative Python 2026.
Assicurarsi di usare Go 1.25 o versione successiva. Eseguire go version per controllare la versione installata. Se le dipendenze non vengono risolte, eseguire go mod tidy e verificare che il modulo importi github.com/microsoft/agent-framework-go pacchetti presenti nell'SDK corrente.
Come ottenere assistenza
Se non è possibile trovare una soluzione qui, visitare le discussioni su GitHub per il supporto della community.