重要
需要成为 Frontier 预览计划的一部分，才能获得 抢先体验Microsoft Agent 365。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier 预览版受现有客户协议的预览版条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随着时间发生变化。
请使用本指南诊断和解决整个Agent 365开发生命周期中的问题。 请以本文为起点进行故障排除，然后查看具体部分的详细解决方案。
故障排除步骤
本表中的每个链接都提供了针对特定区域的故障排除步骤。 内容按 Agent 365 SDK 开发生命周期的阶段分组。
| 阶段 | 故障排除内容 |
|---|---|
| 构建并运行代理 |
Agent 365 CLI Agent 365 CLI 的自定义客户端应用注册 模拟工具服务器 代理可观察性 检测剂 使用开发隧道测试代理 |
| 设置代理365配置 |
设置Agent 365配置 添加和管理工具 |
| 设置代理蓝图 | 设置代理蓝图 |
| Deploy |
将代理部署到 Azure 部署代理到亚马逊网络服务（AWS） 部署代理到 Google Cloud Platform （GCP） Agent 365 CLI deploy 命令 |
| 将代理发布到Microsoft 365管理中心 | 发布代理到 Microsoft 管理中心 |
| 创建代理实例 | 创建代理实例 |
诊断命令指南
在深入具体问题之前，请使用以下命令检查你的Agent 365当前配置状态：
检查CLI和配置
使用这些命令来验证你的CLI和配置。
# Verify CLI is installed and check version
a365 --version
# Display current configuration
a365 config display
# Display generated configuration (after setup)
a365 config display -g
验证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
a365 config display -g | Select-String "agentBlueprintId"
在 Microsoft Entra 中验证蓝图
- 转到 https://entra.microsoft.com>App registrations>All applications。
- 搜索你的
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 --prerelease
逐步测试：
- 每一个主要步骤后都要测试。
- 在继续前，先确认成功。
- 保持正常配置。
部署前
部署前检查清单：
✅ Agent 在本地与 Agents Playground 合作。
✅ 所有环境变量都有文档记录。
✅ 配置文件已提交到源代码控制。
✅ MCP服务器已配置并测试。
✅ 启用并验证可观测性。
获取额外帮助
如需审查示例代码、报告问题或搜索现有问题，请使用以下代码库：