代理 365 CLI 是一种跨平台命令行工具，用于在 Azure 上部署和管理 Agent 365 应用程序。
无需手动安装 CLI。 AI 引导的设置会检查 CLI 是否存在，自动安装或更新，并代表你运行所有必需的命令。 本页是开发人员需要直接安装或使用 CLI 的参考——例如，在构建 CI/CD 自动化、排查特定步骤或不依赖 AI 编码代理的情况下工作时。
注释
完整的开发人员工作流（包括 AI 引导式设置、角色指南和部署后步骤）在 代理 365 开发入门中。 此页面是 CLI 参考：安装、更新、卸载、可用命令和故障排除。
先决条件
CLI 需要 .NET 8.0 或更高版本。 有关所有其他先决条件（Azure订阅、必需的 Entra 角色和自定义客户端应用注册）请参阅 AI 引导式设置。
安装代理 365 CLI
使用以下步骤在操作系统上全局安装Agent 365 CLI。
先决条件
您必须安装 .NET。 （建议.NET 8.0。
使用 dotnet 工具安装
使用以下命令安装代理 365 CLI：
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
有关最新说明和可用版本，请访问官方 NuGet 页面：Microsoft.Agents.A365.DevTools.Cli on NuGet.org
验证安装
安装 Agent 365 CLI 后，通过执行 --help 以下命令确认安装正确：
a365 -h
此命令显示帮助信息，并确认 CLI 已准备就绪。
更新
使用 dotnet tool update 命令更新 Agent 365 CLI。
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
注释
要更新 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 命令。 AI 引导式设置使用 AI 编码代理自动执行完整的工作流 -CLI 安装、配置、蓝图设置、部署和发布。 如果您正在构建 CI/CD 自动化、排查特定步骤，或是在没有 AI 编码代理的情况下工作，可参考此处的 CLI。
有关如何使用 CLI 设置代理 365 代理的完整说明，请参阅 代理 365 开发入门。
故障排除
本节提供有关如何排查Agent 365 CLI错误的信息。
小窍门
Agent 365 故障排除指南 包含高层次的故障排除建议、最佳实践以及针对 Agent 365 开发生命周期各阶段的故障排除内容链接。
本节涵盖的CLI特定问题：