Agent 365 CLI 是一款跨平台命令行工具，用于在 Azure 上部署和管理 Agent 365 应用程序。
您无需手动安装该 CLI。 AI 引导式设置 会检查 CLI 是否已安装，并自动进行安装或更新，同时代您运行所有必需的命令。 此页用于需要直接安装或使用 CLI 的开发人员的参考 - 例如，在构建 CI/CD 自动化、排查特定步骤或在不依赖 AI 编码智能体的情况下工作时。
备注
完整的开发者工作流（包括 AI 引导式设置、角色指导和部署后步骤）请参阅 Agent 365 开发入门。 本页面是 CLI 参考指南：安装、更新、卸载、可用命令以及故障排除。
必备条件
CLI 需要 .NET 8.0 或更高版本。 有关所有其他先决条件（Azure 订阅、所需的 Entra 角色以及自定义客户端应用注册），请参阅 AI 引导式设置。
安装 Agent 365 CLI
请按照以下步骤在操作系统上全局安装 Agent 365 CLI。
必备条件
您必须已安装 .NET。 （建议使用 .NET 8.0。）
使用 DotNet 工具安装
使用以下命令安装 Agent 365 CLI：
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
有关最新说明和可用版本，请访问官方 NuGet 页面：NuGet.org 上的 Microsoft.Agents.A365.DevTools.Cli
验证安装
安装 Agent 365 CLI 后，请运行 --help 命令以验证是否安装正确：
a365 -h
此命令将显示帮助信息，并确认 CLI 已准备就绪。
Update
使用 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
文件位置
工具可执行文件的默认位置取决于操作系统：
| (OS) | 路径 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
首次运行 SDK 时，它会将此位置添加到您的路径中。 因此，您可以在任何目录中调用全局工具，而无需指定工具位置。
工具访问特定于用户，而不针对计算机全局。 全局工具仅对安装该工具的用户可用。
可用命令
要查看可用命令的完整列表，请使用 --help 命令或参阅 Agent 365 CLI 参考。
提示
您无需手动运行 CLI 命令。 AI 引导式设置 会利用智能体编码智能体自动完成整个工作流——包括 CLI 安装、配置、蓝图设置、部署和发布。 如果您正在构建 CI/CD 自动化、排查特定步骤的故障，或者在不使用 AI 编码智能体的情况下进行操作，请使用此处的 CLI 参考文档。
有关如何使用 CLI 设置 Agent 365 智能体的完整说明，请参阅 Agent 365 开发入门。
故障排除
本节提供了有关如何排查 Agent 365 CLI 错误的信息。
提示
Agent 365 故障排除指南 包含高层次的故障排除建议、最佳实践，以及针对 Agent 365 开发生命周期各阶段的故障排除内容链接。
本节涵盖的 CLI 相关问题：