Troubleshooting

Esta página aborda problemas e soluções comuns ao trabalhar com o Agent Framework.

Note

Esta página está sendo reestruturada. Cenários comuns de solução de problemas serão adicionados.

Problemas comuns

Erros de autenticação

Verifique se você tem as credenciais corretas configuradas para seu provedor de IA. Para o Azure OpenAI, verifique:

• A CLI do Azure está instalada e autenticada (az login)
• O usuário tem a função Cognitive Services OpenAI User ou Cognitive Services OpenAI Contributor

Problemas de instalação do pacote

Verifique se você está usando o SDK do .NET 8.0 ou posterior. Execute dotnet --version para verificar sua versão instalada.

O Agent Framework dá suporte ao Python 3.10 a 3.15. Python 3.10 continua com suporte nesta release, mas é desencorajada porque o upstream Python 3.10 atingiu o fim da vida útil. Use Python 3.11 ou posterior para novos ambientes e execute python --version para verificar o interpretador ativo.

No Python 3.14 e 3.15, expressões declarativas do Power Fx não são avaliadas. No Python 3.15, pip install agent-framework é bem-sucedido com um conjunto de recursos reduzido: Redis e Hyperlight não estão instalados e o AG-UI extra A2UI não está disponível. Se uma integração falhar ao resolver, verifique seu intervalo de Requires-Python e use um interpretador compatível. Para obter detalhes, consulte o guia de alterações significativas do Python 2026.

Verifique se você está usando o Go 1.25 ou versão posterior. Execute go version para verificar sua versão instalada. Se as dependências não forem resolvidas, execute go mod tidy e verifique se o módulo importa pacotes github.com/microsoft/agent-framework-go que existem no SDK atual.

Obtendo ajuda

Se você não encontrar uma solução aqui, visite nossas Discussões do GitHub para obter suporte à comunidade.

Próximas Etapas 

perguntas frequentes