Guia de solução de problemas do Agente 365

Use este guia para diagnosticar e resolver problemas ao longo de todo o ciclo de desenvolvimento do Agent 365. Use este artigo como ponto de partida para a resolução de problemas e depois vá para seções específicas para soluções detalhadas.

Etapas para solucionar problemas

Cada um dos links nesta tabela fornece passos de solução de problemas para áreas específicas. O conteúdo é agrupado por estágio do ciclo de vida do SDK do Agente 365.

Referência de comandos de diagnóstico

Antes de entrar em problemas específicos, use estes comandos para verificar o estado atual da sua configuração do Agente 365:

Verifique CLI e configuração

Use esses comandos para validar sua CLI e configuração.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
a365 config display

# Display generated configuration (after setup)
a365 config display -g

Verifique os recursos Azure

Use esses comandos para inspecionar Azure recursos e o status do aplicativo.

# 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

Verificar o esquema do agente

Confirme que o blueprint do seu agente existe e está corretamente configurado.

# Check if blueprint ID is set
a365 config display -g | Select-String "agentBlueprintId"

Verificar o blueprint no Microsoft Entra

1. Vá para https://entra.microsoft.com>App registrations>Todos aplicativos.
2. Procure por seu agentBlueprintId.

Melhores práticas preventivas

Use essas recomendações para evitar problemas comuns e agilizar a solução de problemas.

Antes de começar

Lista de verificação de pré-requisitos:

✅ .NET SDK 8.0 instalado
✅ Azure CLI instalado e autenticado
✅ Permissões necessárias atribuídas ao Entra
✅ Aplicativo cliente personalizado criado e configurado
✅ Locatário habilitado para o Microsoft Agent 365 Frontier

Comandos de validação:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Durante o desenvolvimento

Salve suas configurações:

• Mantenha backups dos arquivos de configuração.
• Documente suas escolhas de configuração.
• Armazene os IDs gerados, como o ID de blueprint e o ID de identidade gerenciada.

Mantenha a CLI atualizada:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Teste incrementalmente:

• Teste após cada etapa principal.
• Verifique o sucesso antes de seguir em frente.
• Mantenha as configurações funcionando.

Antes da implantação

Lista de verificação pré-implantação:

✅ O agente trabalha localmente com o Agents Playground.
✅ Todas as variáveis do ambiente documentadas.
✅ Arquivos de configuração confirmados no controle de versão.
✅ Servidores MCP configurados e testados.
✅ Observabilidade habilitada e verificada.

Procure ajuda adicional

Para revisar código de exemplo, relatar problemas ou pesquisar problemas existentes, use estes repositórios:

• Amostras do Agente 365
• Agente 365 DevTools (CLI)
• Agent 365 SDK – .NET
• Agent 365 SDK – Python
• SDK do Agente 365 - Node.js