重要
需要成为 Frontier 预览计划的一部分，才能获得 抢先体验Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 Frontier 预览版受客户协议中现有预览条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随时间而变化。
代理 365 CLI 是一种跨平台命令行工具，用于在 Azure 上部署和管理 Agent 365 应用程序。
先决条件
在开始之前，请确保满足以下先决条件：
- 自定义客户端应用程序注册 - CLI 要求在您的 Microsoft Entra ID 租户中使用自定义客户端应用程序进行身份验证。 详见 自定义客户端应用注册 ，了解详细的设置说明。 配置时需要应用程序（客户端）ID。
- Azure 订阅 - 访问可在其中创建资源的Azure订阅。
- 必要权限 ——您的账户必须具备以下角色之一：
备注
在安装 a365 config init 后这一步，CLI会自动验证你的自定义客户端应用注册，检查该应用是否存在、拥有所需权限并获得管理员同意。
小窍门
不同的CLI命令需要不同的角色或权限。 每个命令参考页面都指定了所需的最小角色。 例如，请参见 setup 指挥参考文献 以了解其具体要求。
安装代理 365 CLI
使用以下步骤在操作系统上全局安装 Agent 365 CLI。
先决条件
您必须安装 .NET。 （建议.NET 8.0。
使用 DotNet 工具安装
使用以下命令和--prerelease参数来安装 Agent 365 CLI。
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
重要
Agent 365 的 CLI 仍处于预览阶段。 在 Agent 365 CLI 正式发布之前，务必使用 --prerelease 参数获取包含最新修复和功能的最新版本。 当Agent 365 CLI正式开放时， --prerelease 该参数将不再必要。
有关最新说明和可用版本，请访问官方 NuGet 页面： Microsoft.Agents.A365.DevTools.Cli on NuGet.org
验证安装
安装 Agent 365 CLI 后，通过执行 --help 以下命令确认安装正确：
a365 -h
此命令显示帮助信息，并确认 CLI 已准备就绪。
更新
使用 dotnet tool update 命令并指定 --prerelease 参数来更新 Agent 365 CLI：
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease
备注
要更新 Agent 365 CLI，你需要有互联网连接才能访问最新的 NuGet 包： Microsoft.Agents.A365.DevTools.Cli。
卸载
使用 dotnet tool uninstall 命令卸载 Agent 365 CLI：
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
文件位置
工具二进制文件的默认位置取决于操作系统：
| 操作系统 | 路径 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
SDK在你第一次运行时会把这个位置添加到你的路径中。 所以你可以从任意目录调用全局工具，而无需指定工具位置。
工具访问特定于用户，而不针对计算机全局。 全局工具仅对安装该工具的用户开放。
可用命令
如需查看完整的可用命令列表，请使用该 --help 命令或参见 Agent 365 CLI 参考。
重要更新
已移除的命令： CLI删除了该 create-instance 命令。 它绕过了必要的注册步骤，从而限制了代理的功能。 当该命令达到推荐工作流程水平后，可能会在后续版本中重新引入。
有关如何使用CLI设置Agent 365代理的完整说明，请参见 Agent 365开发生命周期。
故障排除
本节提供有关如何排查Agent 365 CLI错误的信息。
小窍门
Agent 365 故障排除指南 包含高层次的故障排除建议、最佳实践以及针对 Agent 365 开发生命周期各阶段的故障排除内容链接。
本节涵盖的CLI特定问题：
Not found in NuGet feeds 安装、更新或卸载时出现错误
症状：microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 安装、更新或卸载 Agent 365 CLI 时出现错误。
解决方案： 使用参数 --prerelease 。
所有当前版本的CLI均为预发布版本。
# For installation
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease
有关最新说明和可用版本，请访问官方 NuGet 页面： Microsoft.Agents.A365.DevTools.Cli on NuGet.org
找不到 create-instance 命令
症状： 您看到Command 'create-instance' not found错误。
原因： CLI删除了该 create-instance 命令。 它绕过了必要的注册步骤，从而限制了代理的功能。 开发团队可能会在后续版本中重新引入该命令，一旦达到推荐的工作流程水平。
解决方案： 改用以下步骤：
发布你的代理人： 使用 a365发布命令。
a365 publish在开发者门户中配置代理蓝图：
Deploy Azure（可选）： 使用 a365 deploy 命令。
# Only if hosting on Azure Web App a365 deploy通过 Microsoft Teams： - 打开Microsoft Teams。
- 转到应用。
- 寻找你的代理人。
- 选择 添加 以创建代理实例。
详细说明请参见 机载代理。