Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Esta página aborda questões e soluções comuns ao trabalhar com o Agent Framework.
Observação
Esta página está a ser reestruturada. Serão adicionados cenários comuns de resolução de problemas.
Problemas comuns
Erros de autenticação
Certifique-se de que tem as credenciais corretas configuradas para o seu fornecedor de IA. Para Azure OpenAI, verifique:
- CLI do Azure é instalado e autenticado (
az login) - O utilizador tem a função de
Cognitive Services OpenAI UserouCognitive Services OpenAI Contributor
Problemas de Instalação de Pacotes
Certifica-te de que estás a usar o .NET 8.0 SDK ou posterior. Corre dotnet --version para verificar a versão instalada.
O Agent Framework suporta Python 3.11 a 3.15. Python 3.10 já não é suportado nem testado em Python 1.24, embora os metadados dos pacotes ainda permitam a instalação. Utilize Python 3.11 ou posterior e execute python --version para verificar o interpretador ativo.
No Python 3.14 e 3.15, as expressões Declarative Power Fx não são avaliadas. No Python 3.15, pip install agent-framework omite o Redis porque o RedisVL requer uma versão anterior do Python. Hyperlight 0.8, o extra AG-UI A2UI e o suporte do DuckDB 2.x suportam Python 3.15. Se uma integração falhar ao resolver, verifique o seu Requires-Python intervalo e use um interpretador compatível.
Para detalhes, consulte o guia de alterações significativas do Python 2026.
Certifica-te de que estás a usar o Go 1.26 ou posterior. Corre go version para verificar a versão instalada. Se as dependências não se resolverem, execute go mod tidy e verifique se github.com/microsoft/agent-framework-go o seu módulo importa pacotes que existem no SDK atual.
Obter Ajuda
Se não conseguir encontrar uma solução aqui, visite as nossas Discussões no GitHub para apoio da comunidade.