重要提示
你需要是边境预览计划的一部分，才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随时间而变化。
代理 365 CLI 是一种跨平台命令行工具，用于在 Azure 上部署和管理 Agent 365 应用程序。
先决条件
在开始之前，请确保具有以下各项：
- 自定义客户端应用注册 ——CLI要求在你的Microsoft Entra ID租户中设置自定义客户端应用进行身份验证。 详见 自定义客户端应用注册 ，了解详细的设置说明。 配置时需要应用程序（客户端）ID。
- Azure 订阅 ——访问 Azure 订阅，创建资源。
- 必要权限 ——您的账户必须具备以下角色之一：
备注
在安装 a365 config init 后这一步，CLI会自动验证你的自定义客户端应用注册，检查该应用是否存在、是否拥有所需权限，并且已获得管理员同意。
小窍门
不同的CLI命令可能需要不同的角色或权限。 每个命令参考页面都指定了所需的最小角色。 例如，请参见 setup 指挥参考文献 以了解其具体要求。
安装代理 365 CLI
使用以下步骤在作系统上全局安装代理 365 CLI。
先决条件
必须已安装 。 （建议使用 .NET 8.0。
dotnet tool install
使用以下命令安装来宾代理：
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
如果收到 microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 错误，请使用该 --prerelease 参数，因为该包裹可能仍被标记为预发布。
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
有关最新说明和可用版本，请访问官方 NuGet 页面： Microsoft.Agents.A365.DevTools.Cli on NuGet.org
验证安装
安装代理 365 CLI 后，通过运行验证是否已正确安装：
a365 -h
此命令显示帮助信息，并确认 CLI 已准备就绪。
Update
使用 dotnet 工具更新 命令更新代理 365 CLI：
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
备注
所有针对 Agent 365 CLI 的更新都需要连接互联网才能访问最新的 NuGet 包： Microsoft.Agents.A365.DevTools.Cli
卸载
使用 dotnet 工具卸载 命令卸载代理 365 CLI：
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
文件位置
工具二进制文件的默认位置取决于操作系统：
| (OS) | 路径 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
首次运行 SDK 时，会将此位置添加到用户的路径中。 因此，可在无需指定工具位置的情况下从任何目录调用全局工具。
工具访问特定于用户，而不针对计算机全局。 全局工具仅适用于安装了该工具的用户。
可用命令
有关可用命令的完整列表，请使用该 --help 命令或查看 代理 365 CLI 参考
重要更新
已移除的指令：create-instance该命令已从 CLI 中移除。 它绕过了必要的注册步骤，从而限制了代理的功能。 一旦达到推荐工作流程水平，该命令可能会在后续版本中重新引入。
请改用此工作流：
-
a365 publish- 发布代理至 Microsoft 365 管理中心 -
a365 deploy- 部署到 Azure（可选，仅在使用 Azure 托管时） - 通过 Microsoft Teams 创建代理实例
请参阅机 上代理 完整说明。
故障排除
本部分包含有关如何排查代理 365 CLI 错误的信息。
安装、更新或卸载CLI都会失败 Not found in NuGet feeds
如果收到 microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 错误，请使用该 --prerelease 参数，因为该包裹可能仍被标记为预发布。
有关最新说明和可用版本，请访问官方 NuGet 页面： Microsoft.Agents.A365.DevTools.Cli on NuGet.org
找不到 create-instance 命令
症状：
Error: Command 'create-instance' not found
原因：create-instance该命令已从 CLI 中移除。 它绕过了必要的注册步骤，从而限制了代理的功能。 一旦达到推荐工作流程水平，该命令可能会在后续版本中重新引入。
Solution:
使用更新后的工作流程：
发布你的代理人：
a365 publish部署到 Azure（可选）：
# Only if hosting on Azure Web App a365 deploy通过 Microsoft Teams 创建代理实例：
- 开放 Microsoft Teams
- 导航至应用
- 搜索你的代理人
- 点击“添加”以创建代理实例
详细说明请参见 机载代理。
特工未出现在Teams中
症状： 执行命令后，代理在 Microsoft Teams 中不会出现。
原因： 你可能跳过了步骤 publish ，或者尝试使用已移除 create-instance 的命令。
Solution:
- 确认你
a365 publish运行成功 - 等待 5-10 分钟以完成传播
- 查看 Microsoft 365 管理中心： https://admin.cloud.microsoft/#/agents/all
- 通过 Teams Apps 部分创建代理实例
无法在Teams中创建代理实例
症状： 代理会出现在Teams中，但你无法创建代理实例（无法添加代理）。
原因： “Microsoft Agent 365 Frontier”许可证不会分配给你的用户账户。