Guia de resolução de problemas do Agent 365

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

Passos de resolução de problemas

Cada uma das ligações nesta tabela fornece passos de resolução de problemas para áreas específicas. O conteúdo está agrupado pela fase do ciclo de vida do SDK do Agent 365.

Fase Conteúdo de resolução de problemas
Criar e executar agente CLI do Agent 365
Registo personalizado de aplicação cliente para CLI do Agent 365
Servidor de ferramentas fictícias
Observabilidade de agentes
Testar agentes
Testar agentes através de Túneis de Desenvolvimento
Adicionar e gerir ferramentas
Configurar Blueprint do agente Configurar blueprint do agente
Implementar Implementar o agente no Azure
Implementar o agente para o Amazon Web Services (AWS)
Implementar agente no Google Cloud Platform (GCP)
Publicar agente no centro de administração do Microsoft 365 Publicar o 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 abordar problemas específicos, utilize estes comandos para verificar o estado atual da configuração do Agent 365:

Verificar a CLI e a configuração

Use estes comandos para validar a 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

Verificar recursos do Azure

Use estes comandos para inspecionar os recursos do Azure e o estado da aplicação.

# 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 blueprint do agente

Certifique-se de que o blueprint do 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. Aceda a https://entra.microsoft.com>Registos de aplicações>Todas as aplicações.
  2. Procure o seu agentBlueprintId.

Melhores práticas preventivas

Use estas recomendações para evitar problemas comuns e simplificar a resolução de problemas.

Antes de começar

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

✅ .NET 8.0 SDK instalado
✅ CLI do Azure instalado e autenticado
✅ Permissões obrigatórias do Entra atribuídas
✅ Aplicação cliente personalizada criada e configurada
✅ Inquilino ativado para 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

Guarde as configurações:

  • Mantenha cópias de segurança dos ficheiros de configuração.
  • Documente as suas escolhas de configuração.
  • Guarde os IDs gerados, como o ID do Blueprint e o ID de identidade gerida.

Mantenha a CLI atualizada:

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

Testar de forma incremental:

  • Teste após cada passo principal.
  • Verifique o sucesso antes de avançar.
  • Continue a trabalhar nas configurações.

Antes da implementação

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

✅ O agente funciona localmente com o Ambiente de Demonstração.
✅ Todas as variáveis de ambiente documentadas.
✅ Ficheiros de configuração comprometidos no controlo de código fonte.
✅ Servidores MCP configurados e testados.
✅ Observabilidade ativada e verificada.

Obter ajuda adicional

Para rever código de exemplo, reportar problemas ou pesquisar problemas existentes, utilize estes repositórios:

  • Last updated on