Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 a solução de 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 |
Autenticação CLI do Agente 365 Agente 365 CLI Registro personalizado de aplicativo cliente para CLI do Agente 365 Servidor de ferramentas de simulação 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 |
| Deploy |
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 blueprint no Microsoft Entra
- Vá para https://entra.microsoft.com>Registros de aplicativo>Todos aplicativos.
- Procurar por
agentBlueprintId.
Solucionar problemas de autenticação na CLI
A configuração do Agent 365 usa o aplicativo empresarial Agent 365 CLI gerenciado pela Microsoft quando ele está disponível e, caso contrário, recorre a um aplicativo personalizado de propriedade do locatário. Para ver o comportamento completo e as etapas de verificação, veja autenticação Microsoft Entra.
| Sintoma | Resolução |
|---|---|
| Aplicação gerenciada pela Microsoft não é encontrada | Atualize a CLI e execute a365 setup requirements. Pesquise aplicações empresariais por ID f54280f4-395e-4ea8-9e48-bf2d4952aa14de aplicação. Se a distribuição em etapas ainda não tiver chegado ao locatário, use o fallback do aplicativo personalizado. |
AADSTS530035 Durante a autenticação por código de dispositivo |
Padrões de Segurança ou Acesso Condicional bloqueiam o código do dispositivo. Não desative a política de segurança organizacional. Execute a CLI no Windows nativo para usar WAM, ou trabalhe com seu administrador de identidade para usar um aplicativo customizado aprovado e proprietário do inquilino. |
AADSTS70007 Durante a autenticação |
Atualize para a versão mais recente da CLI. Versões mais antigas podiam usar um modo de resposta do navegador não suportado com o aplicativo gerenciado pela Microsoft. |
| Os escopos delegados exigidos estão ausentes | Execute a365 setup requirements novamente. Não modifique o aplicativo gerenciado pela Microsoft nem crie uma concessão de permissão local para o inquilino. Se você usar um aplicativo de propriedade do locatário, siga Falha na validação de CLI durante a configuração. |
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 corporativo Agent 365 CLI gerenciado pela Microsoft disponível ou aplicativo cliente personalizado 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 enviados para o 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: