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.
Importante
Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.
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.
| Etapa | Conteúdo de solução de problemas |
|---|---|
| Build e run agent |
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 |
| Configuração do Setup Agent 365 |
Configurar a configuração do Agent 365 Adicionar e gerenciar ferramentas |
| Projeto do agente de configuração | Blueprint do Agente de Configuração |
| Deploy |
Deploy agent to 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 Microsoft admin center |
| 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
a365 config display
# Display generated configuration (after setup)
a365 config display -g
Verify Azure resources
Use esses comandos para inspecionar os recursos do Azure e o status do app.
# 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 blueprint 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"
Verifique blueprint no Microsoft Entra
- Vá para https://entra.microsoft.com>Inscrições de aplicativos Todas>as inscrições.
- Procure pelo seu
agentBlueprintIdarquivo .
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 8.0 SDK instalado
✅ Azure CLI instalado e autenticado
✅ Permissões necessárias para o Entra atribuídas
✅ 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.
- Salve IDs gerados, como ID de blueprint e 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.
- Continue funcionando com as configurações.
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 comprometidos 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: