请使用本指南诊断和解决整个Agent 365开发生命周期中的问题。 请以本文为起点进行故障排除，然后查看具体部分的详细解决方案。
故障排除步骤
本表中的每个链接都提供了针对特定区域的故障排除步骤。 内容按 Agent 365 SDK 开发生命周期的阶段分组。
| 阶段 | 故障排除内容 |
|---|---|
| 构建并运行代理 |
Agent 365 CLI 身份验证 Agent 365 CLI Agent 365 CLI 的自定义客户端应用注册 模拟工具服务器 代理可观察性 检测剂 使用开发隧道测试代理 添加和管理工具 |
| 设置代理蓝图 | 设置代理蓝图 |
| Deploy |
将代理部署到 Azure 部署代理到亚马逊网络服务（AWS） 部署代理到 Google Cloud Platform （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>应用注册>All applications。
- 搜索你的
agentBlueprintId.
排查命令行界面（CLI）身份验证问题
Agent 365 的设置在 Microsoft 管理的 Agent 365 企业级 CLI 应用可用时使用，并退回到租户拥有的自定义应用。 有关完整行为和验证步骤，请参见 Microsoft Entra 认证。
| 症状 | 解决方案 |
|---|---|
| 找不到Microsoft管理的应用程序 | 更新CLI并运行 a365 setup requirements。 在企业 应用 中搜索应用ID f54280f4-395e-4ea8-9e48-bf2d4952aa14。 如果分阶段推出尚未覆盖到你的租户，请使用 自定义应用备用方案。 |
AADSTS530035 在设备代码身份验证期间 |
安全默认或条件访问会阻断设备代码。 不要禁用组织安全策略。 在原生 Windows 上运行 CLI 以使用 WAM，或者与你的身份管理员合作，使用经批准的租户拥有的自定义应用。 |
AADSTS70007 认证过程中 |
更新至最新CLI。 旧版本可能会在Microsoft管理的应用中使用不支持的浏览器响应模式。 |
| 缺少必要的委派范围 | 再次运行 a365 setup requirements。 不要修改Microsoft管理的应用程序，也不要为它创建租户本地权限。 如果您使用的是租户自有应用，请参阅配置过程中 CLI 验证失败。 |
预防最佳实践
利用这些建议预防常见问题并简化故障排除流程。
在您开始之前
先决条件清单：
已安装 ✅ .NET 8.0 SDK
✅ Azure CLI 安装和身份验证
✅ 已分配所需的 Entra 权限
✅ 由 Microsoft 管理的 Agent 365 CLI 企业应用程序可用，或已配置自定义客户端应用程序
✅ 为 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
逐步测试：
- 每一个主要步骤后都要测试。
- 在继续前，先确认成功。
- 保持正常配置。
部署前
部署前检查清单：
✅ Agent 在本地与 Agents Playground 合作。
✅ 所有环境变量都有文档记录。
✅ 配置文件已提交到源代码控制。
✅ MCP服务器已配置并测试。
✅ 启用并验证可观测性。
获取额外帮助
如需审查示例代码、报告问题或搜索现有问题，请使用以下代码库：