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.11 alla 3.15. Python 3.10 non è più supportato né testato a partire dalla versione 1.24, anche se i metadati del pacchetto consentono ancora l'installazione. Usare Python 3.11 o versione successiva 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 omette Redis perché RedisVL richiede una versione precedente di Python. Hyperlight 0.8, AG-UI A2UI extra e DuckDB 2.x supportano Python 3.15. Se non è possibile risolvere un'integrazione, controllarne l'intervallo Requires-Python e usare un interprete compatibile.
Per informazioni dettagliate, vedere la guida alle modifiche significative Python 2026.
Assicurarsi di usare Go 1.26 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.