使用本指南诊断并解决 Agent 365 整个开发生命周期中的问题。 请将本文作为故障排除的起点，然后转到具体章节查看详细解决方案。
故障排除步骤
本表中的每个链接都提供了针对特定领域的故障排除步骤。 内容按 Agent 365 SDK 开发生命周期 的各个阶段进行分组。
| 阶段 | 故障排除内容 |
|---|---|
| 构建和运行智能体 |
Agent 365 CLI 为 Agent 365 CLI 注册自定义客户端应用程序 模拟工具服务器 智能体可观测性 测试智能体 使用 Dev Tunnels 测试智能体 添加和管理工具 |
| 设置智能体蓝图 | 设置智能体蓝图 |
| 部署 |
将智能体部署到 Azure 将智能体部署到亚马逊网络服务 (AWS) 将智能体部署到 Google 云平台 (GCP) |
| 将智能体发布到 Microsoft 365 管理中心 | 将智能体发布到 Microsoft 管理中心 |
| 创建智能体实例 | 创建智能体实例 |
诊断命令参考
在深入排查具体问题之前，请使用以下命令检查 Agent 365 配置的当前状态：
检查 CLI 和配置
使用以下命令验证您的 CLI 和配置。
# 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
验证 Azure 资源
使用以下命令检查 Azure 资源和应用状态。
# 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
验证智能体蓝图
确认您的智能体蓝图是否存在且配置正确。
# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"
在 Microsoft Entra 中验证蓝图
- 转到 https://entra.microsoft.com>应用注册>所有应用。
- 搜索您的
agentBlueprintId。
预防性最佳实践
遵循这些建议可预防常见问题并简化故障排除流程。
开始之前
先决条件检查清单：
✅ 已安装 .NET 8.0 SDK
✅ 已安装并完成身份验证的 Azure CLI
✅ 已分配所需的 Entra 权限
✅ 已创建并配置自定义客户端应用
✅ 已为 Microsoft Agent 365 Frontier 启用租户
验证命令：
# Check .NET
dotnet --version
# Check Azure CLI
az --version
az account show
# Check CLI installation
a365 --version
在开发期间
保存配置：
- 请备份配置文件。
- 记录您的配置选项。
- 保存生成的 ID，例如蓝图 ID 和托管身份 ID。
保持 CLI 版本更新：
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
分阶段测试：
- 在每个主要步骤完成后进行测试。
- 在继续下一步之前，请确认操作成功。
- 保持正常配置。
部署前
部署前检查清单：
✅智能体在本地与 Agents Playground 正常运行。
✅ 所有环境变量均已记录。
✅ 配置文件已提交到源代码控制。
✅ MCP 服务器已配置并测试。
✅ 已启用并验证可观测性。
获取额外帮助
要查看示例代码、报告问题或搜索现有问题，请使用以下存储库：