通过

代理 365 CLI deploy 命令参考

重要

需要成为 Frontier 预览计划的一部分，才能获得 抢先体验Microsoft Agent 365。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier预览受现有客户协议的预览条款约束。 由于这些功能仍在开发中，其可用性和功能可能会随着时间发生变化。

将代理 365 应用程序二进制文件部署到配置的Azure App Service和更新代理 365 工具权限。deploy 命令提供了创建代理 365 部署的选项。 使用此命令将应用程序二进制文件部署到Azure基础结构，并授予代理 365 工具权限。

需要 Minimum 角色：Azure参与者 + Global Administrator

有关使用此命令的信息，请参阅 Deploy 代理到 Azure。

Syntax

a365 deploy [command] [options]

选项

选项 Description
-c、--config <config> 配置文件的路径（默认值：a365.config.json）
-v、--verbose 启用详细日志记录
--dry-run 显示在不执行的情况下将执行的作
--inspect 在部署之前暂停以检查发布文件夹和 ZIP 内容
--restart 跳过生成并开始压缩现有发布文件夹（用于手动更改后快速迭代）
-?、-h、--help 显示帮助和使用情况信息

注解

在没有子命令的情况下运行 a365 deploy ，则运行 两个阶段部署：

  • Phase 1 — 应用程序二进制文件：生成应用程序并将其部署到Azure App Service。
  • 阶段 2 — MCP 权限：读取 toolingManifest.json 所需的范围，并使用必要的权限更新代理蓝图。

这两个阶段都运行，即使运行 --dry-run。 干运行输出分为两个标记部分，以便可以查看每个阶段将执行的作。

预检检查

在部署之前，CLI 将验证：

  • Azure身份验证和订阅：Azure CLI会话和订阅必须有效。 否则，部署将停止并出现错误。 使用 az login --tenant <TENANT_ID> 和 az account set --subscription <SUBSCRIPTION_ID>. 进行修复。
  • Azure App Service存在：在部署继续之前，目标 Web 应用必须存在。 如果未找到应用，请运行a365 setup或更正webAppName。resourceGroupa365.config.json

配置

CLI 从两个配置文件中读取：

  • a365.config.json — 项目配置（用户维护）。
  • a365.generated.config.json — 由安装程序命令生成的动态状态。

MCP 工具范围从部署项目目录中读取 toolingManifest.json 。

CLI 还会在以下位置存储配置和状态的全局副本：

  • Windows：%LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
  • Linux/macOS： ~/.config/a365

标志行为

--restart：跳过生成步骤，直接从压缩现有 publish/ 文件夹开始。 如果 publish/ 不存在，部署将失败。 首先运行完整部署（不含 --restart）以生成 publish/ 文件夹。

--inspect：在上传步骤之前暂停，以便可以检查 publish/ 文件夹和生成的 ZIP 文件。 仅适用于应用阶段。

--dry-run：打印一切不会进行任何更改。 运行 a365 deploy （两阶段）时，输出分为：

  • 第 1 部分 - 部署应用程序二进制文件
  • 第 2 部分 - 部署/更新代理 365 工具权限

deploy app

将代理代码部署到安装过程中创建的 Azure Web 应用。

a365 deploy app [options]

将Microsoft代理 365 应用程序二进制文件部署到配置的Azure App Service。 此命令将应用程序二进制文件部署到Azure中配置的Azure应用服务。

app 选项

选项 Description
-c、--config <config> 配置文件的路径（默认值：a365.config.json）
-v、--verbose 启用详细日志记录
--dry-run 显示在不执行的情况下将执行的作
--inspect 在部署之前暂停以检查发布文件夹和 ZIP 内容
--restart 跳过生成并开始压缩现有发布文件夹（用于手动更改后快速迭代）
-?、-h、--help 显示帮助和使用情况信息

deploy mcp

更新代理蓝图上的 MCP 服务器权限。

a365 deploy mcp [options]

mcp 选项

选项 Description
-c、--config <config> 配置文件路径（默认值：a365.config.json）
-v、--verbose 启用详细日志记录
--dry-run 显示在不执行的情况下将执行的作
-?、-h、--help 显示帮助和使用情况信息

使用注意事项

更新 MCP 服务器对现有代理蓝图的范围和权限。 此命令将代理 365 工具的权限添加到代理蓝图。

如果在代理代码中添加或修改 MCP 服务器，请使用此命令更新代理蓝图上的权限。

此命令：

  • 从代码中读取 MCP 服务器配置。
  • 使用所需的权限更新代理蓝图。
  • 授予 MCP 服务器所需的 API 权限。

权限更新按以下顺序应用：

  1. OAuth2 权限授予（蓝图服务主体→ MCP 平台）
  2. 可继承的权限（代理蓝图→ MCP 资源）
  3. 管理员同意（代理标识→ MCP 平台）

何时使用 deploy mcp：

  • 将新的 MCP 服务器添加到代理后。
  • 更改 MCP 服务器配置后。
  • 当代理无法访问 MCP 工具时。

无需运行 deploy mcp：

  • 初始部署时。 此设置在安装过程中会自动处理。
  • 仅更改代理逻辑而不更改 MCP 时。
  • 在常规代码更新不会影响工具之后。

注释

a365 deploy mcp 仅更新权限 - 它不会部署代码。 如果代码发生更改，请先运行 a365 deploy app 。

故障排除

使用以下部分解决命令的潜在问题 deploy 。

未登录到Azure或错误的订阅

运行 az login --tenant <TENANT_ID> 和 az account set --subscription <SUBSCRIPTION_ID>。

找不到 Web 应用

确保a365 setup已运行，或验证webAppName是否正确resourceGroup。a365.config.json

权限更新失败

  • 确认 AgentBlueprintId和 AgenticAppId设置环境 a365.config.json。
  • 确保帐户有权管理服务主体和授予。
  • 验证部署 toolingManifest.json 项目目录中是否存在并包含有效作用域。

--restart 失败

运行完整部署而不 --restart 生成 publish/ 文件夹，然后用于 --restart 后续迭代。

日志

CLI 日志文件存储在以下位置：

  • Windows：%LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
  • Linux/macOS： ~/.config/a365/logs/

若要查看最新部署日志文件的最后 80 行，请在 Linux/macOS 上的 Windows 或 tail 上使用 Get-Content：

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

对于运行时应用程序日志，请在Azure门户中使用 Log Stream从应用服务获取 stdout/stderr。

  • Last updated on