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.

Stage Conteúdo de solução de problemas
Construir e executar agente Agente 365 CLI
Registro personalizado de aplicativo cliente para CLI do Agente 365
Servidor de ferramentas simuladas
Observabilidade do agente
Agentes de teste
Agentes de teste usando Dev Tunnels
Adicionar e gerenciar ferramentas
Modelo de configuração do agente Blueprint do Agente de Configuração
Implantar Implantar agente no Azure
Implantar agente na Amazon Web Services (AWS)
Implantar agente na Google Cloud Platform (GCP)
Publicar agente no centro de administração do Microsoft 365 Publicar agente no Centro de Administração da Microsoft
Criar instâncias de agente Criar instâncias de agente

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
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

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
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Verificar o blueprint no Microsoft Entra

  1. Vá para https://entra.microsoft.com>Registros de aplicativo>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
✅ CLI do Azure 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

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:

  • Last updated on